🧨 ThrownTNT

Right-click to throw TNT. A lightweight but deeply configurable Paper plugin that adds 7 unique throwable TNT types — each with its own recipes, behavior, sounds, particle trails and permissions. Fully customizable, region-safe, and translatable down to the last character.

✅ One jar runs on Paper 1.21.10, 1.21.11, 26.1 and 26.2.

---

📸 Screenshots

[Nuke TNT in Action]	[Admin GUI]
[Lightning TNT Explosion]	[Crafting recipe]

---

🔥 TNT Types

Type	What it does
Classic	The original boom — comes with 3 recipes (more materials = throws further)
Cluster	Scatters a swarm of mini-TNT on impact
Nuke	Massive blast radius for serious demolition
Napalm	Sets the impact zone and nearby mobs ablaze
Flash	No block damage — blinds & slows nearby players (grief-free PvP)
Lightning	Calls down a lightning bolt where it lands
Ender	Teleports you to the impact point

---

✨ Features

• 🧩 7 configurable TNT types in toggleable categories — enable/disable any type or whole group
• 📜 Multiple recipes per type — fully custom shapes & ingredients
• 🎚️ Per-type tuning — fuse, throw speed, explosion power, fire, block-break, potion effects
• 🔊 Per-type sounds & particle trails — each toggleable, with global master switches (anti-lag)
• ⏱️ Per-type throw cooldowns
• 🔑 Per-type permissions — control exactly who can throw what
• 🖥️ Admin GUI — grab any TNT with a click
• 🛡️ WorldGuard support — in a tnt: deny region, TNT won't explode and none of its effects fire
• 🔔 Update notifier — admins are told on join when a new version is out
• 🎨 Full HEX/RGB color support (&#ff0000 and #ff0000)
• 💬 Every message is editable — zero hardcoded text
• ✨ Glint without a real enchant → no XP can be extracted in a grindstone

---

📥 Installation

1. Download the latest ThrownTNT-x.x.x.jar.
2. Drop it into your server's plugins/ folder.
3. Restart the server (a Paper server is required — not Spigot).
4. Edit plugins/ThrownTNT/config.yml to taste, then run /throwntnt reload.

Requirements: Paper 1.21.10+ · Java 21+ (26.1/26.2 require Java 25).

---

⌨️ Commands

Command	Description
/throwntnt give <type> [amount] [player]	Give a TNT type
/throwntnt gui	Open the admin TNT menu
/throwntnt list	List active TNT types
/throwntnt reload	Reload the config

Aliases: /ttnt, /rtnt

---

🔐 Permissions

Permission	Default	Description
throwntnt.admin	op	All admin permissions (give, gui, reload)
throwntnt.give	op	Use /throwntnt give and /throwntnt list
throwntnt.gui	op	Open the admin GUI
throwntnt.reload	op	Reload the config
throwntnt.bypass.cooldown	op	Ignore throw cooldowns
throwntnt.use.<type>	configurable	Throw a specific TNT type (auto-registered)

---

⚙️ Config Example

throwCooldown: 5
usePermissions: true
enableSounds: true
enableTrails: true
respectWorldGuard: true

tnt:
  classic:
    enabled: true
    category: explosive
    displayName: "&#ff5555&lThrowable TNT"
    velocity: 2.0
    cooldown: 5
    behavior: NORMAL
    explosion:
      power: 4.0
      breakBlocks: true
      fire: false
    sound:
      enabled: true
      type: "entity.tnt.primed"
    trail:
      enabled: true
      particle: SMOKE
      count: 2
    recipes:
      basic:
        shape: ["GGG", "GTG", "GGG"]
        ingredients: { G: GUNPOWDER, T: TNT }

The full config ships with all 7 types, comments and examples for every option.

---

Made by NullaretH.