Random Teleport
Teleport players to random safe locations across your worlds.
Overview
The Random Teleport (RTP) system finds a safe location within configurable radius limits, respecting world borders and biome blacklists. It's useful for survival-style spawn systems, exploration, or spreading players out across a large world.
The RTP manager searches for a safe block (solid ground with air above) within the configured range, avoiding biomes listed in the biome blacklist and staying within the configured Y bounds. If no safe location is found after the configured number of attempts, the player receives an error message.
Commands
| Command | Description |
|---|---|
/rtp |
Open the RTP world picker. Click a world in the GUI to teleport to a random location in it. |
Configuration
RTP settings live under the rtp section in config.yml. Settings can be overridden per-world.
| Key | Type | Default | Description |
|---|---|---|---|
rtp.enabled |
Boolean | true |
Completely disable RTP, including the /rtp command. |
rtp.register-command |
Boolean | true |
Unregister the /rtp command while keeping the RTP system active internally. |
rtp.cooldown |
Seconds | 60 |
Cooldown between RTP uses. |
rtp.warmup |
Seconds | 5 |
Delay before the RTP teleport executes. |
rtp.cancel-on-movement |
Boolean | true |
Cancel the teleport if the player moves during the warmup. |
rtp.particles |
Boolean | true |
Play particles during the warmup. |
rtp.max-attempts |
Integer | 10 |
How many random locations to try before giving up. |
rtp.min-y |
Integer | 35 |
Minimum Y level a player can be teleported to. |
rtp.max-y |
Integer | 122 |
Maximum Y level a player can be teleported to. |
rtp.use-world-border |
Boolean | true |
Respect the world border when picking random locations. |
rtp.global.min-radius |
Integer | 1000 |
Minimum distance from world centre (0,0) for random locations. |
rtp.global.max-radius |
Integer | 10000 |
Maximum distance from world centre. Clamped to the world border if set. |
rtp.global.blocked-biomes |
List | ocean, deep_ocean, river |
Biomes to exclude from random selection. |
rtp.worlds.<world>.* |
Section | — | Per-world overrides with enabled, display-name, min-radius, max-radius, and blocked-biomes. |
Any world not listed under
rtp.worlds falls back to the rtp.global defaults. Set enabled: false on a world entry to block RTP in that world entirely. Shipped defaults configure the overworld, nether, and end.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.rtp |
Use /rtp to teleport to a random location. |
Everyone |
essentialsc.rtp.bypass.cooldown |
Skip the RTP cooldown. | Operators |
essentialsc.rtp.bypass.warmup |
Skip the RTP warmup. | Operators |
essentialsc.rtp.bypass.movement |
Not cancelled by movement during the warmup. | Operators |
essentialsc.rtp.world.* |
Use RTP in all worlds. | Operators |
essentialsc.rtp.world.world / .nether |
Use RTP in the default overworld (world) and nether (world_nether) respectively. |
Everyone |
essentialsc.rtp.world.end |
Use RTP in the end. | Nobody |