HappyGhastBoost – Usage & Configuration

---
Setup: config.yml
Control core plugin behavior:

boost-speed: 1.2 # Default boost velocity multiplier
boost-rampup-speed-ms: 1500 # Time (ms) to reach full boost
update-interval: 2 # Boost update tick rate
require-permission: false # If true, players need permission to use
trail-enabled: true # Enables trail particles
actionbar-format: "<label> <bar> <percent>%"

---

️ Boost Presets
Presets allow different boost behavior based on permissions.
Example:

presets:
ultra:
boost-speed: 1.5
refill-rate: 0.03
drain-rate: 0.02
particle: "FIREWORK"

To assign:
happyghastboost.preset.ultra

✅ If no matching preset is found, global defaults are used.
⚠️ Only assign one happyghastboost.preset.* permission per player to avoid conflicts.
High values may cause rubberbanding.

---

Action Bar Messaging
messages.yml uses MiniMessage syntax for color and formatting:

boost-ready: "<green><bold> Boost Ready!"
charging: "<yellow>⚡ Charging Boost"
boosting: "<red><bold> Boosting"

Customize all labels, colors, and bar styles freely.

---

Debugging & Logs
Use /happyghastboost to toggle log levels:


/happyghastboost logdisable
/happyghastboost logbasic
/happyghastboost logdebug
/happyghastboost logverbose

Useful for:

• Input detection
• Boost activity
• Velocity details
• Pilot switching

---

Controls

• Mount a Happy Ghast to start flying.
• Hold forward to trigger boost (based on direction and timing).
• Boost charge depletes during use and recharges when idle.
• Visual feedback shown via the action bar.
• Charge persists between sessions using PDC.

---

Tips

• Avoid setting boost-speed too high or players may rubberband.
• particle values must be valid Spigot particle names.
• Compatible with both Java and Bedrock (via Geyser/Floodgate).