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 and blocks listed in the blacklist. If no safe location is found after the configured number of attempts, the player receives an error message.
Commands
| Command | Description |
|---|---|
/rtp |
Teleport to a random location in your current world. |
Configuration
RTP settings live under the rtp section in config.yml. Settings can be overridden per-world.
| Key | Type | Default | Description |
|---|---|---|---|
rtp.cooldown |
Seconds | 30 |
Cooldown between RTP uses. |
rtp.warmup |
Seconds | 0 |
Delay before the RTP teleport executes. |
rtp.min-radius |
Integer | 100 |
Minimum distance from world centre (0,0) for random locations. Prevents players from RTPing too close to spawn. |
rtp.max-radius |
Integer | 10000 |
Maximum distance from world centre. Clamped to the world border if set. |
rtp.max-attempts |
Integer | 20 |
How many random locations to try before giving up. |
rtp.biome-blacklist |
List | [ocean, river] |
Biomes to exclude from random selection. |
rtp.block-blacklist |
List | [lava, water] |
Block types that are not considered safe landing surfaces. |
rtp.use-world-border |
Boolean | true |
Respect the world border when picking random locations. |
Per-world overrides are specified as
rtp.worlds.<worldname>.<key>. Any key not specified for a world falls back to the default value.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.rtp |
Use /rtp to teleport to a random location. |
Everyone |
essentialsc.rtp.cooldown.bypass |
Skip the RTP cooldown. | Operators |