🎈 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:

Bomb	Item	What It Does
🔴 Circle Bomb	Fishing Rod	Drops TNT in a perfect orbital ring below the ghast
🟣 Cluster Bomb	Sweet Berries	Scatters ~10 TNT in a wide spread for area denial
🟠 Fireball	Fire Charge	Shoots a classic Ghast fireball, yield & fire configurable
🧨 Single TNT	TNT	Just one block. Simple. Effective.

📦 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:

Spoiler

# ==================== 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."

📥 Requirements

• Paper 1.21.6+ or Folia 1.21.6+
• Java 21+

No dependencies!