Explosion Control

💥 ExplosionControl

Fine-grained control over explosions on your server.
Tune block damage, drop rates, player damage, and blast radius — per source, per world — all without restarting.

✨ What It Does

ExplosionControl lets you configure Creeper, TNT, and End Crystal explosions independently.
Each source has its own set of rules you can adjust live from in-game commands or the config file.

• Toggle block destruction on or off per explosion type
• Scale blast radius (shrink craters or make them massive)
• Control block drop chance (no drops, vanilla drops, or everything drops)
• Toggle player damage per type
• Multiply damage dealt to players
• Adjust how far the damage reaches
• Restrict the plugin to specific worlds (whitelist or blacklist)
• Enable pet protection to keep tamed animals safe from all explosions

⚙️ Configuration

Every setting lives in config.yml and can also be changed live using /ec commands.

worlds:
  mode: whitelist       # whitelist or blacklist
  list:
    - world

pet-protection: false   # true = tamed animals immune to all explosions

explosions:

  creeper:
    block-damage:
      enabled: true
      radius-multiplier: 1.0   # 0=off  0.5=half  2.0=double
      drop-chance: 0.3         # 0.0=none  0.3=vanilla  1.0=all drop
    player-damage:
      enabled: true
      damage-multiplier: 1.0   # 0=no dmg  2.0=double
      radius-multiplier: 1.0   # 0.5=shorter reach  2.0=longer

  tnt:        # same structure as creeper
  end_crystal: # same structure as creeper

🔧 Commands

All commands require the explosioncontrol.use permission (default: OP).

| Command | Description |
|---|---|
| /ec status [type] | Show current settings |
| /ec reload | Reload config.yml without restarting |
| /ec <type\|all> block radius <x> | Set crater size multiplier |
| /ec <type\|all> block drop <0–1> | Set block drop chance |
| /ec <type\|all> player damage <x> | Set player damage multiplier |
| /ec <type\|all> player radius <x> | Set player damage reach |
| /ec worlds mode <whitelist\|blacklist> | Change world mode |
| /ec worlds add/remove/list <world> | Manage world list |
| /ec pets <on\|off> | Toggle pet protection |

Aliases: /ec · /cc · /explosioncontrol

Types: creeper · tnt · crystal · all

📋 Permissions

| Permission | Default | Description |
|---|---|---|
| explosioncontrol.use | OP | Access to all ExplosionControl commands |

📦 Installation

1. Download ExplosionControl-x.x.x.jar
2. Drop it into your server's /plugins/ folder
3. Restart the server
4. Edit plugins/ExplosionControl/config.yml as needed, or use /ec commands in-game

🖥️ Requirements

| | |
|---|---|
| Platform | Paper 1.21.4+ |
| Java | 21+ |

📝 Changelog

v0.1.2

• Updated Paper API target to 1.21.4-R0.1-SNAPSHOT
• Fixed TNT and End Crystal player damage not applying on Paper 1.21.4+ (now correctly handled via EntityDamageEvent)
• Fixed a memory leak where explosion data could accumulate when no players were nearby
• Replaced deprecated ChatColor API with Adventure LegacyComponentSerializer to silence Paper warnings

Made by reval_911 · Discord: reval_911