🛒 NoCartExplosions

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.

[!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.

git clone https://github.com/your-repo/NoCartExplosions.git
cd NoCartExplosions
mvn clean package

📄 License

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