TNTRun_reloaded | TNTRun for 1.13 - 1.16 | 9.3

A fork of the original Shevchik TNTRun, updated and improved for the latest MC releases

  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.1, while the legacy version (version 6.8) 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.2
    • WorldEdit 6
    • Vault (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.2 can be downloaded from GitHub.


    All versions are available to download from the "Version History" tab. I'll still support older versions where possible, but all future code changes and bug fixes will be applied to the latest 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 - 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 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 is 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 Material, XP and Command rewards for arena
    /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.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
    : REDSTONE
          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

    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'
    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
    These placeholders are new in version 8.3, and do not need the TNTRun_reloaded expansion pack. Older versions of the plugin require the correct version of the expansion pack for the placeholders to work (see here for details).

    Note that the %tntrun_leaderboard_x% placeholders will only work with version 8.3 - 8.9.
    The fee, currency and doublejumps placeholders are avaiable from version 8.8+.
    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_player_count%                          : number of players currently playing 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.3 update
  2. Version 9.2 update
  3. Version 9.1 update

Recent Reviews

  1. 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.
  2. 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 :)
  3. 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.
  4. Cosmo_Gamer
    Cosmo_Gamer
    4/5,
    Version: 8.9
    Nice plugin but for me it is so that after every restart a few settings are different and the signs no longer change
  5. Blurkeon
    Blurkeon
    5/5,
    Version: 8.9
    Es increible el soporte que el Developer da a los usuarios, un plugin muy simple, un plugin muy completo 5 stars :D ♥
    1. steve4744
      Author's Response
      Gracias. Thanks for the review.
  6. smoukyt7
    smoukyt7
    5/5,
    Version: 8.9
    Muy buen plugin y sobre todo muy buen soporte del developer! Arreglo todos mis problemas.
    1. steve4744
      Author's Response
      Gracias. Thanks for the review.
  7. JustReddy
    JustReddy
    4/5,
    Version: 8.9
    Good Plugin tbh, but i get a Stupid Error when i try to set the arena bounds. :(
    1. steve4744
      Author's Response
      The arena has to be setup correctly for the plugin to work. The errors are telling you that its not. If you need help setting it up, just ask in the discussion section or on discord.
  8. LonlyGamerX
    LonlyGamerX
    5/5,
    Version: 8.9
    love this plugin, very nicely made. Only 1 thing missing, a test command of sort to let players try solo on the tnt run to see if everything works 100%
    1. steve4744
      Author's Response
      Thank you for the review.
      A one player test mode is actually a good idea - I'll add that in the next release.
  9. Frusby
    Frusby
    5/5,
    Version: 8.8
    nice plugin bro, estoy fascinado. Lo unico que faltaria es algo que muestre las variables para poner en la scoreboard
    1. steve4744
      Author's Response
      Thanks for the review. The scoreboard can be configured/translated in the config.yml. I'll add something to the plugin overview page - thanks for the suggestion.
  10. cadafinn100
    cadafinn100
    5/5,
    Version: 8.7
    hello creators of the TNT run reload plugin I want to give you a suggestion please update the plugin and give some changes in version 1.8 since users like them more than the recent version please update and improve the errors contained in 1.8 items do not appear in the arena it does not load custom sign and nor does it load the menu and errors with the command / setarena I just ask you to give more changes for 1.8 it is very good plugin for the minigame and I would very much appreciate it if you read it thanks
    1. steve4744
      Author's Response
      Thanks for the review.