DOCS berries.games ↗

Configuration

Everything about how and where players land is in config.yml. Messages are in lang.yml and menus in menus/. Run /rtp reload after editing.

How the file is organised

Section What's in it
commands Command names, aliases, descriptions, sub-command words (commands)
permissions Permission nodes and who gets them (permissions)
rtp How /rtp behaves: menu or not, warmup cancelling
cooldowns Per-world or shared cooldowns, rank cooldowns (cooldowns)
protection, combat, economy Claims, fights and costs (claims, combat & economy)
defaults Settings every world starts with
worlds Your worlds, each changing anything from defaults
queue The RTP queue (queue)
performance Background work and debug logging (speed & performance)

Defaults and worlds

Every world starts with the settings under defaults: and can change any of them. Only write what's different:

defaults:
  min-radius: 300
  max-radius: 5000
  cooldown: 60

worlds:
  world:
    display-name: "&a&lOverworld"        # uses everything from defaults
  world_nether:
    display-name: "&c&lNether"
    max-radius: 2000                      # only this is different

/rtp

Setting Default What it does
open-menu true /rtp opens the menu named by menu. false teleports in the player's current world.
menu rtp Which file in menus/ to open
default-world world Used when the menu is off and RTP is off in the player's world
cancel-on-move true Moving during the warmup cancels it
move-tolerance 0.5 How many blocks counts as moving. Looking around never cancels.
cancel-on-damage true Taking damage during the warmup cancels it
warmup-update-ticks 20 How often the countdown message updates (20 ticks = 1 second)
search-during-warmup true Find the spot while the player counts down

Where players land

Setting Default What it does
enabled true Turn RTP off for a world
display-name world name Used as <world> in messages and menus
permission "" Extra permission needed for this world (empty = none)
min-radius / max-radius 300 / 5000 Players land between these distances from the center
center spawn spawn or "x,z", e.g. "0,0"
shape circle circle or square
respect-world-border true Never land outside the border
avoid-players 50 Never land within this many blocks of another player (0 = off)
cost 0 Price per /rtp when economy is on
max-attempts 30 Random spots tried before "Couldn't find a safe spot"
y-offset 0 Land this many blocks above the ground

Spots are spread evenly over the whole area, so players aren't bunched up near the center.

Finding the ground

Setting Default What it does
search-mode auto highest: the top block (normal worlds). scan: search upwards between min-y and max-y (worlds with a roof). auto: scan in worlds with a roof like the nether, highest everywhere else.
min-y / max-y auto Height limits. In highest mode, spots outside them are skipped. auto = the world's bottom / just under its roof.

Safety

A spot is only used if the player has solid ground under them and room for their feet and head, with nothing harmful in the way. It also has to be outside every claim and away from other players.

Setting What it does
unsafe-ground Never stand on these (lava, magma, cactus, campfires, dripstone, bedrock, powder snow)
unsafe-body Never have these at feet or head height (fire, berry bushes, wither roses, cobwebs...)
avoid-water Never land in water or on water plants
water-blocks What counts as water
blocked-biomes Never land in these biomes (oceans and rivers by default)
biome-precheck Skip blocked biomes before generating any terrain. Much faster. Turn off only for custom world generators.

Block and biome names are the in-game IDs, e.g. magma_block or deep_ocean, with or without minecraft:.

After landing

after-teleport runs actions right after a player lands. They're the same actions menus use:

defaults:
  after-teleport:
    - "[effect] SLOW_FALLING 3 0"
    - "[message] &aWelcome to the wild!"
    - "[console] give <player> bread 4"

<player>, <world>, <x>, <y> and <z> are filled in. See menus for every action.

The End

The default End settings land players on the outer islands (1,200 to 4,000 blocks from 0,0) and block the the_end and small_end_islands biomes, so nobody lands on the dragon's island or falls into the void.

Full default config.yml

The file itself has a comment above every setting. Delete it and restart to get a fresh copy.