GhastQoL

The quintessential happy ghast plugin.

Happy Ghasts have the potential to be the best form of transportation ever introduced, unfortunately they're slow and difficult to catch up with when they fly away, and when you're standing on top of them you get kicked for 'flying', this plugin fixes all of those issues and more.

A Paper plugin for Minecraft 21.X & 26.X with quality-of-life tweaks for happy ghasts:
they fly faster (a boost to their flying_speed attribute) and, fly to a player when
looking at them. Also adds a rotate lock to make building around Ghasts easier. This plugin also removes the 'flying is not enabled on this server' bug when standing on a happy ghast.

Not supported: Spigot/Bukkit (uses Paper-only APIs) or Folia.
The plugin runs a startup self-check and disables itself with
a clear log message on Folia or on Minecraft older than 26.

Config (plugins/GhastQoL/config.yml)

speed-multiplier: 3.0     # 3x vanilla flight speed
only-when-ridden: true   # true = only boost while a player is riding

follow:                   # make unridden ghasts follow the nearest player
  enabled: true
  range: 32.0             # only follow players within this many blocks
  stop-distance: 4.0      # stop approaching once this close
  speed: 1.0              # navigation speed multiplier

Following

Each ghast has a home (where it's resting — set when it loads, and re-set to wherever
a rider leaves it, mirroring vanilla). It only follows players inside range of that home
and won't chase them beyond it; if it drifts out, it steers back home.

What triggers a follow depends on follow.trigger:

• look (default) — the ghast follows whoever is looking at it (within look-angle
  degrees, and with clear line of sight if require-line-of-sight is on). It keeps
  following for look-linger-seconds after they look away, so a quick glance elsewhere
  doesn't stop it dead.
• timer — the ghast follows on a cycle: follow-seconds chasing, then rest-seconds
  of normal vanilla flight, repeating.

Tuning tips: range is the home leash radius; look-angle widens/tightens the "looking at
it" cone; speed scales glide speed; stop-distance is how close it gets.

Reload after editing with /ghastqol reload (permission ghastqol.reload, default OP).

Commands- /ghastqol reload — reload the config (permission ghastqol.reload, default OP).

• /ghastqol rotate — snap the happy ghast you're riding (or the nearest one within
  rotate.range) to yaw 0° so it lines up with the block grid. Handy when using a ghast
  as a build platform. Permission ghastqol.rotate (default: everyone).
• /ghastqol check — look at (or stand near) a ghast and run this to see whether it has
  the follow goal and speed boost attached, and its home/range. It re-attaches anything
  missing on the spot — handy for a ghast that grew up or reloaded without our logic.
• /ghastqol settings — list all editable settings and their current values.
• /ghastqol settings <path...> <value> — change a setting live (no restart/reload needed).
  The space-separated path maps to the config key, so follow enabled means follow.enabled.
  Examples: /ghastqol settings speed-multiplier 5, /ghastqol settings follow trigger timer,
  /ghastqol settings follow enabled false. Values are type-checked and range-checked, tab
  completion walks the path and suggests values, and changes are saved to config.yml and
  applied to all loaded ghasts immediately. Permission ghastqol.settings (default OP).
  Note: Minecraft AI can re-rotate a mob, so after aligning, the plugin briefly pauses
  follow for that ghast (rotate.hold-seconds) so it stays put. While a player is
  actively riding and steering, the rider's input still controls facing — align while
  sitting still, or hop off first.

How it works

Vanilla happy ghasts have a flying_speed base of ~0.05, which feels sluggish.
The plugin adds a scalar attribute modifier so the effective speed becomes
base × speed-multiplier. The modifier is applied when a ghast enters the world
(spawn or chunk load) and is cleanly removed if you disable/remove the plugin.

Notes

• only-when-ridden uses mount/dismount events so the ghast is only fast with a
  rider aboard, then returns to normal.
• Very high multipliers can make the ghast hard to steer — 2–4 is a comfortable range.
• This is standard Paper API; for Folia you'd need to swap the scheduler calls
  for the region/entity scheduler.

The "Flying is not enabled on this server" kick

Minecraft has a built-in check that kicks players who appear airborne too long
(Player was kicked for floating too long!). It doesn't count an entity's hitbox as
ground, so standing on a happy ghast — using it as a build platform — can get you kicked
even though you're doing nothing wrong.

GhastQoL cancels that kick, but only when the player is genuinely standing on a happy
ghast. It checks the kick's cause is the flight check, then confirms the player is on top
of (or at the rim of) a ghast's hitbox. Every other kick — bans, /kick, timeouts, real
anti-cheat — is untouched, and genuine floating with no ghast underneath is still kicked.

flight-kick-fix:
  enabled: true
  vertical-tolerance: 3.0   # how far above the hitbox still counts as standing on it
  horizontal-padding: 1.5   # margin around the edges, for standing near the rim
  log-saves: false          # log each cancelled kick (handy while testing)

Usage

MIT License, if you redistribute please link back to the original repo for bug reports and maintenance, etc.