💣 Ultimate TNT Tag

A high-performance, feature-rich mini-game for Spigot, Paper, and Purpur.

Ultimate TNT Tag is the definitive solution for server owners who want a stable, optimized, and "fool-proof" mini-game experience. Designed with performance in mind, this plugin ensures that your players enjoy a seamless game without affecting your server's TPS.

---

🔥 Key Features

⚡ Ultra-Optimized Engine

• Low CPU Footprint: Built using efficient event handling and asynchronous tasks where possible.
• No Memory Leaks: Thoroughly tested cleanup processes ensure that data is cleared once a game ends.
• Version Support: Native 1.21 support, with backward compatibility from 1.13 to 1.26.2+.

🎮 Superior Gameplay Experience

• Visual Effects: The player with the TNT is easily identifiable with a TNT block on their head and a trail of high-quality flame particles.
• Flicker-Free Scoreboard: A dedicated sidebar that shows the player's role (Runner/IT) and a real-time explosion countdown.
• Dynamic Potion Effects: Players automatically receive Speed IV (configurable) to keep the game fast and exciting.
• Sound Alerts: Auditory feedback for tagging and countdowns (based on game events).

🛡️ Robust Security & Protection

• Anti-Cheat Boundaries: If a player leaves the defined arena area, they are automatically assigned the TNT. No more hiding or escaping the map!
• Global Grief Protection: The plugin automatically prevents block breaking, placing, and item dropping within the arena zones.
• Command Blocker: Prevents players from using unauthorized commands during an active match.
• PVP Control: Damage is disabled globally, only allowing "tagging" mechanics when the game is active.

---

🕹️ How It Works

1. Lobby Phase: Players join via /tt join. Once the minimum player count is reached, a 30-second countdown begins.
2. Game Start: Players are teleported to the arena. A random player is selected to be "IT".
3. The Chase: The "IT" player must punch another player to transfer the TNT.
4. Explosion: When the 30-second TNT timer hits zero, the player holding the TNT is eliminated.
5. Winning: The game continues until only one survivor remains. The winner is teleported to the return point and celebrated!

---

🛠️ Administrative Setup

Setting up an arena is designed to be intuitive. Follow these steps:

1. Set Global Points:
   • /tt setlobby — Sets the waiting area.
   • /tt setreturn — Sets the location where players go after a game ends.
2. Create Arena:
   • /tt create <name> — Registers a new arena in the system.
3. Set Boundaries:
   • Use /tt <name> pos1 and /tt <name> pos2 at two opposite corners of your arena to define the play zone.
4. Set Game Spawn:
   • /tt <name> setspawn — The location where players spawn when the game starts.

---

📜 Commands & Permissions

Command	Description	Permission
/tt join <arena>	Join a game queue	tt.player
/tt leave	Quit the game/lobby	tt.player
/tt create <name>	Create a new arena	tt.admin
/tt <name> pos1/2	Set arena boundaries	tt.admin
/tt <name> setspawn	Set arena spawn point	tt.admin
/tt setlobby	Set global lobby	tt.admin
/tt setreturn	Set return point	tt.admin

⚙️ Configuration Preview

The plugin is highly customizable via config.yml and messages.yml:

# config.yml
settings:
  start_countdown: 30 # Time in seconds before game starts
  tnt_timer: 30       # Time in seconds before TNT explodes
  speed_level: 4      # Speed effect level (e.g., 4 = Speed IV)
  min_players: 2      # Minimum players needed to start