TNT Run | [1.9 - 1.21.4]

TNT Run | [1.9 - 1.21.4] -----

Jump and run over exploding blocks before they're gone!

Minimum Java Version: Java 17

Discord: https://discord.gg/uXVU8jmtpU

TNT Run
TNT Run is a fast-paced jump 'n run TNT game where players survive as long as possible by parkouring across a floor of disappearing blocks

How the game works:
Players (up to 12 or 24, mostly, depending on the map) are placed on sand/gravel floors. Blocks you run or stand on will disappear or "fall" after a brief delay. Once you fall, you will end up on the next floor below. Each map multiple floors to run on, the lowest floor being above the void which eliminates you. The goal is to be the last player alive which gets progressively more difficult as the space available diminishes.

Abilities:
Each player is given double jumps to help them survive.

Double Jump
Double jumps can be activated by either double tapping the jump key (default: space) or right-clicking the feather given in the player's hotbar. Double jumps fling the player in the direction they are looking, helping them to jump large gaps, save themselves from falling, or even move up to a higher floor. By default, each player gets 5 double jumps.

Features:
The plugin is highly configurable, allowing you to customize everything. Some notable features of this game include:

Unlimited Arenas: Create as many arena instances as you'd like—your creativity is the only limit.
Custom Map Design: Build personalized maps to match your unique vision for the game.
MySQL Support: Track and manage player data easily with MySQL integration.
BungeeCord Compatibility: Turn each server instance into a standalone game for a smooth BungeeCord experience.
Map Restoration: Automatically restore all blocks to their original state after each game.
Inventory Management: Save and restore player inventories to ensure no items are lost.
Scoreboard & Boss Bar: Fully customizable messages for each game state across different arenas.
Separated Chat: Keep in-game chat separate from other from the rest of the server for a more immersive player experience.
Hidden Players: Limit player visibility so only in-game players can see each other, while spectators and non-participants remain hidden.
TOP 10 Leaderboards: Display players with the highest score.
Command Restrictions: Control which commands players can use during the game for a fair experience.
PlaceholderAPI Support: Integration with PlaceholderAPI, offering 17+ different placeholders.
Developer API: API available for developers.
+20 More Customizable Settings: Enjoy additional customization options tailored to enhance gameplay.

Setup:

Download the plugin and put it in the plugins folder. Start the server to to allow plugin to create configuration files.
Now start with creating an arena using the "/tntrun create <arena_name>" command.
Open the arena editor using the "/tntrun edit <arena_name>" command and setup the arena via this menu.
1. First, click to the white concrete then set the lobby and end locations. The start location is the same with the lobby location.
2. Next, you can change the map name by clicking the name tag. Type the new map name in the chat. By default map name is the same with arena ID. This step is optional.
3. Next, you can change the minimum and maximum player amounts by clicking the glowstone dust. This step is optional.
4. When you're done, click to the barrier item to register the arena. You can also edit the arena later by using "/tntrun edit <arena_name>" command.
Once you've completed the setup steps and registered the arena, your arena is ready to play. Use "/tntrun join <arena_name>" or /tntrun randomjoin" command to join the arena.
Enjoy the game!

Commands:

Admin:
/tntrun create <arena_name> - Creates a game instance.
/tntrun delete <arena_name> - Deletes the game instance with the given ID.
/tntrun edit <arena_name> - Opens the arena editor menu.
/tntrun list - Shows the list of existing arena IDs.
/tntrun forcestart - Forces the arena that the player is in to start, if there are enough players.
/tntrun stop - Forces the arena that the player is in to stop.
/tntrun reload - Reloads the configuration files.
/tntrun help - Displays a list of available commands along with their descriptions.

Player:
/tntrun join <arena_name> - Creates a join attemt to the target arena.
/tntrun randomjoin - Creates a join attempt to the available arena with the most players.
/tntrun leave - Creates a leave attempt for the player.
/tntrun stats [player] - Shows player's own or the target player's statistics.
/tntrun top <statistic_name> - Shows the TOP 10 players in the given statistic.

Permissions:
tntrun.admin
tntrun.admin.create
tntrun.admin.delete
tntrun.admin.edit
tntrun.admin.list
tntrun.admin.help
tntrun.admin.forcestart
tntrun.admin.stop
tntrun.admin.sign.create
tntrun.admin.sign.break
tntrun.admin.reload
tntrun.command.override

PlaceholderAPI Placeholders:

