HypeTnT

# 💣 HypeTnT ### A feature-rich, high-performance and fully configurable TNT plugin for Paper 1.21+ --- ## 📸 Overview HypeTnT completely transforms the vanilla TNT experience. Throw TNT like a snowball, watch blocks fly through the air, see them regenerate one by one with satisfying animations — all while your server handles 1000+ players without breaking a sweat. Every feature is toggle-able, every value is tunable, and the entire message system is available in both **English** and **Turkish**. --- ## ✨ Features ### 💣 TNT Mechanics - **TNT Throwing** — Right-click while holding TNT to launch it like a projectile - **Auto-Ignite** — TNT placed on the ground ignites instantly, no flint needed - **Custom Fuse Timer** — Set exactly how many ticks TNT takes to explode - **Live Countdown Display** — A floating name above the TNT shows the remaining fuse time with full colour-code support and randomised name templates ### 🔁 Block Regeneration - **SEQUENTIAL mode** — Blocks restore one by one from bottom to top with satisfying sound and particle effects - **ALL_AT_ONCE mode** — Every block snaps back at the same moment - **Random delay** — Set a min and max delay; each explosion picks a random value in between for a natural feel - **No-Regen Blocks** — Certain blocks (e.g. chests) are destroyed permanently; their contents drop as items and the block never comes back - **Concurrent task limit** — Never more than N regen jobs running at once; extras are queued and start automatically when a slot opens ### 💥 Explosion Control - **Blacklist** — Specific blocks (Bedrock, Obsidian, etc.) are immune to TNT - **Whitelist mode** — Only the blocks you list can be broken; everything else is protected - **Block drop toggle** — Disable item drops from explosions entirely - **Max-blocks cap** — Limit how many blocks one explosion can affect to protect server performance - **Realistic Explosion** — Broken blocks turn into flying `FallingBlock` entities that soar through the air before disappearing; fully configurable entity cap and entity damage toggle ### 🪨 Obsidian Breaker - Obsidian requires a configurable number of TNT hits before it breaks - Hit counter resets automatically after 5 minutes of inactivity - Nearby players receive an Action Bar notification showing remaining hits - Works independently of the blacklist — no config changes needed ### ⚡ TNT Jump - Set `player-damage: false` to remove all damage while keeping full knockback - **TNT Damage Divisor** — Reduce (not remove) TNT damage by a configurable factor - **Fall Damage Divisor** — Players launched by TNT receive reduced fall damage for 8 seconds — perfect for jump-style game modes ### ⏱️ Cooldown System - Per-player throw cooldown with a live Action Bar countdown - "Ready to throw" notification when the cooldown expires - Fully configurable duration; can be disabled entirely ### 🚃 TNT Minecart Support - All explosion rules (blacklist, whitelist, regen, no-regen, etc.) apply to TNT Minecart explosions too — one config, consistent behaviour everywhere ### 🌍 Multi-Language - Ships with **English** and **Turkish** out of the box - Every message lives in `lang/en.yml` / `lang/tr.yml` - Missing keys fall back to English automatically — you'll never see a raw key - Switch language with one line: `language: "en"` or `language: "tr"` - Add your own language by copying `en.yml` and translating it ### ⚙️ Fully Configurable | Option | Default | Description | |---|---|---| | `language` | `en` | Plugin language (`en` / `tr`) | | `throw-enabled` | `true` | Enable right-click throwing | | `throw-velocity` | `1.5` | Projectile speed multiplier | | `auto-ignite` | `true` | Ignite TNT on place | | `fuse-ticks` | `80` | Ticks until explosion (20 = 1 s) | | `custom-name.enabled` | `true` | Show fuse countdown above TNT | | `cooldown-seconds` | `3.0` | Seconds between throws | | `explosion-radius` | `5.0` | Explosion strength | | `cause-fire` | `false` | Spawn fire on explosion | | `break-blocks` | `true` | Allow block destruction | | `disable-drops` | `false` | Suppress item drops | | `max-blocks` | `200` | Block cap per explosion | | `realistic.enabled` | `false` | Flying-block explosion mode | | `regen-type` | `SEQUENTIAL` | `SEQUENTIAL` or `ALL_AT_ONCE` | | `min-delay / max-delay` | `3 / 5` | Random regen start delay (seconds) | | `no-regen-blocks` | list | Blocks destroyed but never restored | | `player-damage` | `false` | TNT deals damage to players | | `tnt-damage-divisor` | `1.0` | Divide TNT damage by this value | | `fall-damage-divisor` | `5.0` | Divide post-TNT fall damage | | `obsidian-breaker.enabled` | `false` | Multi-hit obsidian breaking | | `obsidian-breaker.hits` | `3` | Hits required to break obsidian | | `blacklisted-worlds` | list | Worlds where plugin is disabled | | `minecart-tnt.enabled` | `true` | Apply rules to TNT Minecarts | --- ## 🛠️ Commands & Permissions | Command | Permission | Description | |---|---|---|