!LiveGhast

🎈 LiveGhast — Turn Your Happy Ghast Into a Flying War Machine

Because riding a cute balloon blob is fun, but riding a cute balloon blob that drops TNT is better.

LiveGhast is a lightweight, highly customizable plugin that transforms the vanilla Happy Ghast into a fully controllable aerial bomber. Whether you want tactical circle strikes, chaotic cluster bombs, or your own completely custom abilities, this plugin gives server owners full control over how ghasts behave in combat — without breaking the vanilla feel.

Built for Paper 1.21.6+ and Folia 1.21.6+.

🚀 Features

🧪 Fully Customizable Ghast Stats

Tweak both Happy Ghasts and Regular Ghasts to fit your server’s vibe:

• Size
• Speed
• Health & Armor
• Follow Range
• No-Despawn, Invulnerable, Silent, Glowing
• Breeding toggle

💣 4 Built-In Bomb Types

Each bomb has its own war item, cost, cooldown, and fuse settings:

📦 Ammo GUI System

• Load your ghast with TNT and Fire Charges via a custom GUI
• Configurable allowed items (whitelist-only or open floodgates)
• Pilot-only access option — no random passengers stealing your stash
• Live title support with MiniMessage-style colors

🔧 Vanilla Bombing Mode

Want a more survival-friendly feel? Enable Vanilla Bombing:

• Ghast has no ammo inventory
• Right-click with TNT → drops primed TNT
• Right-click with Fire Charge → shoots a fireball
• Both use the player’s own inventory with configurable cooldowns

⚡ Custom Bombs (Console Commands)

create unlimited custom bomb types that execute console commands using placeholders like {player}, {uuid}, {world}, {x}, {y}, {z}.

Commands:

Just /liveghast reload

Config.yml:

# ==================== LiveGhast Config ====================

# IMPORTANT: This plugin requires Folia 1.21.6+ or Paper 1.21.6+.

happy-ghast:
  size: 1.0                       # Only values <= 1.0. Range: 0.1 - 1.0
  speed: 1.0                      # 1.0 = Default speed
  ammo-slots: 9                   # Must be a multiple of 9: 9, 18, 27, 36, 45, 54
  max-health: 10.0                # 10.0 = Default. 2.0 = 1 heart
  armor: 0.0                      # 0.0 = Default
  follow-range: 32.0              # 32.0 = Default
  no-despawn: true                # true = Default. Prevents ghasts from despawning
  invulnerable: false             # false = Default
  silent: false                   # false = Default
  glowing: false                  # false = Default
  can-breed: true                 # true = Default. Set to false to disable breeding

regular-ghast:
  enabled: true                   # true = Default. Apply settings to regular ghasts too
  size: 1.0                       # Only values <= 1.0. Range: 0.1 - 1.0
  speed: 1.0                      # 1.0 = Default
  max-health: 10.0                # 10.0 = Default. 2.0 = 1 heart
  armor: 0.0                      # 0.0 = Default
  follow-range: 64.0              # 64.0 = Default
  no-despawn: false               # false = Default
  invulnerable: false             # false = Default
  silent: false                   # false = Default
  glowing: false                  # false = Default

# Vanilla Bombing Mode: When enabled, the ghast has no ammo inventory.
# Players must use TNT or Fire Charges from their own inventory.
# Right-click with TNT → drops primed TNT
# Right-click with Fire Charge → shoots a fireball
# Both have configurable cooldowns.
vanilla-bombing:
  enabled: false
  cooldown-ticks: 20
  allow-tnt: true
  allow-fire-charge: true
  tnt-fuse-ticks: 40

bombs:
  circle:
    enabled: true
    tnt-cost: 8
    radius: 6.0
    count: 8
    fuse-ticks: 40
    cooldown-ticks: 100
  cluster:
    enabled: true
    tnt-cost: 10
    count: 10
    spread: 8.0
    fuse-ticks-min: 30
    fuse-ticks-max: 60
    cooldown-ticks: 200
  fireball:
    enabled: true
    charge-cost: 1
    yield: 1.0
    incendiary: true
    cooldown-ticks: 20
  single-tnt:
    enabled: true
    tnt-cost: 1
    fuse-ticks: 40
    cooldown-ticks: 20

War-item slots: Only 0-8 (hotbar slots)

War-items are disabled when vanilla-bombing is enabled

war-items: circle: slot: 0 material: FISHING_ROD name: "&cCircle Bombing" lore: - "&7Right-click: Orbital bombing" cluster: slot: 1 material: SWEET_BERRIES name: "&4Cluster Bombing" lore: - "&7Right-click: Disperses ~10 TNT" fireball: slot: 2 material: FIRE_CHARGE name: "&6Fireball" lore: - "&7Right-click: Shoots a fire charge" single-tnt: slot: 3 material: TNT name: "&c1 TNT" lore: - "&7Right-click: Drops just 1 TNT"

Custom Bombs: Server owners can create custom bomb types beyond

the 4 built-in ones (Circle, Cluster, Fireball, Single TNT).

Each custom bomb executes console commands with placeholders.

