FAQ & troubleshooting
I don't see the countdown, and there's no cooldown
You're probably an op. Ops have berryrtp.bypass.warmup and berryrtp.bypass.cooldown by default. Test on a normal account, or remove them from yourself:
/lp user YourName permission set berryrtp.bypass.warmup false
/lp user YourName permission set berryrtp.bypass.cooldown false
"You're in combat!"
The built-in PvP tag blocks /rtp for 10 seconds after a player hits or is hit by another player. Change combat.pvp-tag-seconds (0 turns it off) or give berryrtp.bypass.combat.
"Couldn't find a safe spot"
BerryRTP tried max-attempts random spots and none were safe. Usually:
- The area is too small or mostly blocked (e.g. a small border in an ocean-heavy world). Raise
max-radius, or remove biomes fromblocked-biomes. - Wrong End settings. The main End island is surrounded by void; keep
min-radiusaround 1,200 andcenter: "0,0". - A custom world generator. Set
biome-precheck: falsefor that world. - Lots of claims or players nearby. Claims and
avoid-playersrule spots out too; loweravoid-playersor widen the radius.
Raising max-attempts helps too (it only costs time when spots keep failing).
Teleports are slow right after a restart
The ready-spot stock is refilled at startup, one spot at a time. Until it's full, a teleport may need to search fresh, which the warmup usually hides. See speed & performance.
Players land in places I don't like
Add the biome to blocked-biomes (e.g. swamp, mangrove_swamp, snowy_plains), or the block to unsafe-ground, then /rtp reload. For the nether, min-y and max-y limit the height range.
I changed a menu but nothing happened
Run /rtp reload. If you updated BerryRTP and expected the new default menus, delete plugins/BerryRTP/menus/ and restart.
I renamed a command and it didn't change
Command names, aliases and permission nodes need a full server restart.
My worlds have different names
Rename the keys under worlds: in config.yml to your world folder names, and the world: and [rtp] ... lines in your menus. See installation.
A menu item or sound doesn't appear
Check the console after /rtp reload. BerryRTP warns about unknown materials, unknown sounds, menu items without a slot, and bad world settings, and tells you which file and item.
Does it work with Spigot?
No. BerryRTP needs Paper or a Paper fork (Purpur, Pufferfish...) or Folia, because it relies on Paper's async chunk loading to stay lag-free.
Still stuck?
Open a Product Support ticket on our Discord. Include your BerryRTP version, your server software and version, and anything BerryRTP printed in the console.