Gameplay Overview
TNT Run is a fast-paced Minecraft minigame built around survival and quick thinking. Players race across a floor of disappearing blocks, using double jumps and careful movement to avoid falling as more of the arena crumbles away beneath them.
Easy to learn but hard to master, the game keeps players on their toes as the floor disappears faster with every passing second.
The Game Loop
Section titled “The Game Loop”A standard match begins the moment players are teleported to the arena floor. From there, the blocks beneath every player’s feet are scheduled for removal, and the arena keeps shrinking until only one player remains.
The objective is simple: stay on solid ground, use your double jumps wisely, and outlast everyone else.

Key Features
Section titled “Key Features”- Fast-Paced Survival: No breaks, no downtime. The floor keeps disappearing until a winner is crowned.
- Skill-Based Movement: Double jumps reward quick reflexes and smart positioning over luck.
- Spectator-Friendly: Eliminated players don’t just disappear — they can fly around and watch the action unfold.
- Full Statistics: Every match is tracked, from win streaks to longest survival times.
Game States
Section titled “Game States”| State | What Happens |
|---|---|
| Waiting | Players join the arena lobby. The plugin waits for the minimum player count. |
| Starting | A countdown runs. If players leave and the count drops below minimum, the game returns to waiting. |
| In Game | Players are teleported to the start location, inventories are prepared, double jumps become available, and block removal begins. |
| Ending | The winner and summary are announced, statistics are saved, and players are cleaned up. |
| Restarting | The arena returns to a clean waiting state for the next game. |
Countdown Behavior
Section titled “Countdown Behavior”The main timer values are configured in config.yml:
| Setting | Default | What It Controls |
|---|---|---|
waiting-time | 300 | The normal lobby countdown while the arena waits for players. |
pre-game-waiting-time | 120 | The shortened countdown used after the minimum player count is reached. |
game-starting-time | 30 | The shorter countdown used at the accelerated start threshold, about 80% of arena capacity. |
full-game-starting-time | 15 | The faster countdown used when the arena reaches its maximum player count. |
ending-time | 10 | How long the ending state lasts before the arena restarts. |
When the arena reaches the minimum player count, the countdown is shortened to pre-game-waiting-time if needed.
If the arena is mostly full or completely full, the countdown can be shortened again for faster starts.
A shortened countdown never increases the time already remaining. Set pre-game-waiting-time, game-starting-time, or full-game-starting-time to 0 to start without a countdown at that setting’s player threshold.
Negative values in time-settings produce a console warning and use the corresponding default instead.
Joining Late
Section titled “Joining Late”If a player joins while the game is already in progress, the plugin can place them into spectator mode instead of the active player list. This lets players watch the match without affecting the winner.
Elimination
Section titled “Elimination”A player is eliminated when they fall into the void. In an arena with PvP enabled, a lethal hit from another player, including a player-fired projectile, also eliminates them instead of causing a normal Minecraft death.
Eliminated players become spectators, their survival time is recorded, and the game checks whether only one active player remains. Leaving the arena or disconnecting also removes a runner from the active survivor list.
When one survivor is left, that player wins and the game moves to the ending state.
Double Jumps
Section titled “Double Jumps”During the in-game phase, players receive a double jump item. They can use it to launch forward and upward, but each jump has a cooldown and limited uses.
The exact count can come from the default value or from permission-based overrides.
Spectators
Section titled “Spectators”Eliminated players become spectators. Spectators can fly, use spectator items, open a teleporter menu, and change settings such as night vision, speed, and spectator visibility.
See Spectator Mode for the detailed guide.
Rewards
Section titled “Rewards”Use rewards.yml to award separate rewards for first, second, and third place, calculate payments from survival time, or add commands for kills, double jumps, records, and milestones.
Completion rewards apply to participants who remain until normal completion, including eliminated players watching the rest of the round. Late spectator joins and early departures are excluded. Stopped games have no completion rewards; live rewards already earned remain earned.
All command lists are empty by default. Configure the commands and apply changes with /tr reload.