nominecarttnt

** 🛡️ NoMinecartTnt - Complete Plugin Description

📖 Overview

before 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: - Respawn Anchors - Can destroy vast areas and crash servers when used in large quantities - Respawn Anchors - Used for PvP crystal bombing and base raiding - Respawn Anchors - 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 | |-------------|---------------|----------|----------| | Respawn Anchors (Overworld/End) | All filtered worlds | Placement via right-click | Server lag prevention, anti-griefing | | Respawn Anchors (Overworld/End) | All filtered worlds | Placement on obsidian/bedrock | PvP crystal bombing, base raiding | | Respawn Anchors (Overworld/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 explosion spam.

Configuration: ```yaml world-filter: mode: BLACKLIST worlds: - warzone Special arena where all explosives are allowed

restrictions: tnt-minecarts: true end-crystals: true Prevents crystal PvP cheese beds-in-nether-end: true respawn-anchors-in-overworld-end: true ```

Result: Clean PvP in most worlds, unrestricted warfare in designated arenas.

---

🎨 3. Creative/Build Servers

Scenario: Protect spawn and showcase areas, allow everything in build plots.

Configuration: ```yaml world-filter: mode: WHITELIST worlds: - lobby - showcase

restrictions: tnt-minecarts: true end-crystals: true beds-in-nether-end: false Decorative beds should work respawn-anchors-in-overworld-end: false ```

Result: Protected public areas, unrestricted creative zones.

---

🌐 4. Hybrid Servers (Multiple Game Modes)

Scenario: Survival, Creative, SkyBlock, Minigames on one server.

Configuration: ```yaml world-filter: mode: BLACKLIST worlds: - creative - build_world - minigame_lobby

All restrictions enabled everywhere except listed worlds ```

Result: Full protection in survival/skyblock, full freedom in creative/minigames.

---

🏭 5. Anarchy Servers (Selective Protection)

Scenario: True anarchy, but prevent server-crashing exploits.

Configuration: ```yaml world-filter: mode: WHITELIST worlds: - world

restrictions: tnt-minecarts: true ONLY prevent lag machines end-crystals: false beds-in-nether-end: false respawn-anchors-in-overworld-end: false ```

Result: Maximum freedom, minimum anti-lag intervention.

---

🔧 Configuration Deep Dive

Complete config.yml with Explanations

```yaml ═══════════════════════════════════════════════════════════ NoMinecartTnt Configuration ═══════════════════════════════════════════════════════════

┌─────────────────────────────────────────────────────────┐ │ WORLD FILTER SYSTEM │ └─────────────────────────────────────────────────────────┘

world-filter: Mode determines how the world list is interpreted: WHITELIST = Restrictions ONLY in listed worlds BLACKLIST = Restrictions EVERYWHERE except listed worlds mode: WHITELIST

World names (case-insensitive) Use exact names from your server's world folders worlds: - world - world_nether - world_the_end

┌─────────────────────────────────────────────────────────┐ │ RESTRICTION TOGGLES │ └─────────────────────────────────────────────────────────┘

restrictions: TNT Minecarts (Applied in: ALL filtered worlds) Prevents: Right-click placement on rails Reason: Lag machines, mass destruction tnt-minecarts: true

End Crystals (Applied in: ALL filtered worlds) Prevents: Placement on obsidian/bedrock Reason: Crystal PvP, base raiding, griefing end-crystals: true

Beds (Applied in: NETHER and THE_END dimensions only) Prevents: Right-click interaction Reason: Bed bombing, ancient debris mining exploits Note: Does NOT prevent sleeping in Overworld beds-in-nether-end: true

Respawn Anchors (Applied in: OVERWORLD and THE_END only) Prevents: Block placement and glowstone charging Reason: Mobile explosion source outside intended dimension Note: Still works normally in the Nether respawn-anchors-in-overworld-end: true

┌─────────────────────────────────────────────────────────┐ │ MESSAGES (MiniMessage Format) │ └─────────────────────────────────────────────────────────┘

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!" reload: "<green>✔ NoMinecartTnt configuration reloaded!" no-permission: "<red>✖ You don't have permission to use this command!"

┌─────────────────────────────────────────────────────────┐ │ MINIMESSAGE EXAMPLES │ └─────────────────────────────────────────────────────────┘ Basic colors: <red>, <gold>, <green>, <blue>, <aqua> Hex colors: <FF5733> Formatting: <bold>, <italic>, <underlined> Combined: "<bold><red>ERROR!</bold> <gray>This is disabled." Gradient: "<gradient:red:blue>Rainbow text!</gradient>" ```

---

🎛️ Commands & Permissions

Commands

| Command | Aliases | Description | Permission | |---------|---------|-------------|------------| | `/nominecarttnt reload` | `/nmt reload` | Reloads configuration from disk | `nominecarttnt.reload` |

Permissions

| Permission | Default | Description | |------------|---------|-------------| | `nominecarttnt.reload` | op | Use the reload command |

```

🔬 Technical Details

Event Priority & Handling

```java @EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true) ```

- Early cancellation: Runs after most plugins but before HIGHEST/MONITOR - Early cancellation: Won't interfere with events already cancelled by other plugins - Early cancellation: Prevents item consumption, prevents explosion spawning

Events Used

| Item | Event | Bukkit/Paper | Why | |------|-------|--------------|-----| | TNT Minecart | `PlayerInteractEvent` | Bukkit | Catches right-click on rails | | End Crystal | `EntityPlaceEvent` | Paper 1.21+ | Specific entity placement event | | Bed | `PlayerInteractEvent` | Bukkit | Catches right-click on bed blocks | | Respawn Anchor | `BlockPlaceEvent` + `PlayerInteractEvent` | Bukkit | Catches placement and charging |

Performance

- No Database: Negligible (~0.001% TPS impact) - No Database: < 1MB RAM - No Database: Instant (no delays, no scheduled tasks) - No Database: Pure configuration-based

Benchmarks (on 20 TPS server with 100 players): - Processing 1000 prevented placements: < 5ms total - No lag spikes from explosion prevention - Hot-reload: < 50ms

---

📥 Installation

Requirements - ✅ Paper 1.21 or 1.21.1 (or any Paper fork) - ✅ Java 21 - ❌ Does NOT work on Spigot (requires Paper-specific events) - ❌ Does NOT work on older versions (uses 1.21 API)

Steps

1. Reload the plugin JAR 2. Reload in your server's `plugins/` folder 3. Reload the server (or use `/reload confirm` if already running) 4. Reload `plugins/NoMinecartTnt/config.yml` 5. Reload with `/nmt reload`

First-Time Setup

```bash 1. Stop server stop

