DOCS berries.games ↗

Installation

Install

  1. Download BerryRTP.jar from BuiltByBit.
  2. Put it in your server's plugins/ folder.
  3. Restart the server (don't use /reload).
  4. Join and run /rtp.

On first start BerryRTP creates its folder:

plugins/BerryRTP/
├── config.yml        commands, permissions, worlds, cooldowns, queue, performance
├── lang.yml          every message
├── menus/
│   ├── rtp.yml       the /rtp world picker
│   └── queue.yml     the /rtpqueue menu
└── data/
    ├── cooldowns.yml    saved cooldowns
    └── ready-spots.yml  safe spots found ahead of time (a few hundred bytes)

First things to set

Open config.yml and check the worlds: section. The keys are your world folder names. The defaults are world, world_nether and world_the_end, which is what a normal Paper server uses.

worlds:
  world:
    display-name: "&a&lOverworld"
  world_nether:
    display-name: "&c&lNether"
    min-radius: 100
    max-radius: 2000

Then pick how far out players land (min-radius / max-radius) and the cooldown. Run /rtp reload to apply.

My worlds have different names

Rename the keys under worlds: to match your folders, and update the world: lines and [rtp] ... actions in menus/rtp.yml (and menus/queue.yml if you use the queue). Worlds that aren't listed under worlds: don't have RTP.

worlds:
  survival:
    display-name: "&a&lSurvival"
  survival_nether:
    display-name: "&c&lNether"

Updating

Replace the jar and restart. Your config files are never overwritten.

  • New settings and messages are added to your files automatically, with their comments. Nothing you changed is touched, and your old file is kept as config.old.yml / lang.old.yml.
  • New default menus only appear if you delete plugins/BerryRTP/menus/ so they can be created again.

Heads up: changing command names, aliases or permission nodes needs a full restart. Everything else applies with /rtp reload.