DOCS berries.games ↗

RTP queue

The queue drops players who are waiting onto the same random spot, ready to fight. It's made for 1v1s but works for any group size.

How it works

  1. A player joins a world's queue with /rtpqueue (menu) or /rtpqueue join <world>.
  2. While waiting they see In queue: Overworld · 1/2 above the hotbar.
  3. When the queue is full, everyone in it gets Match found! vs Steve with a title and sound.
  4. A countdown runs (5 seconds by default). BerryRTP finds the spot during it.
  5. Everyone is teleported to the same spot at once.

If someone in the match logs out (or moves, if you turn that on), the match is called off and everyone else goes back to the front of the queue.

Settings

queue:
  enabled: true
  open-menu: true          # /rtpqueue opens menus/queue.yml
  menu: queue
  worlds: [world, world_nether, world_the_end]
  size: 2                  # players per match
  sizes: { world_nether: 4 }   # a bigger match size in one world
  countdown: 5
  cancel-countdown-on-move: false
  cooldown: 0              # seconds before queueing again after a match
  spread: 0                # 0 = same block, higher = own spot within this many blocks
  leave-on-world-change: true
  actionbar-ticks: 20      # 0 = no "In queue" action bar
  broadcast-join: true     # announce to everyone when someone queues (clickable JOIN)
  broadcast-to-self: true  # the player who joined sees it too
  broadcast-cooldown-seconds: 30  # each player's joins are announced at most this often
  after-teleport: []       # actions after the match lands

Queue worlds must also be set up under worlds: in the config; they use that world's radius, safety rules and after-teleport, then the queue's own after-teleport.

Good to know

  • A player can only be in one queue. Joining another moves them.
  • Clicking the world they're already queued for in the menu leaves the queue.
  • The match spot comes from the same ready-spot stock as /rtp, so matches teleport instantly too.
  • Queue cooldowns are separate from /rtp cooldowns. berryrtp.bypass.cooldown skips both.

Example: a 2v2 arena in the nether

queue:
  worlds: [world, world_nether]
  sizes: { world_nether: 4 }
  broadcast-join: true
  after-teleport:
    - "[effect] RESISTANCE 5 4"
    - "[message] &cFight!"