💣 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
—	—	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

• Paper / Purpur 1.21+
• Java 21+

---

Made with ❤️ by xXantares_peek