HappyGhastBoost

HappyGhastBoost – Smooth, Customizable Ghast Flight Boosting
Give your Happy Ghasts a satisfying and responsive boost mechanic that feels intuitive, polished, and powerful — fully customizable for your server's needs.

✨ Features

• ️ ️ Smooth Forward Boosting — Feels natural and fluid for pilots
  
  
• ️ ️ Boost Presets — Configure per-player behavior via permission nodes (great for VIPs)
  
  
• Fully Configurable — Tune ramp-up speed, drain/refill rates, particles, etc.
  
  
• Live Action Bar HUD — Real-time feedback using MiniMessage formatting
  
  
• Optional Particle Trails — Customizable per preset
  
  
• Smart Input Detection — Based on actual forward motion (no weird keybinds!)
  
  
• Clean Logging System — Adjustable verbosity: basic, debug, or verbose

⚙️ Configuration Overview

config.yml — Core 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 a permission to boost
trail-enabled: true               # Enables trail particles
actionbar-format: "<label> <bar> <percent>%"

If require-permission: true, players must have:

happyghastboost.use

to be able to boost at all.

️ Boost Presets (Optional)
Presets allow different boost behavior for players based on permissions.

Example from config.yml:

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

Assign with:

happyghastboost.preset.ultra

If no matching preset is found, global defaults are used.
Only give one happyghastboost.preset.* permission per player to avoid conflicts.
Higher boost-speed values (>1.5) may cause rubberbanding.

️ Action Bar Display
messages.yml supports full MiniMessage formatting:

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

Customize all labels, colors, and layouts freely.

Debugging & Logs
Use /happyghastboost to set logging levels:

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

Helpful for:

• Input detection
• Boost activity
• Velocity tracking
• Pilot changes

Controls

1. Mount a Happy Ghast
   
   
2. Hold forward to trigger boost (uses directional input detection)
   
   
3. Watch boost charge deplete during flight and recharge when idle
   
   
4. Action bar provides live visual feedback
   
   
5. Boost charge persists between sessions

Tips

• Don’t set boost-speed too high or players may rubberband
  
  
• Particle must match valid Spigot particle names
  
  
• Fully compatible with Java + Bedrock (via Geyser/Floodgate)

Installation

1. Drop the .jar file into /plugins
   
   
2. Start or reload the server
   
   
3. Edit config.yml and messages.yml to your liking
   
   
4. Assign permissions as needed

✅ Compatibility

• Paper 1.21.7 & 1.21.8
  
  
• Geyser/Floodgate Bedrock player support