2. Place JAR cp NoMinecartTnt-1.0.0.jar plugins/

3. Start server java -jar paper.jar

4. Edit config nano plugins/NoMinecartTnt/config.yml

5. In-game reload /nmt reload ```

---

🧪 Testing & Verification

Test Checklist

✅ TNT Minecart Prevention 1. Get TNT minecart from creative 2. Place rails in a whitelisted world 3. Right-click rails with TNT minecart 4. Expected: Item not placed, error message shown

✅ End Crystal Prevention 1. Place obsidian or bedrock 2. Right-click with End Crystal 3. Expected: Crystal not placed, error message shown

✅ Bed in Nether 1. Go to the Nether 2. Place and right-click a bed 3. Expected: No explosion, error message shown 4. Go to Overworld, test same bed 5. Expected: Normal sleep works

✅ Respawn Anchor in Overworld 1. Place Respawn Anchor in Overworld 2. Expected: Block not placed, error message shown 3. Try in Nether 4. Expected: Works normally

✅ World Filter 1. Set mode to `WHITELIST` with `[world]` 2. Try restrictions in `world` 3. Expected: Blocked 4. Try in `world_nether` 5. Expected: Allowed 6. Change mode to `BLACKLIST` 7. Expected: Reverse behavior

---

🆚 Comparison with Alternatives

| Feature | NoMinecartTnt | WorldGuard | GriefPrevention | Essentials | |---------|---------------|------------|-----------------|------------| | Performance | ✅ Pre-placement | ❌ | ❌ | ❌ | | Performance | ✅ Pre-placement | ⚠️ Flag-based | ❌ | ❌ | | Performance | ✅ Dimension-aware | ⚠️ With flags | ❌ | ❌ | | Performance | ✅ Dimension-aware | ❌ | ❌ | ❌ | | Performance | ✅ Built-in | ⚠️ Per-region | ❌ | ❌ | | Performance | ✅ No explosions | ❌ Rollback lag | ❌ Rollback lag | N/A | | Performance | 🟢 Simple | 🟡 Medium | 🟡 Medium | 🟢 Simple | | Performance | 🟢 Minimal | 🟡 Heavy | 🟡 Medium | 🟢 Light |

When to Use NoMinecartTnt

✅ Use if you want: - Surgical prevention of specific explosive items - No performance impact from explosions - Simple configuration - Dimension-aware restrictions

❌ Don't use if you need: - Full region protection with flags - Claim systems - Protection from creepers, TNT, etc. (use WorldGuard) - 1.20 or older support

Complementary Plugins

Works great with: - Multiverse - For region protection - Multiverse - For rollback of other damage - Multiverse - For claim systems - Multiverse - For world management

---

❓ FAQ

Q: Does this work with custom dimension plugins?

A: Yes! As long as the world uses standard Minecraft environments (`NORMAL`, `NETHER`, `THE_END`), it will work. Example: A plugin that creates a custom Nether world called "hell_dimension" will still be detected as `Environment.NETHER`.

---

Q: Will this break the Ender Dragon fight?

if the End is in your world filter No! End Crystals are only blocked if the End is in your world filter and if the End is in your world filter.

To allow End Crystals in the End but nowhere else: ```yaml world-filter: mode: BLACKLIST Block everywhere except... worlds: - world_the_end This world is allowed

