TNTRun_reloaded

Minimum Java Version:
________Java 21

The latest version of this plugin requires a minimum Java version of 21 with Minecraft/Spigot 1.21.3+

Version 9.29 should be downloaded for servers running Minecraft/Spigot 1.21 - 1.21.2

Version 9.29.1 should be downloaded for servers running Minecraft/Spigot 1.20.6

TNTRun_reloaded

Run, run, run....

Description

TNTRun is a highly configurable, fully automated minigame. Traditionally players start on a layer of sand supported by TNT blocks, although any combination of blocks can be used, and every block that they step on disappears. If a player falls through a hole, he/she will continue to run on the layer below. Once a player falls through the final layer he/she loses the game and becomes a spectator for the remainder of the game. The last player remaining wins the game.

TNTRun_reloaded was created in 2016 from the unsupported TNTRun by Shevchik for Minecraft v1.10, and has been improved and updated as new versions of Minecraft have been released. The latest version of TNTRun_reloaded requires Java 21 and supports Minecraft versions 1.21.3 to 26.1.2.

Some of the features will not be present in the older versions which are maintained and supported on an 'as is' basis, and will only be updated if a bug is reported or an existing feature breaks.

The plugin features a customisable shop where players can buy items such as weapons, armour, double-jumps, splash potions, snowballs (with knockback) and commands which run when the game starts. There is an option to enable PVP in arenas, assign kits, and the plugin also interfaces with HeadsPlus (by ThatsMusic99) allowing players to buy/wear custom heads during the game.

Optionally, a fee can be set to join each arena, which can be monetary or any minecraft item such gold_nuggets. Rewards for winning the game can be set to any combination of coins, materials, XP or a command based reward. Scoreboards, leaderboards, placeholders and holograms are fully supported (see the Dependencies section below).

Features

The following list of features applies to the latest release and so not all features will be present in the legacy version or other older versions of the plugin.

Spoiler: Features

• Supports multiple arenas
• Automatic arena regeneration
• Configurable block destroy delay
• Force-start voting system
• Force-start command with permission
• Custom Events
• Join fee can be set per arena
• Join fee currency can be money or Minecraft material
• Configurable anti-camping system
• Custom messages
• Formatting codes and RGB/Hex colour support
• Full tab completion based on permissions
• Kits - can be enabled per arena
• Heads - interfaces with HeadsPlus plugin
• Signs
• Configurable per-arena time limit
• Configurable per-arena countdown
• Configurable sounds
• Customisable arena join menu
• Autojoin command to join first available arena
• In-game scoreboard
• Titles and bossbars
• Spectator system
• Option to join as spectator only
• Multiple spawn points
• Built-in party system
• Support for AlessioDP Parties
• Player stats
• Leader board
• Auto updating leader board sign
• Arena leave checker
• Customizable shop
• PVP can be enabled/disabled per arena
• Player rewards
• Built-in placeholder support
• MySQL support
• Bungeecord support
• One player test mode
• Localization support via Crowdin

Video - gameplay

Thanks to
@ericbarbwire for creating the following video:

Dependencies

Spoiler: Plugin Dependencies

The latest version of TNTRun_reloaded has been tested with the following versions of these plugins:

• WorldEdit 7.3.9 (optional, can use internal selection commands)
• Vault 1.7 (optional, required to use economy)
• HeadsPlus 7.2.0 (optional, allows players to buy different heads to run wear during the game)
• PlaceholderAPI 2.12.2 (optional, required to use placeholders)
• mcMMO 2.2.048 (optional, if you already have mcMMO you can allow players in same mcMMO party to PVP in the arena)
• DecentHolograms 2.8.8 (optional, an example plugin required to create holograms)
• Parties 3.2.16 (optional, can be used in place of internal parties)

If you are interested in recording the amount of time players spend playing TNTRun_reloaded, with the option to reward players in-game for surviving a set amount of time:

TNTRun Timed Rewards (optional add-on for recording time played in arena, and rewarding survival time)

Gradient and Rainbow colour effects are supported in the scoreboard configuration and in the messages file. The plugin uses IridiumColorAPI to achieve this. Examples of syntax are in the
config.yml and also supplied in the link below.

IridiumColorAPI

For legacy Minecraft 1.12.2 and below:

• TNTRun_reloaded 6.8.9
• WorldEdit 6
• Vault (optional)
• BarAPI (optional)

Legacy Support

If your server is running Minecraft 1.21 - 1.21.2, then download version 9.29 from Spigot here.

If your server is running Minecraft 1.20.6, then download version 9.29.1 from GitHub here.

If your server is running a minimum of Java 17 with Minecraft 1.17.1 - 1.20.4, then download version 9.27 from Spigot here.

If your server is running Java 16 with Minecraft 1.16.5 or 1.17.1, you should download version 9.23.1 from Spigot here.

For servers running Minecraft 1.13.2 to 1.16.5 with a Java version < 16, download version 9.11 from Spigot here.

