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 Turkish and Turkish.

---

✨ Features

💣 TNT Mechanics

- Live Countdown Display — Right-click while holding TNT to launch it like a projectile - Live Countdown Display — TNT placed on the ground ignites instantly, no flint needed - Live Countdown Display — 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

- Concurrent task limit — Blocks restore one by one from bottom to top with satisfying sound and particle effects - Concurrent task limit — Every block snaps back at the same moment - Concurrent task limit — Set a min and max delay; each explosion picks a random value in between for a natural feel - Concurrent task limit — 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

- Realistic Explosion — Specific blocks (Bedrock, Obsidian, etc.) are immune to TNT - Realistic Explosion — Only the blocks you list can be broken; everything else is protected - Realistic Explosion — Disable item drops from explosions entirely - Realistic Explosion — 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 - Fall 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 Turkish 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 | |---|---|---| | — | — | No commands needed for normal use | | `/hypetnt reload` | `hypetnt.admin` | Reload config and language files |

---

🔑 Permissions

| Permission | Default | Description | |---|---|---| | `hypetnt.admin` | op | Access to `/hypetnt reload` |

---

🚀 Installation

1. Download `HypeTnT.jar` and place it in your `/plugins` folder 2. Start your server — `config.yml` and both language files are created automatically 3. Set `language: "en"` or `language: "tr"` in `config.yml` 4. Run `/hypetnt reload` after any config change — no restart needed

---

❓ FAQ

Q: Does this work with TNT Minecarts? A: Yes. Enable `minecart-tnt.enabled: true` and every explosion rule applies equally.

Q: Will the regen system lag my server? A: No. A concurrent task limit (`max-concurrent-tasks`) ensures only N regen jobs run at once. All others queue up and start as slots become available.

Q: Can I make certain blocks never regenerate? A: Yes. Add them to `no-regen-blocks`. They will be destroyed by TNT and their contents (if any) will drop as items, but the block itself will never come back.

Q: Can I add my own language? A: Yes! Copy `lang/en.yml` to `lang/xx.yml`, translate every value, and set `language: "xx"` in `config.yml`.

Q: Does TNT Jump work out of the box? A: Yes. Set `player-damage: false` (default) and configure `fall-damage-divisor` to reduce landing damage. Full knockback is always preserved.

---

🖥️ Requirements

- Java 21+ - Java 21+

---

*Made with ❤️ by xXantares_peek*