Plugin Description: TNT Wars
TNT Wars is a Minecraft mini-game plugin where team blue and yellow compete to destroy the opposing team's beacon. This plugin allows for easy setup and management of arenas, team spawns, beacons, and waiting areas, providing a smooth gameplay experience for both admins and players.

Core Gameplay:

• Each team (blue and yellow) has a unique beacon.
• The goal is to destroy the enemy team's beacon.
• Players spawn at their team's spawn points and respawn there until their team's beacon is destroyed.
• Once a beacon is destroyed, that team is eliminated, and the game ends when only one beacon remains standing.

Features:

1. Arena Configuration:
   • Create and save arenas with customizable boundaries, team spawn points, beacon locations, and a waiting area.
2. Team Management:
   • Players choose their teams (blue or yellow) and their designated spawn points.
   • Beacons define each team's lifeline. If destroyed, the game ends.
3. Automatic Game Management:
   • The plugin monitors beacon states, ensures smooth respawn mechanics, and manages the game lifecycle.
   • The arena is reset after every game.
4. Player Tools:
   • A Team Selector is automatically given to players when they're teleported into the waiting area, allowing quick team selection.

Commands:
The plugin is managed using specific commands, all prefixed with tntwars. Here's a list of available commands and their usage:

Arena Setup Commands:

1. /tntwars-set-pos1
   • Sets the first corner of the arena.
   • Usage: Players must stand in one corner of the arena and execute this command.
   • Feedback: §aPosition 1 has been set!
2. /tntwars-set-pos2
   • Sets the opposite corner of the arena.
   • Usage: This defines the second boundary of the arena.
   • Feedback: §aPosition 2 has been set!
3. /tntwars-arena-safe
   • Saves the current state of the arena.
   • Requirement: You must first define the arena boundaries using /tntwars-set-pos1 and /tntwars-set-pos2.
   • Error: §cYou must use /tntwars-set-pos1 and /tntwars-set-pos2 first to define the arena!
   • Feedback: §aArena has been successfully saved!

Team and Beacon Setup Commands:

1. /tntwars-set-beacon <team>
   • Sets the beacon location for a specific team (blue or yellow).
   • Usage: Players must aim at a block (within a maximum distance of 5 blocks) and execute this command to set it as the beacon location for the specified team.
   • Validation:
     • Only "blue" and "yellow" are valid teams.
     • Invalid team: §cInvalid team! Use 'blue' or 'yellow'.
     • No targeted block: §cYou must look at a block to set a beacon position!
   • Feedback: §aBeacon position for team <team> has been set!
2. /tntwars-set-team-spawn <team>
   • Sets the spawn point for a specific team.
   • Usage: Players must stand at the intended respawn location and provide the team name (blue or yellow).
   • Feedback: §aSpawn point for team <team> has been set!
3. /tntwars-set-waiting-room
   • Sets the location for the waiting room.
   • Usage: This is the area where players are teleported before starting the game.
   • Feedback: §aWaiting room position has been set!

Game Management Commands:

1. /tntwars-start
   • Starts the game.
   • Requirement: The arena must be saved first using /tntwars-arena-safe.
   • Error: §cThe arena is not saved! Use /tntwars-arena-safe.
   • Feedback: §aThe game has started!
2. /tntwars-tp
   • Teleports the player to the waiting room.
   • Usage: Sets the player's gamemode to "Adventure," gives them the Team Selector item, and teleports them to the configured waiting room.
   • Error: If no waiting room is configured, the message §cThe waiting room position has not been set yet! is displayed.
   • Feedback: §aYou have been teleported to the waiting room! Choose your team using the beacon.
3. /tntwars-help
   • Displays a list of all available commands and their descriptions.

Setup Instructions:
1. Install the Plugin:

1. Place the TNT Wars .jar file into your server's plugins folder.
2. Start or restart the server to generate configuration files (arena.yml and config.yml).

2. Configure the Arena:

1. Set Arena Boundaries:
   • Use /tntwars-set-pos1 and /tntwars-set-pos2 to define the corners of the arena.
2. Set Beacon Locations:
   • Use /tntwars-set-beacon <team> for each team (blue and yellow).
3. Set Team Spawn Points:
   • Use /tntwars-set-team-spawn <team> to configure respawn points for each team.
4. Set the Waiting Room:
   • Use /tntwars-set-waiting-room to define the pre-game gathering area.
5. Save the Arena:
   • Save the arena's configuration using /tntwars-arena-safe.
6. Restart the Server

3. Start the Game:

1. Use /tntwars-tp to teleport to the waiting room and get the Team Selector.
2. Start the game by Comand or the Selector.

Command Summary:
Command Description
/tntwars-set-pos1 Sets the first corner of the arena.
/tntwars-set-pos2 Sets the second corner of the arena.
/tntwars-arena-safe Saves the current state of the arena.
/tntwars-set-beacon <team> Sets the beacon location for a specific team.
/tntwars-set-team-spawn <team> Sets the respawn point for a specific team.
/tntwars-set-waiting-room Sets the waiting room location.
/tntwars-start Starts the game.
/tntwars-tp Teleports the player to the waiting room.
/tntwars-help Displays the help menu with command descriptions.
Game Lifecycle:

1. Setup:
   • Define arena boundaries, team spawn points, and beacon locations.
   • Save the arena state.
2. Pre-Game:
   • Players are teleported to the waiting room.
   • Players can choose their team using the Team Selector.
3. Game Start:
   • The game begins with players spawning at their team's spawn points.
   • Teams compete to destroy each other's beacons.
4. Game End:
   
   • The game ends automatically when one team's beacon is destroyed.
   • Players can reset the arena for a new game.

Youtube Video: