ExplosionProtector

# 💣 ExplosionProtector addon for CoreProtect **Protect your players’ builds from unwanted explosions** A lightweight Spigot/Paper plugin that uses CoreProtect to prevent explosions from destroying blocks placed by players. --- ## 🧠 Description `ExplosionProtector` hooks into all types of explosions (TNT, creeper, ender crystal, bed/respawn-anchor explosions, etc.) and checks each affected block’s origin via the CoreProtect API. - **Player-placed blocks** are protected and remain intact. - **All other blocks** (natural terrain, plugin-placed, etc.) are destroyed as normal. - **TNT chain reactions** are still allowed: TNT will break TNT and natural blocks, but any player-placed block in the blast radius remains safe. This is ideal for: - PvE or Creative servers where you want to preserve player builds. - Minigame or adventure maps that use TNT but need to protect certain structures. - Any world where accidental or malicious explosions should not ruin player work. --- ## ⚙️ Installation 1. **Download** the latest `ExplosionProtector.jar`. 2. Place it into your server’s `plugins/` directory. 3. Ensure you have **CoreProtect v10+** installed and enabled. 4. **Start** or **reload** your server. You should see in console: ``` Plugin enabled: protecting player-placed blocks from explosions. ``` --- ## 🛠 Configuration All settings are in `plugins/ExplosionProtector/`. ### 1. `config.yml` ```yaml # config.yml # Supported language codes: en, ru, es, zh, hi, ar, fr, de, ja, pt language: en ``` ### 2. Message files On first run the plugin extracts: - `messages.yml` (default English) - `messages_ru.yml` - `messages_es.yml` - `messages_zh.yml` - `messages_hi.yml` - `messages_ar.yml` - `messages_fr.yml` - `messages_de.yml` - `messages_ja.yml` - `messages_pt.yml` Each contains all user-facing strings. To add or adjust translations, edit the corresponding file in the plugin’s folder. --- ## 💻 Commands All commands require the `explosionprotector.info` permission (default OP-only). | Command | Description | |-------------------------------|---------------------------------------------------| | `/ep status` or `/ep info` | Show plugin status and number of blocks protected in the last explosion. | | `/ep language <code>` | (Admin) Change plugin language at runtime. Valid codes: `en`, `ru`, `es`, `zh`, `hi`, `ar`, `fr`, `de`, `ja`, `pt`. | ### Examples ```shell /ep status # Status: enabled # Blocks protected in last operation: 17 /ep language ru # Language set to 'ru'. ``` ## 🧱 Dependencies - **Spigot / Paper** (1.13+) - **CoreProtect** (v10 or higher)