TNTRun_reloaded - TNTRun for 1.13+ 7.7

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

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

    2018-11-10_14.28.02.png

    Description

    TNTRun_reloaded was originally forked from the (now unsupported) TNTRun by Shevchik (for Minecraft pre-1.9) and has been improved and updated as new versions of Minecraft have been released, so that it supports all Minecraft versions from 1.8 through to 1.13.2.

    TNTRun is a fully automated minigame plugin that is based on the popular map TNTRUN. For those who don't know what it is, here is an explanation.

    Players start on a layer of sand and every block that they step on disappears. If a player falls through a hole, he will continue to run on the layer below. When a player falls through the final layer he loses the game. The last player wins the game.

    Minecraft 1.13 and legacy support
    As a result of all the many changes introduced in Minecraft 1.13, version 6.8.1 of TNTRun_reloaded is the final release to support all Minecraft versions from 1.8 through to 1.12.2.

    Starting with version 7.0 of TNTRun_reloaded, the plugin will only run on Minecraft versions 1.13 and later.

    For servers running Minecraft 1.13 and above, download the latest release from Spigot here.
    For servers running Minecraft 1.8 - 1.12.2, version 6.8.1 can be downloaded from GitHub.


    Version 6.8 is also available to download from the "Version History" tab and also from GitHub. I'll still support older versions where possible, but all future code changes and bug fixes will be applied to version 7.0.

    Dependencies for Minecraft 1.13+
    WorldEdit 7.0.0 (minimum build Beta 2)
    Vault 1.7.1 (optional)
    HeadsPlus by ThatsMusic99 (optional)

    Dependencies for Minecraft 1.12.2 and below
    WorldEdit 6
    Vault (optional)

    Features
    • Supports multiple arenas
    • Automatic arena regeneration
    • Configurable block destroy delay
    • Force-start voting system
    • 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 **NEW**
    • Signs
    • Configurable per-arena time limit
    • Configurable per-arena countdown
    • Configurable sounds **NEW**
    • In-game scoreboard
    • Titles and bossbars
    • Spectator system
    • Player stats
    • Leader board
    • Auto updating leader board sign **NEW**
    • Arena leave checker
    • Customizable shop
    • PVP can be enabled/disabled per arena
    • Player rewards
    • Placeholder support - https://www.spigotmc.org/resources/tntrun_reloaded-expansion.53945/

    Setup Tutorial

    Thanks to LuxLacis for creating the following video:



    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 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 info - information about this plugin
    /tr help - lists all the /tr commands
    /tr cmds - lists all the /trsetup commands​

    The following admin commands require tntrun.setup permission.
    Use WorldEdit for selections, the built-in selection system is broken for now.

    Arena Creation Commands

    /trsetup create {arena} - creates an arena with the given name
    /trsetup setarena {arena} - sets the bounds of the arena (if player leaves arena bounds while in game, he automatically loses)
    /trsetup setloselevel {arena} - set looselevel bounds (must be within the arena bounds)
    /trsetup setspawn {arena} - set the arena spawnpoint at location where you are standing
    /trsetup setspectate {arena} - sets the spectator spawnpoint for when player loses
    /trsetup finish {arena} - finish arena creation, save it and enable it
    /trsetup help - lists the above arena creation commands​

    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 time limit for arena (default: 300)
    /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} {on/off/zero} - sets pvp state in the arena (on - full damage, zero - zero damage, off - no attack at all)
    /trsetup delspectate {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 setreward {arena} - start conversation to set Material, XP and Command rewards for arena​

    Additional Commands

    /trsetup setlobby - sets the TNTRun lobby at your current position
    /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 enable {arena} - enable the arena
    /trsetup disable {arena} - disable the arena
    /trsetup delete {arena} - delete the arena​

    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 reloadconfig - reload config.yml
    trconsole reloadbars - reload configbars.yml
    trconsole reloadmsg - reload messages.yml
    trconsole leaderboard - display leader board

    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

    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 (Text):
    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 - only works for spigot/craftbukkit 1.8.3 or higher
       UseTitle: true
       # use scoreboard to display in-game stats
       UseScoreboard: true
       # enable metrics (bStats)
       Metrics: true
       # check for new version of TNTRun_reloaded on Spigot
       CheckForNewVersion: true
    shop:
       name: '&6&lTNTRun &f&lSHOP'
       size: 27
       doublejump:
          maxdoublejumps: 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 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'
       info:
          use: true
          material: EMERALD
          name: '&2&lINFO'
       shop:
          use: true
          material: NETHER_STAR
          name: '&2&lSHOP'
       stats:
          use: true
          material: REDSTONE
          name: '&2&lSTATS'
       leave:
          material: GREEN_BED
          name: '&2&lLEAVE'
       heads:
          use: true
          material: GLOWSTONE_DUST
          name: '&e&lHEADSPLUS'
    # set scoreboard text
    scoreboard:
       header: '&6&lTNTRUN'
       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
       user: root
       pass: password
    # set sign text
    signs:
       prefix: '&6&lTNTRun'
       status:
          disabled: '&cDisabled'
          ingame: '&c&l{PS}&8/&c&l{MPS}'
          regenerating: '&6&lRegen...'
          waiting: '&a&l{PS}&8/&a&l{MPS}'

    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 **NEW**
    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.


    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.

    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.

    The lines starting with '#' are comments and not required in the file.
    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: '&fPotion'
      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
    '7':
      name: '&fPotion'
      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
    '8':
      name: '&fPotion'
      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
    '9':
      name: '&fPotion'
      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
    '10':
      name: '&fSplash Potion'
      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
    '11':
      name: '&fSplash Potion'
      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
    '12':
      name: '&fSplash Potion'
      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
     

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

    join.png leave.png vote.png lb sign.png

    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


    Issues and source code

    I've created a new 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.

Recent Updates

  1. Version 7.7 update
  2. Version 7.6 update
  3. Version 7.5.1 update

Recent Reviews

  1. eickmung
    eickmung
    5/5,
    Version: 7.7
    Great TNT Run Plugin. It is amazing tnt run plugin. that's good plugin. im using minigame server!
    1. steve4744
      Author's Response
      Thanks for the great review.
  2. anemul
    anemul
    5/5,
    Version: 7.7
    Great plugin , absolutely awesome that it is available . Dev is responsive and friendly over on Discord . Thanks for this .
    1. steve4744
      Author's Response
      Thanks for the great review.
  3. QuikMiner
    QuikMiner
    5/5,
    Version: 7.6
    Yes. It WORKS! I got it to work by removing some plugins found out a custom one was interfering. Nice job on the recode
    1. steve4744
      Author's Response
      Thank you for the review.
  4. Worsan
    Worsan
    5/5,
    Version: 7.5
    *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-

    Best TNTRun plugin I've ever seen :)

    *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
    1. steve4744
      Author's Response
      Thanks for the great review!
  5. NightGamingTV
    NightGamingTV
    5/5,
    Version: 7.5
    SOOO nice man i love it so create and then i dont must pay for it sooo nice work dude thank you <3
    1. steve4744
      Author's Response
      Thanks for the review. Glad you like it.
  6. FelixDeC
    FelixDeC
    5/5,
    Version: 7.1
    Love the plugin!
    Where can i find an item list for the shop? Is there only a double jump?
    1. steve4744
      Author's Response
      Thanks for the review.
      The idea with the shop is that you add your own items or kits, the double-jump being an example. I'll add something on the plugin page to explain better how to do it with some examples.
  7. vy_vu
    vy_vu
    5/5,
    Version: 6.8
    great!
    please add 1.13
    ..........................................................................................................................................................................................................................................................
    1. steve4744
      Author's Response
      Thanks for the review. See discussion #43 for MC 1.13.
  8. skyherobrine
    skyherobrine
    5/5,
    Version: 6.8
    Good plugins, can you show yourself how players can enter the room by clicking the board? They can not enter the room by the table
    1. steve4744
      Author's Response
      Thanks for the review. This is probably due to the spawn-protection settings in server.properties. You have a PM with more info.
  9. RobZen
    RobZen
    5/5,
    Version: 6.8
    High quality plugin, works great on 1.8.8. Active developer who is very kind and reacts/fixes very fast. Very helpful dude who answers in the middle of the night! <3 Keep it up, man!
    1. steve4744
      Author's Response
      Thanks for the review.
  10. Nightmare1998
    Nightmare1998
    5/5,
    Version: 6.7.1
    Great plugin !!! Fast, no delay, easy to set up.
    There is a small idea to add "night vision" at will (sometimes the map is just dark ;D ). And, can you add BungeeCord mode ?
    1. steve4744
      Author's Response
      Thank you for the review and the suggestions.