Skip to content

World Configuration Reference (definitions/worlds/*.yml)

A world file is routing, not tuning. Each file in the definitions/worlds/ folder answers one question: when a player runs /rtp from this world (or targets it with world=<name>), which region answers? The filename (without .yml) must match the world name.

Everything about where and how the player lands belongs to the region, not to the world: the destination world, the distance (radius / centerRadius), the shape, the vertical window, the price, the biome rules. That split is deliberate. A world can point at any region, several worlds can share one region, and a single world can be served by several regions (permission tiers via requirePermission / override, or an explicit region=<name> on the command). A radius attached to the world could express none of that.

So to change teleport distance, edit the region this world points at - see Region Size: radius and centerRadius - or point the world at a different region.

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.

If a world has no config file yet, RTP creates one based on definitions/worlds/default.yml - do not delete default.yml. A world added at runtime that is not recognized will be available on the next restart.


Updating Settings

When /rtp or /rtp world=<worldname> teleports players to the overworld instead of <worldname>, it is because unconfigured worlds fall back to region: "default" (which targets the overworld). Rather than changing default.yml to always send players to another dimension, create a region for that world in definitions/regions/<region>.yml (with its own world, shape, and vert settings) and map definitions/worlds/<worldname>.yml to it through: 1. Browser map workspace (/rtp editor): Open /rtp editor, create or select the region for that world, and set the world's region mapping (Web Editor Guide). 2. Guided setup or admin menu (/rtp admin setup / /rtp admin): Run /rtp admin setup (choose multi worlds), or /rtp admin -> click Worlds. 3. Command line: Use /rtp config worlds <worldname> region=<region> (e.g. /rtp config worlds world_nether region=nether). 4. Direct editing: Edit definitions/worlds/<world>.yml and definitions/regions/<region>.yml on disk and run /rtp reload.

📎 See IN_GAME_CONFIG.md for full menu and command navigation details.

With the rtp.info permission, inspect a world's settings with /rtp info or /rtp info world=<name>.


Settings

Key Type Default Description
region String "default" The default region used when a player runs /rtp while in this world.
requirePermission Boolean / String false If true, players need the rtp.worlds.<worldname> permission to use RTP in this world. Can also be set to "@config" to inherit from config.yml.
override String "[0]" The world to redirect to if a player lacks permission for this world. Supports [0], [1], [2] placeholders.

Versioning

  • version: Internal config version (do not change).