Player:

%tntrun_player%
%tntrun_uuid%
%tntrun_wins%
%tntrun_loses%
%tntrun_games_played%
%tntrun_longest_survive%
%tntrun_coins%
%tntrun_local_coins%
%tntrun_local_survive%
%tntrun_local_double_jumps%

Arena:

%tntrun_<arena-id>: players%
%tntrun_<arena-id>: players_left%
%tntrun_<arena-id>:max_players%
%tntrun_<arena-id>:min_players%
%tntrun_<arena-id>:state%
%tntrun_<arena-id>:state_pretty%
%tntrun_<arena-id>:map_name%
%tntrun_<arena-id>:timer%
%tntrun_<arena-id>:timer_pretty%

TOP 10 Leaderboard:

%tntrun_top:<statistic-name>:<position>:name%
%tntrun_top:<statistic-name>:<position>:value%
Statistic Names:
- wins
- loses
- coinsearned
- gamesplayed
- longestsurvive

Config:

Code (YAML):

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# #
# TNTRun #
# Despical #
# #
# https://www.buymeacoffee.com/despical #
# #
# Donations are really appreciated! <3 #
# #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

Time-Settings :
# Every 45 seconds a broadcast message will be sent to players
# about how many players should arena need to start.
Lobby-Waiting-Time : 45
# How many seconds should we wait for other players when we reach
# minimum player amount in the arena.
Lobby-Starting-Time : 16
# How many seconds are we going to wait in ending state?
# After this amount of time passed we'll send players to lobby.
Ending-Time : 6
# How many seconds after the blocks will be removed after the game starts.
Start-Block-Removing : 5
# How many ticks after the blocks will be removed when players moved on it.
Block-Remove-Delay : 12

Double-Jumps :
# Default amount of double jumps for each of in-game players that doesn't have double jump permission.
Default : 5
# The duration between using double jumps as seconds.
Delay : 4
# https://github.com/Despical/TNTRun/wiki/Commands-and-permissions#double-jump-permissions
Permissions :
- tntrun.doublejumps.3
- tntrun.doublejumps.2
- tntrun.doublejumps.1

# How many blocks should we scan on different scenarios?
Scanning-Depth:
On-Ground : 2
In-Air : 6

# The block list that we are going to remove these when player is on these blocks in-game.
Whitelisted-Blocks :
- TNT
- SAND
- SANDSTONE
- GRAVEL
- STAINED_CLAY
- RED_SANDSTONE
- RED_SAND

# Leave this section empty so everyone can join.
# Op-ed players will override all the permissions.
Join-Permission : ""

Join-Full-Game-Permission : "tntrun.fullgames"

# Should we create a progress bar to show how many seconds left
# to use a new double jump?
Jump-Bar : true

# The statistics saving rate, in seconds. (0 = save the stats on server shutdown/reload)
Statistic-Saving-Period : 300

# Should we block commands that are not associated with MM?
Block-Commands : true

# Put 'exact:command here' to check for the exact command name.
# By default, we'll check if the executed command starts with any command in the list.
Whitelisted-Commands : [ ]

# Should we create cool scoreboards for in-game players?
Scoreboard-Enabled : true

# See messages.yml for game bar messages.
# Should we create a game bar for in-game players?
Game-Bar-Enabled : true

# Should we enable our Bungee-cord server support?
Bungee-Enabled : false

# Enable Inventory Manager for your games? (Very useful feature for MULTI ARENA)
# This saves inventory of players and restores it after player leaves arena.
# Saved elements: max health, health, food, experience, full inventory, armor contents, and more.
Inventory-Manager:
Enabled : true
# Usable elements: health, max-health, health-scale
Do-Not-Restore :
- "max-health"
- "health-scale"

# Should we disable fall damage?
Disable-Fall-Damage : true

# Should we enable our MySQL support?
# See mysql.yml for detailed information.
Database-Enabled : false

# Should we hide players' name tags in-game?
Name-Tags-Hidden : false

# Should we allow players to hit others? (Damaging can not be enabled.)
PVP-Disabled : true

# Should we format the chat messages?
# See messages.yml to change format.
Chat-Format-Enabled : true

# Should the messages stay between arena players or general?
Disable-Separate-Chat : false

# Should players instantly leave the arena using leave item?
Instant-Leave : false

# Should we only update players' longest survive statistic when they win?
Longest-Survive-On-Wins : false