restrictions: end-crystals: true ```

---

Q: Does this prevent ALL explosions?

A: No! Only the 4 specific items: - TNT Minecarts - End Crystals - Beds (in Nether/End) - Respawn Anchors (in Overworld/End)

Regular TNT, creepers, fireballs, etc. work normally.

---

Q: Will this work on Spigot?

A: No. The plugin uses `EntityPlaceEvent` which is Paper-only. It requires Paper 1.21+.

---

Q: Can I disable only TNT Minecarts and allow everything else?

A: Yes! Just set the others to `false`: ```yaml restrictions: tnt-minecarts: true end-crystals: false beds-in-nether-end: false respawn-anchors-in-overworld-end: false ```

---

Q: Does this work with economy/shop plugins?

A: Yes! If a player purchases a TNT Minecart from a shop, they'll receive the item. However, when they try to place it in a restricted world, it will be blocked. This is intentional - the item isn't consumed, so they can use it in an unrestricted world.

---

Q: What happens if I change from WHITELIST to BLACKLIST?

A: The logic reverses immediately after `/nmt reload`:

Before (WHITELIST with [world]): - `world` → Restricted ✅ - `world_nether` → Allowed ❌

After (BLACKLIST with [world]): - `world` → Allowed ❌ - `world_nether` → Restricted ✅

---

Q: Can I customize messages per-world or per-player?

A: Not in the current version. All messages are global. However, you can use PlaceholderAPI-compatible plugins to add dynamic content if you modify the code.

---

Q: Does this protect against other explosive exploits?

CoreProtect Only the 4 listed items. For comprehensive protection, combine with: - CoreProtect - TNT damage, creeper damage, etc. - CoreProtect - Rollback for any damage that gets through

---

📊 Version History

v1.0.0 (Current) - ✅ Initial release - ✅ TNT Minecart prevention - ✅ End Crystal prevention - ✅ Bed bombing prevention (Nether/End) - ✅ Respawn Anchor prevention (Overworld/End) - ✅ Whitelist/Blacklist world filtering - ✅ MiniMessage support - ✅ Hot-reload command

---

🛠️ Support & Contributing

Contact Discord - geturplugins**

Getting Help 1. Check this documentation first 2. Test with `/nmt reload` after config changes 3. Check console for errors 4. Verify you're using Paper 1.21+

Common Issues

"Plugin not loading" - Check Java version: `java -version` (must be 21+) - Check Paper version: Must be 1.21 or 1.21.1 - Check console for errors

"Restrictions not working" - Verify world filter mode and world list - Confirm restriction is enabled in config - Use `/nmt reload` after changes

"Messages not showing" - Check MiniMessage syntax (no spaces in tags) - Verify message path in config - Test with simple message: `<red>Test`

---

🎯 Summary

NoMinecartTnt is the surgical solution for preventing explosive griefing without breaking vanilla gameplay. By stopping dangerous items *before* they cause damage, it maintains server performance while giving you granular control over what's allowed in each world and dimension.

Perfect for servers that want protection without the complexity of full region management systems.

---

Java Version: 1.0.0 Java Version: 1.21 - 1.21.1 Java Version: Paper (and forks) Java Version: 21+**