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