DOCS berries.games ↗

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 from blocked-biomes.
  • Wrong End settings. The main End island is surrounded by void; keep min-radius around 1,200 and center: "0,0".
  • A custom world generator. Set biome-precheck: false for that world.
  • Lots of claims or players nearby. Claims and avoid-players rule spots out too; lower avoid-players or 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.