🛒 NoCartExplosions

!Minecraft Version !Platform !Java Version !License

NoCartExplosions is a lightweight, zero-lag server plugin designed to stop TNT Minecarts from destroying blocks and terrain upon detonation while leaving Paper's default explosion damage to players, mobs, and items completely untouched.

---

!logo

[!IMPORTANT] Protect your builds without breaking combat or redstone contraptions!
When a TNT Minecart detonates, 0 blocks are broken, but surrounding players and mobs take standard, vanilla-accurate explosion damage.

---

✨ Features

• 🛡️ Complete Block & Terrain Protection: Prevents TNT Minecarts from damaging blocks, breaking redstone, or cratering land.
• 💥 Preserves Paper Combat Mechanics: Entities (players, mobs, vehicles) still receive standard Paper explosion damage.
• ⚡ Ultra Lightweight & Performant: Event-driven Bukkit listener with minimal CPU footprint and zero tick loss.
• 🌍 World Whitelisting: Restrict protection to specific worlds (e.g., survival, hub) or enable it server-wide.
• 🔄 Live Hot-Reload: Update settings on the fly with /nce reload without restarting your server.
• ☕ Modern Java 21 - 25: Built natively against Paper API 1.21.11 for peak performance.

---

🎮 How It Works

Feature	Standard Minecraft	With NoCartExplosions
Terrain Destruction	💣 Destroys Blocks	🛡️ 100% Protected
Entity Explosion Damage	💥 Takes Damage	💥 Preserved (Stock Paper)
Item Drop Damage	💥 Items Destroyed	🛡️ Protected
Performance Overhead	⚠️ High (Block Physics Update)	⚡ Zero Lag

---

⚙️ Configuration (config.yml)

The default config.yml is simple and ready to use right out of the box:

# ======================================================
#             NoCartExplosions Configuration
# ======================================================

Toggle terrain protection for TNT Minecarts / Explosive Minecarts.

When true, cart explosions will NOT break any blocks or alter terrain.

prevent-terrain-damage: true

List of world names where cart terrain protection is active.

Leave empty [] to enable protection across ALL worlds on the server.

Example:

enabled-worlds:

- world

- world_nether

enabled-worlds: []

If set to true, logs a console message whenever a TNT Minecart explosion's terrain damage is prevented.

log-prevented-explosions: false

---

## 📜 Commands & Permissions

| Command | Permission | Description |
| :--- | :--- | :--- |
| `/nocartexplosions reload` | `nocartexplosions.admin` | Reloads `config.yml` settings live |
| `/nce reload` | `nocartexplosions.admin` | Short alias for reload command |

> [!TIP]
> Administrative permissions default to server operators (`op: true`).

---

## 📦 Installation & Setup

1. **Download**: Grab the latest `.jar` file from the **Versions** tab.
2. **Install**: Drop `NoCartExplosions-1.0.0.jar` into your server's `plugins/` directory.
3. **Start Server**: Run your Paper server (Java 21+ required).
4. **Configure**: Edit `plugins/NoCartExplosions/config.yml` if you want world filtering or debug logging.
5. **Reload**: Use `/nce reload` to apply any changes.

---

<details>
<summary>🛠️ <b>Building from Source</b> (Click to expand)</summary>

### Prerequisites
- JDK 21+
- Apache Maven 3.9+

### Build Steps
```bash
git clone https://github.com/your-repo/NoCartExplosions.git
cd NoCartExplosions
mvn clean package

The compiled output will be generated in target/NoCartExplosions-1.0.0.jar.

---

📄 License

This project is licensed under the MIT License. Feel free to use, modify, and distribute! !top