For servers running Minecraft 1.8 - 1.12.2, version 6.8.9 can be downloaded from GitHub here.

If you are running a legacy version 6.8.*, it is recommended that you update to the latest legacy version, 6.8.9.

Some support is available for the older versions in terms of help and bug fixes, but all future code changes and new features will be applied to the current release.

Video - setup guides

Thanks to
@SoulStriker_ for creating the following Showcase Video guide:

Note that in the following video guides, setting the lose level is no longer done by selecting 2 points as explained in these guides. You simply stand inside the arena bounds at the Y-level required and run the setloselevel command.

Thanks to
@ericbarbwire for creating the following guide:

Thanks to
@LuxLacis for creating the following guide:

Video - setup guides (German)

Note that setting the lose level is no longer done by selecting 2 points as explained in this guide. You simply stand inside the arena bounds at the Y-level required and run the setloselevel command.

Thanks to @SpigotFAQ for creating the following guide:

Video - setup guides (Bungeecord)

Thanks to @LonlyGamerX™ for the following Bungeecord setup guide:

Commands

The commands required to create a standard arena are shown below.

Player Commands

/tr list - list the TNTRun arenas

/tr list {arena} - list the arena configuration

/tr join {arena} - join arena, needs tntrun.join permission (default)

/tr join - open arena join menu, needs tntrun.joinmenu permission (default)

/tr autojoin {pvp|nopvp} - join arena with most waiting players

/tr party {option} - TNTRun party commands

/tr leave - leave the current TNTRun arena

/tr vote - vote for the TNTRun arena start

/tr lobby - teleport to the TNTRun lobby

/tr stats - displays your TNTRun record

/tr leaderboard {size} - displays the TNTRun leaderboard

/tr listkit - list the TNTRun kits

/tr listkit {kit} - list the kit configuration

/tr start {arena} - force-start arena, needs tntrun.start permission

/tr spectate {arena} - join as spectator, needs tntrun.spectate

/tr listrewards {arena} - list arena rewards, needs tntrun.listrewards

/tr info - information about this plugin

/tr help - lists all the /tr commands

/tr cmds - lists all the /trsetup commands

The following admin commands require the
tntrun.setup
permission.

Arena Configuration Commands

/trsetup configure {arena} - open menu to run configuration commands

/trsetup setmaxplayers {arena} {number} - set max players for this arena (default: 15)

/trsetup setminplayers {arena} {number} - set min players for this arena (default: 2)

/trsetup settimelimit {arena} {seconds} - set the arena time limit in seconds (default: 300, no_time_limit: 0)

/trsetup setcountdown {arena} {seconds} - set countdown time for arena (default: 10)

/trsetup setmoneyreward {arena} {amount} - sets a money reward (Vault and economy plugins required for this)

/trsetup setteleport {arena} {previous/lobby} - teleports the player to pre-join location or to lobby when game ends

/trsetup setdamage {arena} {yes/no/zero} - sets pvp state in the arena (yes - full damage, zero - zero damage, no - no attack at all)

/trsetup deletespectate {arena} - deletes spectator spawnpoint

/trsetup setgameleveldestroydelay {arena} {ticks} - add a delay before a block is destroyed after a player steps on it (default: 8)

/trsetup setregenerationdelay {arena} {ticks} - set the time allowed for arena regeneration before players can rejoin (default: 60)

/trsetup setvotepercent {arena} {0<votepercent<1} - set the percentage of votes required to start the game for this arena (default: 0.75)

/trsetup givedoublejumps {player} {amount} - give doublejumps to a player

/trsetup setfee {arena} {amount} - set a fee to join the arena

/trsetup setcurrency {arena} {currency_item} - set the currency item

/trsetup setreward {arena} - start conversation to set Money, Material, XP and Command rewards for arena

/trsetup addtowhitelist {command} - whitelist a command for use in-game

/trsetup linkkit {arena} {kit} - links the named kit to an arena

/trsetup unlinkkit {arena} - removes a linked kit from an arena

/trsetup setP1 - set targeted block as first selection point

/trsetup setP2 - set targeted block as second selection point

/trsetup clear - clear selection points

Console Commands

Spoiler: Console Commands

trconsole help - help for console commands

trconsole info - plugin info

trconsole list - list TNTRun_reloaded arenas

trconsole enable {arena} - enable the arena

trconsole disable {arena} - disable the arena

trconsole start {arena} - force-start the arena

trconsole reloadconfig - reload config.yml

trconsole reloadbars - reload configbars.yml

trconsole reloadmsg - reload messages.yml

trconsole leaderboard - display leader board

trconsole join {arena} {player} - join player in arena

trconsole spectate {arena} {player} - join player in arena as spectator

trconsole autojoin [pvp|nopvp] {player} - autojoin player in arena

trconsole givedoublejumps {player} {amount} - give doublejumps to a player

trconsole forcejoin {arena} - force all online players into an arena

Additional Commands

/trsetup setlobby - set the TNTRun lobby at your current position

/trsetup deletelobby - del