HappyGhast - Ride & Upgrade

HappyGhast — Ride & Upgrade the Happy Ghast

HappyGhast turns the new `minecraft:happy_ghast` into a real vehicle with progression and utility. Players can boost riding speed, install cargo, fire fireballs, freeze/unfreeze, heal their mount, and gain buffs when a harness is equipped. All data (cargo, upgrades, boosts) is persisted safely across restarts.

---

Features

- re-applied automatically - Right-click with an re-applied automatically to multiply base riding speeds (configurable). - Remove the boost with re-applied automatically; the plugin restores re-applied automatically. - re-applied automatically - *Sneak + Chest* to install cargo, *Sneak + Diamond* to upgrade to re-applied automatically. - Inventory is re-applied automatically to disk and restored on startup. - re-applied automatically - *Sneak + Amethyst Shard* toggles AI pause/resume (useful for staging or parking). - re-applied automatically - Use re-applied automatically to shoot; includes cooldown, projectile speed, and anti-grief options (destructive by default). - re-applied automatically - *Sneak + Phantom Membrane* to heal to full or by a fixed amount (configurable, optional item consumption). - re-applied automatically - Equipping any vanilla harness grants re-applied automatically (configurable) and re-applied automatically (optional particles/ambient). - Buffs are re-applied automatically on server start or reload.

---

Crafting

Enchanted Snowball

Recipe ID: Shapeless recipe Recipe ID: `1x Snowball` + `1x Gunpowder` + `1x Glowstone Dusk` Recipe ID: `1x Enchanted Snowball` Recipe ID: `happyghast:enchanted_snowball`

permanent riding-speed boost Sneak + Right-click a permanent riding-speed boost with the Enchanted Snowball to apply a permanent riding-speed boost (multiplier is configurable). The item has the vanilla enchantment glint—no resource pack required.

---

Enchanted Gunpowder

Recipe ID: Shapeless recipe Recipe ID: `1x Enchanted Snowball` + `1x Gunpowder` Recipe ID: `1x Enchanted Gunpowder` Recipe ID: `happyghast:enchanted_gunpowder`

restore vanilla base speeds Sneak + Right-click a restore vanilla base speeds to restore vanilla base speeds the boost and restore vanilla base speeds immediately.

> Both recipes are survival-friendly and show up like normal crafting recipes. > Admins can still use `/hg give snowball <player> <amount>` for testing or servers with restricted crafting.

---

Default Controls

- Install cargo: Right-click with a Fire Charge - Open cargo: Right-click with a Fire Charge - Upgrade cargo: Right-click with a Fire Charge - Freeze / Unfreeze: Right-click with a Fire Charge - Apply boost (permanent): Right-click with a Fire Charge - Remove boost: Right-click with a Fire Charge - Heal: Right-click with a Fire Charge - Fireball (while riding): Right-click with a Fire Charge

---

Commands & Permissions

| Command | What it does | Permission | |---|---|---| | `/hg` | Help | `happyghast.admin` (OP by default) | | `/hg reload` | Reload config (recipes re-registered safely) | `happyghast.admin` | | `/hg give snowball <player> <amount>` | Give Enchanted Snowballs | `happyghast.admin` | | `/hg info` | Show tick interval | `happyghast.admin` | | `/hg audit` | Print Happy Ghast stats | `happyghast.admin` | | `/hg bases` | Read base movement/flying from nearest ghast | `happyghast.admin` | | `/hg migrate` | Force config migration/refresh with comments | `happyghast.admin` | | `/hg version` | Show plugin + config version | `happyghast.admin` |

---

To install on server

1. Set up a Bukkit server such as Spigot or Paper (Paper is recommended over Spigot). 2. Download Happy ghast - Ride & Upgrade from this page. 3. Put the Happy ghast - Ride & Upgrade plugin file into your plugins folder.

---

Config (excerpt)

```yml controls: install_with: CHEST # SNEAK + right-click the Happy Ghast to install cargo open_with: LIGHTNING_ROD # SNEAK + right-click to open the cargo inventory upgrade_item: DIAMOND # SNEAK + right-click to upgrade (single -> double) freeze_item: AMETHYST_SHARD # SNEAK + right-click to toggle freeze / resume AI heal_with: PHANTOM_MEMBRANE # Item used to heal (SNEAK + right-click)

cargo: base_slots: 27 # Slots with cargo installed (must be multiple of 9) upgraded_slots: 54 # Slots after upgrade (max 54)

ride_boost: multiplier: 0.9 # Factor applied to riding speed base

< 1.0 = slower (e.g. 0.7), > 1.0 = faster (e.g. 1.6)

vanilla_base: flying_speed: 0.05 # Vanilla flying speed (used on reset via enchanted gunpowder) movement_speed: 0.10 # Vanilla ground speed (used on reset via enchanted gunpowder)

fx: sounds: true # Enable interaction sounds particles: true # Enable visual particles (feedback bursts)

heal: consume_item: true # Consume the item outside Creative full: true # true = heal to max HP; false = add only 'amount' amount: 10.0 # Used when full=false (HP; 2.0 = 1 heart)

fireball: enabled: true only_when_riding: true # Only fire when the player is mounted on a Happy Ghast ammo_item: FIRE_CHARGE # Ammo required in hand consume_ammo: true # Consume one ammo in Survival cooldown_ticks: 20 # 20 ticks = 1s (per ghast) speed: 2.8 # Initial projectile speed explosion_yield: 1.5 # Explosion "power" of the LargeFireball (vanilla ~1–3) incendiary: true # Set blocks on fire (yes/no) block_damage: true # false = no block damage (anti-grief) shooter_is_ghast: true # true = ghast is the shooter (else the player)

harness: bonus_health: 20 # Extra HP while harness is equipped (+10 hearts) resistance_level: 2 # Resistance level (1–4) resistance_duration: 72000 # Duration in ticks (72000 = 1 hour); auto-refreshed reapply_on_enable: true # Re-apply buffs on server start/reload resistance_particles: true # Show potion swirl on the ghast resistance_ambient: false # Ambient (subtle) particles when true

config-version: 1 # Managed by the plugin; will be migrated as needed