Placeholders: {player} {uuid} {world} {x} {y} {z}

custom-bombs:

############ EXAMPLES ############

To enable, set 'enabled: true' and ensure the slot doesn't conflict

creeper-swarm: enabled: false war-item: slot: 4 material: CREEPER_SPAWN_EGG name: "&2Creeper Swarm" lore: - "&7Right-click: Spawns 5 creepers" # vanilla-trigger only works when vanilla-bombing is enabled vanilla-trigger: CREEPER_SPAWN_EGG commands: - "execute at {player} run summon minecraft:creeper ~ ~-2 ~ {Fuse:30,ExplosionRadius:3}" - "execute at {player} run summon minecraft:creeper ~1 ~-2 ~ {Fuse:30,ExplosionRadius:3}" - "execute at {player} run summon minecraft:creeper ~-1 ~-2 ~ {Fuse:30,ExplosionRadius:3}" - "execute at {player} run summon minecraft:creeper ~ ~-2 ~1 {Fuse:30,ExplosionRadius:3}" - "execute at {player} run summon minecraft:creeper ~ ~-2 ~-1 {Fuse:30,ExplosionRadius:3}" cooldown-ticks: 150 consume: from: player # Options: player | ghast-ammo | none material: CREEPER_SPAWN_EGG amount: 1

zombie-horde: enabled: false war-item: slot: 6 material: ZOMBIE_HEAD name: "&2&lZombie Horde" lore: - "&7Right-click: Summons an undead army" - "&8Spawns 12 zombies around the ghast" vanilla-trigger: ZOMBIE_HEAD commands: - "execute at {player} run summon minecraft:zombie ~3 ~-2 ~" - "execute at {player} run summon minecraft:zombie ~-3 ~-2 ~" - "execute at {player} run summon minecraft:zombie ~ ~-2 ~3" - "execute at {player} run summon minecraft:zombie ~ ~-2 ~-3" - "execute at {player} run summon minecraft:zombie ~2 ~-2 ~2" - "execute at {player} run summon minecraft:zombie ~-2 ~-2 ~-2" - "execute at {player} run summon minecraft:zombie ~2 ~-2 ~-2" - "execute at {player} run summon minecraft:zombie ~-2 ~-2 ~2" - "execute at {player} run summon minecraft:zombie ~ ~-2 ~" - "execute at {player} run summon minecraft:zombie ~1 ~-2 ~1" - "execute at {player} run summon minecraft:zombie ~-1 ~-2 ~-1" - "execute at {player} run summon minecraft:zombie ~1 ~-2 ~-1" - "execute at {player} run particle minecraft:large_smoke ~ ~-1 ~ 3 1 3 0.1 100 force" - "execute at {player} run playsound minecraft:entity.zombie.ambient master @a ~ ~ ~ 3 0.5" cooldown-ticks: 400 consume: from: player material: ROTTEN_FLESH amount: 3

terrain-destroyer: enabled: false war-item: slot: 5 material: BEDROCK name: "&4&lTerrain Destroyer" lore: - "&7Right-click: Erases terrain below" - "&c&lWARNING: &7Destructive!" vanilla-trigger: BEDROCK commands: - "execute at {player} run fill ~-3 ~-2 ~-3 ~3 ~2 ~3 air replace #minecraft:mineable/pickaxe" - "execute at {player} run particle minecraft:explosion ~ ~ ~ 2 2 2 1 50 force" - "execute at {player} run playsound minecraft:entity.generic.explode master @a ~ ~ ~ 2 1" cooldown-ticks: 300 consume: from: player material: TNT amount: 5

gui-titles: ammo: "#555555Ghast Ammo"

ammo-gui: allowed-items: - "TNT" - "FIRE_CHARGE"

- "ROTTEN_FLESH"

allow-all-items: false

bomber-restrictions: pilot-only: false message: enabled: true text: "&cOnly the pilot can drop bombs."

==================== LiveGhast Messages ====================

messages: prefix: enabled: true text: "&f[LiveGhast] &r" no-permission: enabled: true text: "&cYou don't have permission." not-riding: enabled: true text: "&cYou're not riding a Happy Ghast." bomb-cooldown: enabled: true text: "&cYou must wait before dropping another bomb." insufficient-ammo: enabled: true text: "&cInsufficient ammo." reload-success: enabled: true text: "&aConfiguration reloaded successfully. &7(%count% ghasts synced)" reload-error: enabled: true text: "&cError: &e%error%" command-usage: enabled: true text: "&7Usage: /liveghast <reload|help>" slot-locked: enabled: true text: "&cYou can't modify this slot." no-permission-ammo: enabled: true text: "&cYou don't have permission to open the ammo inventory." ghast-occupied: enabled: true text: "&cOnly the pilot can access the ammo inventory." invalid-ammo-item: enabled: true text: "&cYou can only store TNT and Fire Charges." ammo-gui-in-use: enabled: true text: "&cSomeone is already accessing this ghast's ammo inventory."

</details>



📥 Requirements
- Paper 1.21.6+ or Folia 1.21.6+
- Java 21+

No dependencies!