Worlds

Files in the worlds/ directory map an input location - a world name passed as world=<name>, or the player's current world - to a target region. There is one file per world (e.g. worlds/world.yml).

If a world has no config file yet, RTP copies and renames default.yml. Do not delete default.yml.

Brackets signify a placeholder, e.g. [world name] -> world_nether.

Setup

A world file answers one question: when a player runs /rtp from this world (or targets it with world=<name>), which region should be used? Each world points at exactly one default region.

Inspecting worlds

With the rtp.info permission, you can check the settings for any world you have access to:

/rtp info
/rtp info world=[]

Mapping a world to a region

By default every world maps to the default region. Point a world at a different region by editing region in worlds/[world name].yml, or more simply with:

/rtp config worlds [world name] region=[region name]

The region you map to may live in a different world: a region's own world key decides where players actually land, so a world file can redirect /rtp to a region that teleports the player elsewhere. See Regions for creating and configuring regions.

If a world added at runtime is not being recognized, it should be available on the next restart.

Restricting a world

Set requirePermission to true to require rtp.worlds.<worldname> for that world. Players without the node are redirected to the world named in override.

Keys

Key	Default	Purpose
region	default	The region to use for /rtp from this world. Points at a file in regions/.
requirePermission	false	If true, the player needs rtp.worlds.<worldname> to use this world.
override	[0]	World to redirect to when the player lacks permission. [0] = the server's primary world. RTP detects and breaks infinite override loops on a second reference to the same config.
version	1.0	Internal schema version. Do not edit.

Editing

Edit the file on disk and run /rtp reload worlds, or change a key at runtime:

/rtp config worlds <worldname> region=<regionname>