Configuration

The configuration file for Nexal TNT Run. Located at plugins/Nexal TNT Run/config.yml.

config.yml

# =========================================
#         TNT Run Configuration
# =========================================
# Every setting is re-read when the file changes; no restart needed, except for storage,
# which is read at startup.

# Storage settings
storage:
  # Storage type: "json" or "sql"
  type: "json"

  # SQL settings (only used if type is "sql")
  sql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: ""

# Defaults for newly created arenas. Each arena keeps its own copy, which you change
# with /tntrun admin (arena > Settings) or the admin commands.
game:
  # Lobby countdown in seconds once the minimum player count is reached
  lobby-countdown: 30

  # Maximum game duration in seconds. 0 = no limit: the game runs until one player is left.
  # With a limit, when time runs out the players still standing take the top places, ranked
  # by the number of blocks they broke.
  game-duration: 0

  # Delay in ticks before a stepped-on block disappears (20 ticks = 1 second)
  block-disappear-delay: 8

  # Player limits
  min-players: 4
  max-players: 24

  # Blocks that disappear when stepped on
  collapsible-blocks:
    - "SAND"
    - "TNT"
    - "RED_SAND"
    - "GRAVEL"

  # How many games of the same arena may run at once. Each one is a fresh copy of the
  # arena schematic, so a full or running game never stops others from playing.
  max-concurrent-games-per-arena: 5

  # Seconds a lobby with nobody in it stays open before it is closed
  empty-lobby-timeout: 120

# Double jump defaults for newly created arenas
double-jump:
  enabled: true
  # Cooldown in ticks (20 ticks = 1 second)
  cooldown: 100
  # Upward velocity of the jump
  power: 0.8
  # The sound is set in messages.yml (double-jump-used)

# Effects when a block disappears
effects:
  particle:
    enabled: true
    # A particle that takes block data: BLOCK (1.20.5+) or BLOCK_CRACK (older servers)
    type: "BLOCK"
    count: 20

  sound:
    enabled: true
    type: "BLOCK_SAND_BREAK"
    volume: 0.5
    pitch: 1.0

# Arena cloning
arena:
  # The world every game's copy of the arena is pasted into. Created as an empty void
  # world on first use. Existing arenas without a world of their own use this one.
  target-world: "tntrun_arenas"

# Rewards for the top three places, paid when a game ends (a game stopped by an admin pays
# none). A player who leaves a running game (/tntrun leave, disconnect or kick) is out at
# that moment and gets the reward for that place at the end; if they are offline or in
# another game by then, the reward commands run when they next join.
rewards:
  enabled: true

  # Money paid through Vault (needs Vault and an economy plugin). 0 = none.
  money:
    1: 1000
    2: 500
    3: 250

  # Console commands per place. Placeholders: %player%, %position%, %arena%, %blocks%
  # An arena with reward commands of its own (/tntrun admin addcmd) uses those instead.
  default:
    1:
      - "give %player% diamond 5"
    2:
      - "give %player% iron_ingot 10"
    3:
      - "give %player% gold_ingot 5"

# Fireworks around the winner
fireworks:
  enabled: true
  count: 5
  # Ticks between fireworks
  delay-ticks: 10

# Scheduled games: an arena with a schedule (/tntrun admin setschedule) opens a lobby at the
# scheduled times and announces it to the server. Turn this off to pause every schedule.
scheduling:
  enabled: true

# Command blocking during games
# Players in active games can only use /tntrun leave (and admin commands for admins)
# Add additional allowed commands to this whitelist (without the /)
command-whitelist: []
# Example:
# command-whitelist:
#   - "msg"
#   - "r"
#   - "tell"

Configuration Options

Below is a reference of the main configuration sections:

storage

========================================= TNT Run Configuration

Every setting is re-read when the file changes; no restart needed, except for storage, which is read at startup.

Storage settings

game

Defaults for newly created arenas. Each arena keeps its own copy, which you change with /tntrun admin (arena > Settings) or the admin commands.

double-jump

Double jump defaults for newly created arenas

effects

arena

Arena cloning

rewards

Rewards for the top three places, paid when a game ends (a game stopped by an admin pays none). A player who leaves a running game (/tntrun leave, disconnect or kick) is out at that moment and gets the reward for that place at the end; if they are offline or in another game by then, the reward commands run when they next join.

fireworks

Fireworks around the winner

scheduling

Scheduled games: an arena with a schedule (/tntrun admin setschedule) opens a lobby at the scheduled times and announces it to the server. Turn this off to pause every schedule.

command-whitelist

Command blocking during games Players in active games can only use /tntrun leave (and admin commands for admins) Add additional allowed commands to this whitelist (without the /)