ExplosionOptimizer Module

The ExplosionOptimizer module allows you to control and optimize explosions on your server. It helps reduce excessive destruction, prevent chain reactions, and optionally disable explosions entirely f

ExplosionOptimizer:
  enabled: true
  worlds:
    - '*'
  values:
    yield_limit:
      enabled: false
      default: 4.0
      per_entity:
        - "TNT:4.0"
        - "TNT_MINECART:4.0"
        - "CREEPER:3.0"
        - "FIREBALL:1.0"
        - "WITHER_SKULL:1.0"
        - "END_CRYSTAL:6.0"
    anti_chain:
      enabled: true
      prevent_tnt_chains: true
      prevent_creeper_chains: false
      prevent_crystal_chains: true
      prevent_block_ignition: true
      chain_radius: 8.0
      max_chain_size: 3
      chain_cooldown: 1000
    management:
      enabled: false
      cancel_block_explosions: true
      cancel_creepers: false
      cancel_crystals: true
      cancel_fireballs: true
      cancel_tnt: true
      cancel_wither_skulls: true
      explosion_damage: false
      explosion_sound: true

---

🧩 Option Explanations

🔹 Yield Limit (yield_limit)

Controls the maximum power or radius of explosions. Useful for reducing destruction from TNT, creepers, fireballs, etc.

• enabled — Enable or disable the yield limit.

• default — Maximum explosion power for all sources (Minecraft TNT default is 4.0).

• per_entity — Customize explosion power per entity type. Overrides the default for specific entities. Supported entity types: see EntityType API.

Default example:

per_entity:
  - "TNT:4.0"
  - "CREEPER:3.0"
  - "FIREBALL:1.0"

---

🔹 Anti-Chain (anti_chain)

Prevents chain reactions where one explosion triggers others nearby.

• enabled — Enable or disable anti-chain protection.

• prevent_tnt_chains — TNT explosions won't trigger nearby TNT.

• prevent_creeper_chains — Creepers can still trigger other creepers if false.

• prevent_crystal_chains — Prevent End crystal chain explosions.

• prevent_block_ignition — Explosions won't ignite TNT blocks if true.

• chain_radius — Radius (in blocks) to check for potential chain reactions.

• max_chain_size — Maximum number of explosions allowed in one chain.

• chain_cooldown — Delay (in milliseconds) before allowing new chains after an explosion.

---

🔹 Explosion Management (management)

Allows full control or cancellation of explosions for lag prevention. ⚠️ Warning: Enabling this can completely disable explosions on your server.

• enabled — Enable or disable full explosion management.

• cancel_block_explosions — Disable explosions that break blocks (e.g., beds in the Nether).

• cancel_creepers — Disable creeper explosions.

• cancel_crystals — Disable End crystal explosions.

• cancel_fireballs — Disable Ghast fireball explosions.

• cancel_tnt — Disable TNT explosions.

• cancel_wither_skulls — Disable Wither skull explosions.

• explosion_damage — If true, entities still take damage, but blocks are not destroyed.

• explosion_sound — If true, explosion sounds are still played for immersion.