TNT Run Documentation

TNT Run

TNT Run is a competitive Minecraft minigame where players run across layers of removable blocks while the floor disappears under their feet. The goal is simple: keep moving, use your double jumps carefully, avoid falling through every layer, and be the last player alive.

Built for server owners who want a polished arena game, TNT Run includes setup menus, join signs, scoreboards, boss bars, spectator menus, per-arena records, statistics, PlaceholderAPI placeholders, and a developer API for custom integrations.

Get Started

Getting Started Install TNT Run and get your server ready for gameplay in minutes.

Arena Setup Create and configure arenas to host TNT Run matches.

Gameplay Overview Learn how matches work and how winners are decided.

Features

These pages explain the important gameplay systems from a server owner perspective.

Double Jumps How jump counts, cooldowns, permissions, sounds, and the action bar cooldown work.

Block Removal & Recovery How TNT Run removes floors, snapshots block data, and restores arenas after restarts or crashes.

Spectator Mode How eliminated players spectate, teleport to alive players, and configure spectator visibility.

Commands

All TNT Run commands are grouped by purpose to keep server management clean and intuitive.

Player Commands Commands that can be used by players to join or leave games and view player statistics.

Arena Commands Commands used to create, edit, and manage arenas.

Admin Commands Administrative commands for managing games and settings.

Debug Commands Advanced commands for testing and troubleshooting.

Configuration Files

TNT Run offers extensive configuration through multiple files, allowing full control over visuals, messages, and gameplay behavior.

config.yml Main configuration file controlling core gameplay behavior and plugin settings.

block-removal.yml Control when arena blocks start disappearing, which materials are removable, and how crash recovery works.

messages.yml Customize all in-game messages, titles, subtitles, and text outputs used by TNT Run.

scoreboard.yml Configure the in-game scoreboard layout, lines, and displayed values.

bossbar.yml Customize boss bars used during gameplay, including colors, styles, and messages.

items.yml Configure lobby items such as the leave item, including their name, material, slot, and lore.

signs.yml Customize the appearance and behavior of arena join signs.

sounds.yml Configure gameplay sounds such as the double jump sound effect.

mysql.yml Configure external database connections to synchronize player statistics across your network.

GUI Menus Customize the setup, statistics, spectator settings, and spectator teleporter menus.

Other Files Automatically managed internal files used by the TNT Run plugin.

Placeholders

TNT Run provides built-in placeholders and full PlaceholderAPI support, allowing you to display game, arena, and player data across your server.

General Placeholders Placeholders for game state, arena information, and player-related data.

Leaderboard Placeholders Placeholders specifically designed to display leaderboard rankings and statistics.

Developer API

Explore the various events and integration points to extend TNT Run functionality.

Player Events Documentation for events related to player actions and statistics.

Game Events Events triggered by game state changes, starts, and endings.

Miscellaneous

FAQ Common questions, known issues, and troubleshooting information.

Source Code Explore the codebase, report issues, or contribute on GitHub.