# Should we check for any available updates?
Update-Notifier-Enabled : true

Messages:

Code (YAML):

admin-commands:
did-you-mean : "&3Did you mean &b%command%?"
correct-usage : "&cCorrect usage: %usage%"
cannot-do-that-ingame : "&cYou can not do that while playing!"
provide-an-arena-name : "&cPlease provide an arena name!"
there-is-already-an-arena : "&cThere is already an arena with that name!"
no-arena-found-with-that-name : "&cNo arena found with that name!"
deleted-arena-successfully : "&cDeleted arena called {0} successfully!"
must-be-in-arena : "&cYou must be in the arena to perform this command!"
system-reloaded : "&aSystem files and configurations successfully reloaded!"
list-command:
no-arenas-created : "&cThere aren't any arena to show!"
format : "&aExisting arenas: &7%list%"

player-commands:
only-command-is-leave : "&cYou can only use /tntrun leave command while playing TNT Run!"
no-player-found : "&cNo player found with that name!"
no-free-arenas : "&cThere aren't any available arena to join!"
statistics:
type-name : "&cPlease type statistic name to view!"
invalid-name : "&cNo statistic found with that name!"
header : "&8&m-------------------[&6 Top 10 &8&m]-------------------"
format : "&e#%position% %name% - %value% &7%statistic%"
stats-command:
header : "&l[-----YOUR STATS-----]"
header-other : "&l[-----STATS FOR %player%-----]"
messages :
- "%header%"
- "&8 • &fTotal Wins : &a%wins%"
- "&8 • &fTotal Loses : &a%loses%"
- "&8 • &fTotal Coins : &a%coins%"
- "&8 • &fLongest Survive : &a%longest_survive%"
- "&8 • &fGames Played : &a%games_played%"
- "&l[--------------------]"

messages:
arena:
no-permission : "&cYou don't have enough permission to join this arena!"
not-configured : "&cThis arena is not ready yet to play!"
already-playing : "&cYou are already playing TNT Run!"
not-playing : "&cYou cannot leave the game if you are not playing!"
restarting : "&cYou cannot join while this arena is restarting!"
waiting-for-players : "\n&a{0} more player{1} required for the game to start.\n"
starts-in-20s : "&eThe game starts in 20 seconds!"
starts-in-10s : "&eThe game starts in &610&e seconds!"
starts-in-5s-and-less : "&eThe game starts in &c%time%&e seconds!"
countdown-cancelled : "&c&lCountdown cancelled! There aren't enough players to start!"
join-arena : "&7%player%&e has joined (&b%players%&e/&b%max_players%&e)!"
quit-arena : "&7%player%&e has quit!"
game-explanation :
- "%no_center%&a&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
- "&f&lTNT Run"
- ""
- "&e&lAvoid the falling blocks and try to"
- "&e&lsurvive longer than everyone else!"
- ""
- "%no_center%&a&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
spectators:
show-spectators : "&aYou can now see other spectators!"
hide-spectators : "&cYou can no longer see other spectators!"
have-night-vision : "&aYou now have night vision!"
removed-night-vision : "&cYou no longer have night vision!"
auto-teleport-enabled : "&aOnce you select a player using your compass, it will auto teleport you to them!"
auto-teleport-disabled : "&cYou will no longer auto teleport to targets!"
have-speed : "&aYou now have Speed %speed%!"
no-longer-speed : "&cYou no longer have any speed effects!"
in-game:
game-started : "&a&lThe game has started!"
you-are-spectator-now : "&7You are spectator now!"
force-start : "&c&lAn admin set waiting time to 0. The game starts now!"
already-force-start : "&cThe game is already starting!"
game-chat-format : "&7%player%: %message%"
game-death-format : "&7[DEAD CHAT] "
fell-into-void : "&7%player% &cdied!\n&e%players_left% players remaining."
last-one-fell-into-void : "&7%player% &cdied!"
cooldown-format : "&6CHARGING &8&l[%progress%&8&l] &6%time%s"
cooldown-progress-format : "&a:&c:■"
premium:
kicked-for-premium-slot : "&c%player% got removed from the game to make a place for premium players!"
you-were-kicked-for-premium-slot : "&cYou got kicked out of the game to make a place for a premium player!"
no-slots-for-premium : "&cThis game is already full of premium players!"
full-game-no-permission : "&cYou don't have the permission to join full games!"
score-actions:
bonus-score : "&6%score% score! %action%"
survive : "Survived 30 seconds"
game-items:
leave-item:
returning-lobby : "&a&lTeleporting you to the lobby in 3 seconds...\n&a&lRight-click again to cancel the teleport!"
teleport-cancelled : "&c&lTeleport cancelled!"
summary-message :
- "%no_center%&a&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
- "&f&lTNT Run"
- ""
- "&e&l1st Place : &f&l%player_1%"
- "&e&l2nd Place : &f&l%player_2%"
- "&e&l3rd Place : &f&l%player_3%"
- ""
- "%no_center%&a&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
summary-message-hover : "&8Remaining Perks\n&7Double Jump: %double_jumps%&7/%max_double_jumps%"

