Shop and cosmetics

Coins or Vault money, particle trails, and double jumps for TNT Run.

3 min read 557 words

Players earn currency by playing and spend it on particle trails and double jumps.

Open the shop with /tt shop or the emerald in the lobby hotbar. Everything here lives in shop.yml. Run /tt reload after editing it.

Currency

Pick one with economy.type:

Type What it uses
coins Built-in coins saved in the plugin database (SQLite or MySQL). No other plugins needed.
vault The server's money through Vault. Needs Vault and an economy plugin such as EssentialsX.

If vault is set but Vault or an economy plugin is missing, the plugin warns in the console and uses coins instead.

economy:
  type: coins
  coin-name: 'coins'
  starting-coins: 0

Earning

Every player still in the game when it ends gets the play reward. The winner also gets the win reward.

rewards:
  win: 50
  play: 10

Players who leave before the end get nothing.

Admin commands

/tt coins [player]                        Show a balance
/tt coins give <player> <amount>
/tt coins take <player> <amount>
/tt coins set <player> <amount>           Coins only, use your economy plugin with Vault

Trails

Particles that follow a player while they move during a game. A player buys a trail once, then selects or removes it in the trails menu. Only one trail is active at a time.

trail-settings:
  show-in-lobby: false

trails:
  flame:
    name: '&6Flame Trail'
    material: BLAZE_POWDER
    particle: FLAME
    amount: 2
    price: 250
  gold-dust:
    name: '&#FFD700Gold Dust Trail'
    material: GOLD_NUGGET
    particle: REDSTONE
    color: '255,200,0'
    amount: 3
    price: 750
    permission: 'tntgames.trail.gold'
Field Meaning
name Display name in the menu.
material Menu icon.
particle Any Bukkit particle name. REDSTONE also reads color: R,G,B.
amount Particles per step.
price Cost. 0 makes the trail free for everyone.
permission Optional. Players without it see the trail as locked.

Six trails ship by default: flame, hearts, music notes, magic, gold dust, and souls.

Double jumps

Double jumps are for TNT Run. Players buy them in packs and keep them stored. At the start of every TNT Run game each player gets up to max-per-game of their stored jumps. To jump, press space twice in the air. A feather in the hotbar shows how many are left.

Only jumps that are actually used are taken from the stored amount, so unused ones carry over to the next game. Landing after a double jump never causes fall damage.

double-jump:
  enabled: true
  max-per-game: 3
  max-owned: 50
  item-slot: 4
  forward-power: 1.1
  upward-power: 0.9
  cooldown-seconds: 1
  packs:
    small:
      amount: 1
      price: 100
    medium:
      amount: 5
      price: 450
    large:
      amount: 10
      price: 800

The feather powerup also hands out extra double jumps. Those are used first and only last for that game. See Powerups.

Shop item

The emerald given in the lobby:

shop-item:
  enabled: true
  slot: 0
  material: EMERALD
  name: '&a&lShop &7(Right Click)'

Keep slot different from the selector slot in config.yml.

Storage

Coins, stored double jumps, owned trails, and the selected trail are saved in the player_shop table of the same database as stats. See Storage.