NoCartExplosions

🛒 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.

---

🛠️ Building from Source (Click to expand)

Prerequisites

• JDK 21+
• Apache Maven 3.9+

Build Steps

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!