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.