TNTRun_reloaded | TNTRun for 1.13 - 1.16 | 9.6

Bungeecord | MySQL | Multi-Arena | Placeholders | PVP | Kits | Scoreboards | Leaderboards

  1. steve4744
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    TNTRun_reloaded
    Run, run, run....

    2019-06-06_01.20.18.png

    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 supports all Minecraft versions from 1.13 to 1.16.4, while the legacy version (version 6.8.6) is supported for servers running Minecraft versions from 1.8 through to 1.12.2.

    Many of the features will not be present in the legacy version which is 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 double-jumps, splash potions and snowballs (with knockback), an option to enable PVP in an arena, and 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.
    • 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 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 **NEW**
    • Multiple spawn points **NEW**
    • 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
    • Legacy placeholder support - https://www.spigotmc.org/resources/tntrun_reloaded-expansion.53945/
    • MySQL support
    • Bungeecord support **NEW**
    • One player test mode **NEW**

    Video - gameplay
    Thanks to ericbarbwire for creating the following video:




    Dependencies
    For Minecraft 1.13+ the recommended minimum version required for each plugin is listed below:
    FAWE is also supported, and can be used in place of the WorldEdit 7.1.0 dependency.

    For legacy Minecraft 1.12.2 and below:
    • TNTRun_reloaded 6.8.6
    • WorldEdit 6
    • Vault (optional)
    • BarAPI (optional)


    Legacy Support
    For servers running Minecraft 1.13 and later, download the latest release from Spigot here.
    For servers running Minecraft 1.8 - 1.12.2, version 6.8.6 can be downloaded from GitHub.


    If you are running a legacy version, it is recommended that you update to the latest legacy version, 6.8.6.
    Support is available for the latest legacy version 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 ericbarbwire for creating the following guide:



    Thanks to LuxLacis for creating the following guide:




    Video - setup guides (German)

    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.

    2019-06-10_23.28.29.png

    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 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.
    Use WorldEdit or FAWE for selections, the built-in selection system is broken for now.

    Arena 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 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 setP1 - set targetted block as first selection point
    /trsetup setP2 - set targetted block as second selection point
    /trsetup clear - clear selection points​

    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

    Additional Commands

    /trsetup setlobby - set the TNTRun lobby at your current position
    /trsetup deletelobby - delete the TNTRun lobby
    /trsetup setbarcolor {color} - set bar color. Default is RANDOM
    /trsetup addkit {kit} - create a kit
    /trsetup deletekit {kit} - delete a kit
    /trsetup reloadbars - reload configbars.yml
    /trsetup reloadmsg - reload messages.yml
    /trsetup reloadtitles - reload titles.yml
    /trsetup reloadconfig - reload config.yml
    /trsetup addspawn {arena} - creates additional arena spawn points
    /trsetup deletespawnpoints {arena} - removes all additional points created with addspawn
    /trsetup enable {arena} - enable the arena
    /trsetup disable {arena} - disable the arena
    /trsetup delete {arena} - delete the arena​


    Arena Setup Example

    First create your arena. In this picture the arena was created quickly using WorldEdit and left unenclosed to show the various levels which are made up of TNT and Sand.
    You can have any number of levels.
    Leave enough room between the levels for players to jump without hitting the level above. There is a gap of 7 blocks in this example.
    2018-03-02_15.29.27.png

    1. Give the arena a name

    /trsetup create <arena>

    2. Set the boundary of the arena - using WorldEdit, select 2 opposite corners, one above and one below the arena, ensuring the whole of the arena is included within the selection.(http://wiki.sk89q.com/wiki/WorldEdit/Selection)

    /trsetup setarena <arena>

    3. Set the lose level. This is basically the floor beneath the final level of the arena, the level at which the player loses. Use WorldEdit to select 2 points on opposite sides of the arena. The 2 points MUST be within the boundary of the arena from the previous step.

    /trsetup setloselevel <arena>

    4. Set the spawnpoint. Go to the top level of the arena, the spawnpoint will be created at the location you are standing.

    /trsetup setspawn <arena>

    5. Set spectator spawnpoint. The point at which a player spawns after losing (provided the game has not ended).

    /trsetup setspectate <arena>

    6. Finish the arena creation and save it. The arena is automatically enabled.

    /trsetup finish <arena>

    7. Set a main lobby location for all TNTRun arenas (only needs to be done once) at your current location.

    /trsetup setlobby

    Permissions
    Code (Text):
    tntrun.join:
        description: used to control who can join tntrun and from where.
        default: true
    tntrun.setup:
        description: required to run "/trsetup" commands
        default: op
    tntrun.version.check:
        description: display new version message on player join
        default: op
    tntrun.heads:
        description: allow players to use HeadsPlus in game
        default: true
    tntrun.shop:
        description: allow players to buy any shop item (if they have money)
        default: true
    tntrun.joinmenu:
        description: allow players to use the join menu
        default: true
    tntrun.start:
        description: allow players to start an arena before the minimum players is reached
        default: op
    tntrun.spectate:
        description: allow players to join an arena as a spectator
        default: op
    tntrun.listrewards:
        description: allow players to list the arena rewards
        default: true
    tntrun.doublejumps.n:
        description: limit allowed doublejumps using permissions, where n is a positive integer (>= 1)
        default: false

    Installation
    For upgrading, check the release notes for each release.

    1. Download TNTRun_reloaded.jar
    2. Copy to your 'plugins' folder
    3. Restart your server - this will create the default config.yml and other configuration files.

    To migrate from the old devbukkit version of TNTRun, simply remove the old TNTRun from the plugins folder , replacing it with TNTRun_reloaded, start & stop the server, then copy the contents of folder plugins\TNTRun\arenas to plugins\TNTRun_reloaded\arenas and restart the server. The existing TNTRun arenas should then be enabled without the need to recreate them.

    Configuration
    Code (YAML):

    special
    :
       # use bossbar to display arena messages and countdown
       UseBossBar
    : true
       # set the bossbar color, or have random colors
       BossBarColor
    : RANDOM
       # use splash titles for join/leave
       UseTitle
    : true
       # use scoreboard to display in-game stats
       UseScoreboard
    : true
       # use permission node to limit double jumps
       UseDoubleJumpPermissions
    : false
       # enable metrics (bStats)
       Metrics
    : true
       # check for new version of TNTRun_reloaded on Spigot
       CheckForNewVersion
    : true
    # Use player's rank in chat messages
    UseRankInChat
    :
       enabled
    : false
       usegroup
    : true
       useprefix
    : false
    shop
    :
       name
    : '&6&lTNTRun &f&lSHOP'
       size
    : 27
       doublejump
    :
          maxdoublejumps
    : 10
       # log every shop purchase to console
       logpurchases
    : false
       # remove player's purchase if player leaves before game starts
       onleave
    :
          removepurchase
    : false
       # item to use to show player's monetary balance in shop
       showmoneyitem
    : GOLD_INGOT
    # give players free doublejumps when arena starts
    freedoublejumps
    :
       enabled
    : false
       amount
    : 10
    # run server commands on win
    commandsonwin
    :
    - say {PLAYER} won TNTRun
    - say Congratulations...
    # set duration (seconds) for fireworks on win (max=4)
    fireworksonwin
    :
       enabled
    : true
       duration
    : 4
    # broadcast win to whom:
    # 2 = server, 1 = only arena players, 0 = no broadcast message
    broadcastwinlevel
    : 2
    # configure arena join menu
    menu
    :
       item
    : TNT
       panecolor
    : LIGHT_BLUE
       includedisabled
    : false
    # configure sounds
    sounds
    :
      arenastart
    :
         enabled
    : true
         sound
    : ENTITY_PLAYER_LEVELUP
         volume
    : 10
         pitch
    : 1.0
      itemselect
    :
         enabled
    : true
         sound
    : UI_BUTTON_CLICK
         volume
    : 1
         pitch
    : 1.0
      blockbreak
    :
         enabled
    : true
         sound
    : BLOCK_SAND_BREAK
         volume
    : 5
         pitch
    : 1.0
    # if enabled, all players in arena teleport to arena spawn when countdown = 5 seconds
    anticamping
    :
       enabled
    : true
    # set max entries displayed by leaderboard command
    leaderboard
    :
      maxentries = 10
    # set GUI items while waiting for arena start
    items
    :
       vote
    :
          use
    : true
          material
    : DIAMOND
          name
    : '&2&lVOTE'
          slot
    : 0
       info
    :
          use
    : true
          material
    : EMERALD
          name
    : '&2&lINFO'
          slot
    : 1
       shop
    :
          use
    : true
          material
    : NETHER_STAR
          name
    : '&2&lSHOP'
          slot
    : 2
       stats
    :
          use
    : true
          material
    : PLAYER_HEAD
          name
    : '&2&lSTATS'
          slot
    : 3
       heads
    :
          use
    : true
          material
    : GLOWSTONE_DUST
          name
    : '&e&lHEADSPLUS'
          slot
    : 4
       leave
    :
          use
    : true
          material
    : GREEN_BED
          name
    : '&2&lLEAVE'
          slot
    : 8
    # set scoreboard text
    scoreboard
    :
       header
    : '&6&lTNTRUN'
       displaydoublejumps
    : false
       waiting
    :
      - '&fWelcome to TNTRun'
       - '&a '
       - '&fArena
    : &6&l{ARENA}'
       - '&b '
       - '&fPlayers
    : &a&l{PS}&7&l/&c&l{MPS}'
       - '&c '
       - '&fVotes required
    : &a&l{VOTES}'
       - '&d'
       - '&fStarting in
    : &6&l{COUNT}'
       playing
    :
      - '&fPlaying TNTRun'
       - '&fon arena
    : &6&l{ARENA}'
       - '&b '
       - '&fPlayers
    : &a&l{PS}&7&l/&c&l{MPS}'
       - '&c '
       - '&fLost Players
    : &a&l{LOST}'
       - '&2 '
       - '&fEnd in
    : &c&l{LIMIT}'
    # set database to 'file' or 'sql'
    database
    : file
    MySQL
    :
       host
    : host
       port
    : 12345
       name
    : tntrun
       table
    : stats
       user
    : root
       pass
    : password
       useSSL
    : false
    # set sign text
    signs
    :
       prefix
    : '&6&lTNTRun'
       join
    : '[Join]'
       status
    :
          disabled
    : '&cDisabled'
          ingame
    : '&c&l{PS}&8/&c&l{MPS}'
          regenerating
    : '&6&lRegen...'
          waiting
    : '&a&l{PS}&8/&a&l{MPS}'
    # bungeecord settings
    bungeecord
    :
      enabled
    : false
      hub
    : lobby
      useMOTD
    : true
      stopserver
    : false
    # currency symbols to apply to monetary messages
    currency
    :
      prefix
    : ''
      suffix
    : ' coins'
    # specify language file to use
    language
    : en-GB
    # set to true to log more verbose messages to console
    debug
    : false

    Scoreboard Configuration
    There are 2 scoreboards, one while the players are waiting for the game to start, and one when the game is in progress. Both can be configured/translated in the config.yml file.

    Setting displaydoublejumps to true will add a scoreboard entry displaying the number of doublejumps the player has remaining.

    The text and colour codes can be changed, but not the placeholders such as {ARENA}, {PS} and {VOTES}.

    From version 9.0, standard PlaceholderAPI placeholders can also be used in the scoreboard - see example below.
    Code (YAML):
    # set scoreboard text
    scoreboard
    :
      # Scoreboard Title
       header
    : '&6&lTNTRUN'
       displaydoublejumps
    : true
       # Waiting scoreboard config
       waiting
    :
      - '&fWelcome to TNTRun'                  # title message
       - '&a '
       - '&fArena
    : &6&l{ARENA}'                # arena name
       - '&b '
       - '&fPlayers
    : &a&l{PS}&7&l/&c&l{MPS}'   # players in arena and max players
       - '&c '
       - '&fVotes required
    : &a&l{VOTES}'       # number of required to force-start arena
       - '&d'
       - '&fStarting in
    : &6&l{COUNT}'          # countdown to game start
       - '&e '
       - '&fDouble Jumps
    : &6&l{DJ}'            # number of doublejumps remaining
       - '&f '
       - '&fMoney
    : %vault_eco_balance%'        # Example placeholder displaying player's balance
       # Playing scoreboard config
       playing
    :
      - '&fPlaying TNTRun'
       - '&fon arena
    : &6&l{ARENA}'             # Scoreboard title with arena name
       - '&b '
       - '&fPlayers
    : &a&l{PS}&7&l/&c&l{MPS}'   # players still active and max players
       - '&c '
       - '&fLost Players
    : &a&l{LOST}'          # count of players that have lost
       - '&d '
       - '&fEnd in
    : &c&l{LIMIT}'               # seconds remaining before game ends
       - '&e '
       - '&fDouble Jumps
    : &6&l{DJ}'            # number of doublejumps remaining
     


    Kits
    A kit is a set of items, weapons, food and potions that can be allocated to players at the start of a game.
    A kit is created with command /trsetup addkit [kitname]

    The addkit command adds all the items in your inventory including armour and active potion effects to the kit.
    Kits are enabled on a per arena basis using command /trsetup enablekits [arena]
    Players joining an arena (with kits enabled) will be allocated a random kit from those that have been created. If there is only one kit, everyone will receive the same kit.

    The list of available kits can be displayed with command /tr listkits
    The contents of a kit can be displayed with command /tr listkit [kitname]
    A kit can be deleted with command /trsetup deletekit [kitname]

    Item slot 9 in the hotbar will always be the configured 'leave' item for the arena.


    Heads
    An optional feature is to allow players to purchase different heads to wear during the game. To enable this feature you will need to have the plugin HeadsPlus by Thatsmusic99 installed on your server.

    During the arena countdown, players can use a hotbar item to open the HeadsPlus interface and purchase a head to wear during the game. The head is automatically equipped on the player's head when purchased, and removed at the end of the game.

    Players will need permission node tntrun.heads: true to be able to use this feature.

    The price for each head is set in plugins\HeadsPlus\headsx.yml. The default price is 10.0 and is set in the same file, so if you want all heads to be free just change the default price to 0.0.

    2019-06-10_23.10.06.png


    Arena Join Menu
    The arena join menu allows TNTRun_reloaded arenas to be selected from an inventory menu. This can be disabled by disallowing permission tntrun.joinmenu.

    The list of arenas can be limited to only show enabled arenas in the config.yml.

    The clickable items (TNT by default) and the coloured tiles can be changed in the config.yml file. The menu heading and other text can be changed in the messages.yml file.
    Code (YAML):
    menutitle: '&1TNTRun_reloaded Arenas'
    menuarenaname
    : '&a{ARENA}'
    menutext
    : '&5Players: &6{PS}/{MPS}'
    menufee
    : '&5Join Fee: &6{FEE}'
    menupvp
    : '&5PVP: &6Enabled'
    trmenu.png


    Double-Jumps
    There is an option (disabled by default) to give players a set number of double-jumps at the begining of each game.
    Code (YAML):
    freedoublejumps:
      enabled
    : false
      amount
    : 10
    This avoids the need to purchase double-jumps in the shop. If the free double-jumps option is enabled, then players can still purchase double-jumps in the shop (up to the maximum allowed), but these are stored and not used until the free double-jumps option is disabled. Unlike the shop bought double-jumps, the number of free double-jumps are reset at the start of each game.

    The number of double-jumps a player can receive can also be limited using a permission node, tntrun.doublejumps.n, where n is a positive integer (>=1).

    A player with permission tntrun.doublejumps.6 will be able to receive or buy a maximum of 6 double-jumps, provided the maximum amount allowed in the config is at least 6.


    Shop Setup
    Items to be purchased in-game can be defined in the shop.yml file. The configuration below is the default shop configuration created when the plugin is installed. The description and prices can can be amended, items can removed completely or new items added provided they follow the existing convention.

    By default, the permission node tntrun.shop is set to true, allowing players to purchase any shop item, provided they have the money to purchase it. Alternatively, each shop item can have its own permission node set (in shop.yml) which a player will need to have in order to purchase that item.

    Potions and Splash Potions have a duration and amplifier which can be set using the syntax:
    <potion effect>#<duration>#<amplifier>

    Setting the amplifier is optional in which case the default value of 1 will apply.

    Snowballs have a custom knockback effect. This can be set from 0 (no knockback) to 5 (large knockback). The default is 2.

    Items can be bought while waiting in the arena or during the arena countdown, and are given to the player immediately the game starts. Only one shop item can be purchased per game.

    Optionally purchases can be removed when the player leaves the arena before the game starts using the config.yml option:
    Code (YAML):
    shop:
      onleave
    :
          removepurchase
    : true
    The amount of money a player currently has is displayed using the item in the final slot of the shop GUI. The GOLD_INGOT can be changed to any other item in the config.

    shop balance.png

    This is the default shop for the current release of Spigot/Minecraft. For older versions, some items may need to be removed for the shop to function. For example, SNOWBALLS and SPLASH_POTIONS will not work on Spigot/Minecraft 1.8.

    Code (Text):

    '1':
      name: '&fDouble Jump'
      cost: 100
      material: FEATHER
      amount: 1
      permission: tntrun.shop.default
      lore:
      - Double Jump
      - Cost&6 100 &5coins
      items:
        '1':
          material: ''
          amount: 1
          displayname: '&cDouble jump'
          lore:
          - Basic kit - double jump
          enchantments:
          - 'null'
    '2':
      name: '&fSwordsman'
      cost: 250
      material: IRON_SWORD
      amount: 1
      permission: tntrun.shop.2
      lore:
      - Sword + Knockback#1
      - Cost&6 250 &5coins
      items:
        '1':
          material: IRON_SWORD
          amount: 1
          displayname: '&cSword + Knockback1'
          lore:
          - Sword + Knockback#1
          enchantments:
          - KNOCKBACK#1
    '3':
      name: '&fProtection Plus'
      cost: 300
      material: GOLDEN_CHESTPLATE
      amount: 1
      permission: tntrun.shop.3
      lore:
      - Chestplate + Thorns#1
      - Cost&6 300 &5coins
      items:
        '1':
          material: GOLDEN_CHESTPLATE
          amount: 1
          displayname: '&cChestplate + Thorns1'
          lore:
          - Chestplate + Thorns#1
          enchantments:
          - THORNS#1
    '4':
      name: '&fSword and Helmet'
      cost: 300
      material: GOLDEN_SWORD
      amount: 1
      permission: tntrun.shop.4
      lore:
      - Golden Sword and Helmet
      - Cost&6 300 &5coins
      items:
        '1':
          material: GOLDEN_SWORD
          amount: 1
          displayname: '&cGolden Sword'
          lore:
          - Golden Sword
          enchantments:
          - null
        '2':
          material: GOLDEN_HELMET
          amount: 1
          displayname: '&cGolden Helmet'
          lore:
          - Golden Helmet
          enchantments:
          - PROTECTION#1
    '5':
      name: '&fSnowballs x 20'
      cost: 50
      material: SNOWBALL
      amount: 20
      permission: tntrun.shop.5
      lore:
      - Snowballs + Knockback2
      - Cost&6 50 &5coins
      items:
        '1':
          material: SNOWBALL
          amount: 20
          displayname: '&cSnowballs'
          lore:
          - Snowballs
          enchantments:
          - KNOCKBACK#2
    '6':
      name: '&fSpeed Potion'
      cost: 50
      material: POTION
      amount: 1
      permission: tntrun.shop.6
      lore:
      - Add&6 SPEED &5(1:00)
      - Cost&6 50 &5coins
      items:
        '1':
          material: POTION
          amount: 1
          enchantments:
          - SPEED#60#1
    '7':
      name: '&fJump Potion'
      cost: 50
      material: POTION
      amount: 1
      permission: tntrun.shop.7
      lore:
      - Add&6 JUMP &5boost (0:45)
      - Cost&6 50 &5coins
      items:
        '1':
          material: POTION
          amount: 1
          enchantments:
          - JUMP#45#1
    '8':
      name: '&fNight Vision Potion'
      cost: 50
      material: POTION
      amount: 1
      permission: tntrun.shop.8
      lore:
      - Add&6 NIGHT_VISION &5(2:00)
      - Cost&6 50 &5coins
      items:
        '1':
          material: POTION
          amount: 1
          enchantments:
          - NIGHT_VISION#120#1
    '9':
      name: '&fInvisibility Potion'
      cost: 50
      material: POTION
      amount: 1
      permission: tntrun.shop.9
      lore:
      - Add&6 INVISIBILITY &5(1:00)
      - Cost&6 50 &5coins
      items:
        '1':
          material: POTION
          amount: 1
          enchantments:
          - INVISIBILITY#60#1
    '10':
      name: '&fSplash Potion of Slowness'
      cost: 50
      material: SPLASH_POTION
      amount: 1
      permission: tntrun.shop.10
      lore:
      - Add&6 SLOWNESS &5(0:30)
      - Cost&6 50 &5coins
      items:
        '1':
          material: SPLASH_POTION
          amount: 1
          displayname: '&cSplash Potion of Slowness'
          lore:
          - Slowness
          enchantments:
          - SLOW#30#1
    '11':
      name: '&fSplash Potion of Confusion'
      cost: 50
      material: SPLASH_POTION
      amount: 1
      permission: tntrun.shop.11
      lore:
      - Add&6 CONFUSION &5(0:30)
      - Cost&6 50 &5coins
      items:
        '1':
          material: SPLASH_POTION
          amount: 1
          displayname: '&cSplash Potion of Confusion'
          lore:
          - Confusion
          enchantments:
          - CONFUSION#30#1
    '12':
      name: '&fSplash Potion of Blindness'
      cost: 50
      material: SPLASH_POTION
      amount: 1
      permission: tntrun.shop.12
      lore:
      - Add&6 BLINDNESS &5(1:30)
      - Cost&6 100 &5coins
      items:
        '1':
          material: SPLASH_POTION
          amount: 1
          displayname: '&cSplash Potion of Blindness'
          lore:
          - Blindness
          enchantments:
          - BLINDNESS#90#1
     


    Placeholders
    All the placeholders listed below work with the current version and also the legacy version 6.8.6. The old expansion pack, which can still be downloaded from 'PAPI ecloud', is redundant and should no longer be used.

    Code (Text):
    %tntrun_played%                                : number of TNTRun games played
    %tntrun_wins%                                  : number of TNTRun games won
    %tntrun_losses%                                : number of TNTRun games lost
    %tntrun_version%                               : version number of plugin
    %tntrun_arena_count%                           : number of TNTRun arenas
    %tntrun_pvp_arena_count%                       : number of PVP TNTRun arenas
    %tntrun_nopvp_arena_count%                     : number of non-PVP TNTRun arenas
    %tntrun_player_count%                          : number of players currently playing TNTRun
    %tntrun_pvp_player_count%                      : number of players currently playing PVP TNTRun
    %tntrun_nopvp_player_count%                    : number of players currently playing non-PVP TNTRun
    %tntrun_player_count_<arena>%                  : number of players currently playing arena
    %tntrun_status_<arena>%                        : current status of arena
    %tntrun_joinfee_<arena>%                       : fee required to join arena
    %tntrun_currency_<arena>%                      : currency item required to join arena
    %tntrun_doublejumps%                           : number of doublejumps the player has
    %tntrun_leaderboard_wins_player_<position>%    : player at position in "wins" leaderboard
    %tntrun_leaderboard_wins_score_<position>%     : number of wins at position in "wins" leaderboard
    %tntrun_leaderboard_losses_player_<position>%  : player at position in "losses" leaderboard
    %tntrun_leaderboard_losses_score_<position>%   : number of losses at position in "losses" leaderboard
    %tntrun_leaderboard_played_player_<position>%  : player at position in "played" leaderboard
    %tntrun_leaderboard_played_score_<position>%   : number of games played at position in "played" leaderboard
     
    Creating holograms using the placeholders

    This can be done using HolographicDisplays together with the HolographicExtension plugin. You also need to download ProtocolLib if you don't already have it.

    For example, you can create a hologram from a placeholder for the player with the most wins by using placeholder %tntrun_leaderboard_wins_player_1%.
    Code (Text):
      /hd create TNTRun_Leader {slowest}%tntrun_leaderboard_wins_player_1%
    To create a Holographic Leaderboard for TNTRun_reloaded

    First create a hologram for the TNTRun leaderboard:
    Code (Text):
      /hd create TNTRun_Wins TNTRun Leaderboard
    Add a line for each position you want on the leaderboard
    Code (Text):
      /hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_1% &f: &c%tntrun_leaderboard_wins_score_1%
      /hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_2% &f: &c%tntrun_leaderboard_wins_score_2%
      /hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_3% &f: &c%tntrun_leaderboard_wins_score_3%
    The leaderboard will refresh automatically at the rate defined by the Holographic Extension plugin.

    This is an example of what HolographicDisplay's database.yml may look like with a TNTRun_reloaded leaderboard of player wins.
    Code (YAML):
    TNTRun_Wins:
      location
    : world, -392.766, 69.283, 162.659
      lines
    :
      - '&6&lTNTRun_reloaded Wins'
      - '{slowest} &6%tntrun_leaderboard_wins_player_1% &f: &c%tntrun_leaderboard_wins_score_1%'
      - '{slowest} &6%tntrun_leaderboard_wins_player_2% &f: &c%tntrun_leaderboard_wins_score_2%'
      - '{slowest} &6%tntrun_leaderboard_wins_player_3% &f: &c%tntrun_leaderboard_wins_score_3%'


    Signs
    Each sign is created as in the picture below. The Join sign colours are configurable in config.yml, and the arena name colour can be set when creating the sign, e.g. &farena1 will create the name in white instead of the default black text.

    The Leaderboard sign colours and text can be set in messages.yml. The Leaderboard sign will automatically refresh at the end of each game.

    The leave and vote signs have largely been superceded by using inventory items but can still be used if required.

    The lobby and autojoin signs were added in version 8.7.

    2019-12-19_15.37.03.png signs212.png


    Custom Events
    Custom events have been added in version 8.6 allowing developers to hook into TNTRun_reloaded.
    The current list of events are:
    • PlayerJoinArenaEvent
    • PlayerLeaveArenaEvent
    • PlayerWinArenaEvent
    • PlayerSpectateArenaEvent
    Each custom event will give you the player object and also the arena.
    Code (Java):
    @EventHandler
    public void onPlayerJoinArena(PlayerJoinArenaEvent event) {

        Player player = event.getPlayer();
        String arena = event.getArena().getArenaName();

        getLogger().info("TNTRun_reloaded: Player " + player.getName() + " has joined arena " + arena.getArenaName())
    }


    Metrics
    This plugin uses bStats to collect anonymous plugin metrics. The data is collected once every 30mins and is submitted asynchronously to the bStats server. The plugin doesn't collect any custom data, just the default bStats data which is listed on bstats.org. The metrics class is also open source and can be viewed here, or in this plugin's source code on GitHub (see below).

    Metrics can of course be disabled on your server but I would appreciate it if it was left enabled as the information it provides gives me an idea of how many servers are using the plugin, what versions are in use, etc. and is an incentive for me to put more of my time into development of the plugin.

    Data from the plugin can be viewed here:
    https://bstats.org/plugin/bukkit/TNTRun_reloaded

    [​IMG]


    Issues and source code
    Join our Discord server to make it easier to discuss issues and share information.

    [​IMG]

    The source code is on GitHub.
    Any issues or suggestions can be raised on the Issues tab in the GitHub repository, by clicking the big Discord banner above, in the Discussions tab, or even send me a PM.

    Please don't use the review section to ask for help. If something's not working, then you've probably configured it wrongly. Its just not possible to diagnose and resolve a problem in the review space, and the "review" you leave helps no-one.
    lokka30, QuikMiner, vy_vu and 2 others like this.

Recent Updates

  1. Version 9.6 update
  2. Version 9.5.2 update
  3. Version 9.5.1 update

Recent Reviews

  1. ItsMCB
    ItsMCB
    5/5,
    Version: 9.6
    This is an excellent TNT Run plugin! The developer consistently updates it and implements good suggestions. Thank you for maintaining this plugin and keeping it free <3
  2. Usernameorig
    Usernameorig
    3/5,
    Version: 9.5.2
    Excellent plugin, but you need the / trsetup reloadstats command since to delete the statistics of a player, I have to close the entire server and that is not useful at all.
  3. elpibee
    elpibee
    5/5,
    Version: 9.5.2
    ==========================================================
    Just an awesome plugin, never had problems with it. Recommend 100%
    ==========================================================
    1. steve4744
      Author's Response
      Thank you for the review.
  4. Disgustadoh
    Disgustadoh
    5/5,
    Version: 9.3
    Permission to use the signs?,Good plugin I use to play with friends and it's great.
    1. steve4744
      Author's Response
      Thanks for the review.
      There is no permission to use signs. If you still need help, ask on discord or the discussion tab.
  5. Kdriiq
    Kdriiq
    5/5,
    Version: 9.3
    Excellent work, I must say that I loved it.

    Isn't there a way for players in arenas to take damage from enemy mobs? Or when entering an arena, keep their items in inventory.

    The plugin is very good, I admit it, sorry for my English.
    1. steve4744
      Author's Response
      Thank you for the review.
      If damage is enabled, yes. No, but kits can be created.
  6. Mikavon
    Mikavon
    5/5,
    Version: 9.3
    Just got it on my server, works perfectly, one of the best tnt run plugins out there for 1.16
    1. steve4744
      Author's Response
      Thank you for the review.
  7. mrfloris
    mrfloris
    5/5,
    Version: 9.3
    If you are looking for a TNT Run plugin for Paper or Spigot 1.16.1 this is the one to go with. It is fast, easy to setup, supports custom arenas, and it's actively developed unlike the others. I've been using it for a while and really enjoying this game. Support has been thumbsup as well.
    1. steve4744
      Author's Response
      Thank you for the review.
  8. luiSICH_2
    luiSICH_2
    5/5,
    Version: 9.2
    THE PLUGIN IS THE BEST!!!!!!!!!! Amazing I Love TNTRun but I couldn't find any plugins to do it so this plugin saved my life
    1. steve4744
      Author's Response
      Thank you for the review.
  9. Bigg_Daddyy
    Bigg_Daddyy
    5/5,
    Version: 9.2
    Amazing like always from our good friend Steve that knows what hes doing ;)

    Keep up the awesome work ;)
    1. steve4744
      Author's Response
      Thanks for the review :)
  10. Junior007
    Junior007
    5/5,
    Version: 8.9
    Very good, free plugins,and fast support.
    5 stars !
    1. steve4744
      Author's Response
      Thank you for the review.