DOCS berries.games ↗

Cooldowns & warmup

Cooldowns

A cooldown stops a player using /rtp again too soon. It starts when they land (a cancelled teleport doesn't start one) and is saved to data/cooldowns.yml, so restarts don't reset it.

defaults:
  cooldown: 60          # seconds, 0 = no cooldown

worlds:
  world_nether:
    cooldown: 120       # longer in the nether

Per world or shared

cooldowns:
  mode: world     # each world has its own cooldown
  # mode: global  # one cooldown for every world

With world, a player can RTP in the overworld and then straight away in the nether. With global, any RTP starts the cooldown everywhere.

Shorter cooldowns for ranks

cooldowns:
  permission-prefix: "berryrtp.cooldown."
  ranks:
    vip: 30
    mvp: 15

Give a rank berryrtp.cooldown.vip and its players wait 30 seconds instead of the world's cooldown. If a player has several, the lowest one wins, and it never makes a cooldown longer than the world's own. Add as many ranks as you like.

/lp group vip permission set berryrtp.cooldown.vip true

Skipping cooldowns

berryrtp.bypass.cooldown skips them completely (ops have it by default). /rtp send from an admin also ignores the player's cooldown.

The queue has its own cooldown, queue.cooldown, see the queue page.

Warmup

The warmup is a countdown the player waits through before they're teleported, so nobody can RTP out of a fight.

defaults:
  warmup: 5              # seconds, 0 = instant

rtp:
  cancel-on-move: true
  move-tolerance: 0.5    # blocks
  cancel-on-damage: true
  • Looking around is fine; walking more than move-tolerance blocks cancels it.
  • Getting hurt cancels it.
  • The countdown shows above the hotbar with a tick sound each second (warmup-tick in lang.yml).
  • berryrtp.bypass.warmup skips it (ops have it by default).

Tip: the warmup isn't wasted time. BerryRTP finds the spot and loads the terrain while the player counts down, so the teleport is instant when it hits zero. See speed & performance.