nominecarttnt

** 🛡️ NoMinecartTnt - Complete Plugin Description 📖 Overview **NoMinecartTnt** is a lightweight, high-performance protection plugin for Paper 1.21.1 servers that prevents griefing and exploits using dangerous explosive items. Unlike traditional explosion protection plugins that react *after* damage is done, NoMinecartTnt stops the problem at the source by preventing placement and interaction **before** any explosion occurs. 🎯 The Problem It Solves Minecraft has several items that can cause massive destruction: - **TNT Minecarts** - Can destroy vast areas and crash servers when used in large quantities - **End Crystals** - Used for PvP crystal bombing and base raiding - **Beds** - Explode in the Nether and End, often used for griefing or resource gathering exploits - **Respawn Anchors** - Explode in the Overworld and End, creating mobile explosion sources Traditional solutions either: 1. ❌ Let the explosion happen and then rollback (laggy, damages gameplay) 2. ❌ Cancel all explosions globally (breaks TNT cannons, creepers, etc.) 3. ❌ Use complex claim systems (resource-heavy, complicated for players) **NoMinecartTnt** takes a surgical approach: prevent only the dangerous interactions while keeping normal gameplay intact. --- ✨ Core Features 🌍 **1. Intelligent World Filtering** Two flexible modes to match your server setup: **WHITELIST Mode** (Default) - Restrictions ONLY apply in specified worlds - Perfect for: Survival worlds that need protection while keeping creative/testing worlds unrestricted **BLACKLIST Mode** - Restrictions apply everywhere EXCEPT specified worlds - Perfect for: Allowing special arenas or event worlds while protecting the rest ```yaml world-filter: mode: WHITELIST worlds: - world - world_nether - world_the_end ``` 🧠 **2. Environment-Aware Detection** Unlike naive plugins that check world names, NoMinecartTnt uses Minecraft's native environment detection: ```java World.Environment.NETHER // Works on "world_nether", "survival_nether", "nether_pvp", etc. World.Environment.NORMAL // Works on any overworld World.Environment.THE_END // Works on any end dimension ``` **Why This Matters:** - ✅ Works with custom world names - ✅ Works with multiverse/world management plugins - ✅ Future-proof against world naming changes - ✅ No configuration needed for dimension detection 🚫 **3. Four Independent Restriction Systems** Each can be toggled on/off individually in config: | Restriction | Where Applied | Prevents | Use Case | |-------------|---------------|----------|----------| | **TNT Minecarts** | All filtered worlds | Placement via right-click | Server lag prevention, anti-griefing | | **End Crystals** | All filtered worlds | Placement on obsidian/bedrock | PvP crystal bombing, base raiding | | **Beds (Nether/End)** | NETHER & THE_END only | Right-click interaction | Bed bombing, ancient debris mining exploits | | **Respawn Anchors (Overworld/End)** | NORMAL & THE_END only | Placement & glowstone charging | Mobile griefing, explosion exploits | ⚡ **4. Pre-Emptive Prevention (Zero Lag)** Most protection plugins work like this: ``` Player places TNT → TNT explodes → Plugin detects explosion → Plugin rolls back damage ``` NoMinecartTnt works like this: ``` Player tries to place TNT Minecart → Plugin cancels placement → Nothing happens ``` **Benefits:** - 🚀 Zero performance impact from explosions - 🛡️ No block damage to rollback - 📦 No item drops to clean up - 👥 No player/entity damage calculations 🎨 **5. Modern MiniMessage Support** Fully customizable messages using Kyori Adventure (MiniMessage): ```yaml messages: tnt-minecart: "<red>✖ TNT Minecarts are disabled in this world!" end-crystal: "<red>✖ End Crystals are disabled in this world!" bed-nether-end: "<gold>✖ You cannot use beds in this dimension!" respawn-anchor-overworld-end: "<gold>✖ Respawn Anchors only work in the Nether!" ``` Supports: - Colors: `<red>`, `<green>`, `<gold>`, `<FF5733>` (hex colors) - Formatting: `<bold>`, `<italic>`, `<underlined>` - Gradients: `<gradient:red:blue>`, `<rainbow>` - Hover/Click events (if you want advanced messages) 🔄 **7. Hot-Reload Support** ``` /nominecarttnt reload /nmt reload ``` Change configuration without restarting the server: - Update world lists - Toggle restrictions on/off - Change messages - Switch between whitelist/blacklist modes --- 🎮 Use Cases & Server Types 🏰 **1. Survival Servers** **Scenario:** You want players to enjoy vanilla TNT mechanics (mining, cannons) but prevent mass destruction. **Configuration:** ```yaml restrictions: tnt-minecarts: true Prevent lag machines end-crystals: true Prevent crystal PvP griefing beds-in-nether-end: false Allow bed mining for ancient debris respawn-anchors-in-overworld-end: true ``` **Result:** Normal TNT works, but explosive griefing tools are disabled. --- ⚔️ **2. PvP/Factions Servers** **Scenario:** You want skill-based PvP, not ex