# To hide the bar in a specific arena state, leave the message field empty for that state.
game-bar:
waiting-for-players :
# This is the message displayed when the arena is in waiting for players state.
message : "&e&lPLAYING &f&lTNT Run &e&lby &b&lDespical"
# The color of the bar when waiting for players.
# If a color is not set for this state, the color from the previous state will be used.
color : BLUE
# The style of the bar when waiting for players.
# If a style is not set for this state, the style from the previous state will be used.
style : SOLID
starting :
# This is the message displayed when the arena is in starting state.
message : "&e&lPLAYING &f&lTNT Run &e&lby &b&lDespical"
in-game :
# The game bar won't be visible if the arena is in-game state because the message is empty.
message : ""
ending :
# This is the message displayed when the arena is in ending state.
message : "&e&lPLAYING &f&lTNT Run &e&lby &b&lDespical"

Scoreboard:
Title : " &e&lTNT Run "
# > %75, < %50, EMPTY
Double-Jumps : "&a:&e:&c"
# The timer format.
Timer-Format : "%02d:%02d"
# The date format.
Date-Format : "dd/MM/yy"
Waiting :
- "&7%date%"
- ""
- "&fMap : &a%map%"
- "&fPlayers : &a%players%/%max_players%"
- ""
- "&fStarting in &a%formatted_time% &fif"
- "&fmore players join"
- ""
- "&fGame : &aTNT Run "
- " "
- "&epatreon.com/despical "
Starting:
- "&7 %date%"
- ""
- "Map : &a%map%"
- "Players : &a%players%/%max_players%"
- ""
- "&fStarting in &a%formatted_time% &fto"
- "&fallow time for"
- "&fadditional players"
- ""
- "Game : &aTNT Run "
- " "
- "&epatreon.com/despical "
Playing:
- "&7Duration : %formatted_time%"
- ""
- "&fDouble Jump : %double_jumps%&7/%max_double_jumps%"
- ""
- "&fPlayers Alive : &a%players_left%"
- ""
- "&fCoins Earned : &a%coins_earned%"
- ""
- "&7%date%"
- "&epatreon.com/despical"

spectator-gui:
title : " Spectator Settings"
close-item : "&cClose"
speed-prefix : "&aSpeed "
no-speed : "&aNo Speed"
teleporter:
title : "Teleporter"
skull-name : "&7%player%"
lore :
- "&7Click to teleport!"
auto-teleport-item:
enable : "&aEnable Auto Teleport"
disable : "&cDisable Auto Teleport"
enabled-lore :
- "&7Click to disable auto teleport!"
disabled-lore :
- "&7Click to enable auto teleport!"
night-vision-item:
enable : "&aEnable Night Vision"
disable : "&cDisable Night Vision"
enabled-lore :
- "&7Click to disable night vision!"
disabled-lore :
- "&7Click to enable night vision!"
hide-spectators-item:
enable : "&cHide Spectators"
disable : "&aShow Spectators"
enabled-lore :
- "&7Click to hide other spectators!"
disabled-lore :
- "&7Click to show other spectators!"

signs:
game-states:
waiting : "&lWaiting..."
starting : "&e&lStarting"
playing : "&lIn-game"
full-game : "&c&lFULL"
ending : "&lEnding"
restarting : "&c&lRestarting"
inactive : "&lInactive..."
lines :
- "&4&lTNT Run"
- "%state%"
- "%map_name%"
- "&5[%players%/%max_players%]"

placeholders:
empty-position : "No Player"
empty-value : "NaN"

arena-states:
waiting : "Waiting"
starting : "Starting"
playing : "Playing"
ending : "Ending"
restarting : "Restarting"
inactive : "Inactive"

My Other Plugins: