Commands

All RTP features are subcommands of /rtp (alias /wild). Parameters are passed in key=value form and can be combined freely. Multiple values for one parameter are comma-separated (key=a,b,c). Tab-completion is available for every parameter and reflects live server state.

Syntax note: the parameter separator is = (e.g. region=mining). The older : separator is no longer accepted - a bare region:mining token is treated as an unknown subcommand. A : is still allowed inside a value, e.g. a namespaced biome id biome=minecraft:badlands.

A more exhaustive reference lives in docs/admin/COMMANDS.md. This page is the quick overview.

/rtp

Randomly teleport.

• world=[world] - teleport within a world's default region
• region=[region] - teleport within a specific region
• player=[player] - teleport a different (online) player
• biome=[biome] - restrict the destination to one or more biomes (comma-separate for multiple, e.g. biome=PLAINS,FOREST)
• shape=[shape] / vert=[vert] - override the region's shape/vertical adjustor for this one teleport (requires rtp.params)
• worldBorderOverride=[true|false] - use the server world border as the shape for this teleport
• toggletargetperms=[true|false] - evaluate cooldown/delay/economy against the target instead of the sender

Parameter teleports build a temporary, single-use region from an existing one, so they search from scratch and bypass the cache. Prefer pre-configured regions for everyday /rtp.

/rtp menu

Open the interactive, click-driven menu (front page for players, admin panel for operators). See the Menu page.

/rtp help

See the clickable, permission-filtered list of subcommands the sender can use.

/rtp reload [config]

Reload all configuration files, or a single file/group by name (e.g. reload regions, reload performance). Allow a moment for settings to propagate.

/rtp config = [...]

Read and write configuration keys at runtime. Each write is atomic and the affected file is reloaded automatically, so /rtp reload is only needed after hand-edits on disk. Supports view, list add=/remove= operators, and a --dry-run flag. (Replaces the older /rtp update.)

/rtp scan [start|resume|pause|cancel|reset] [region=[region]]

Pre-scan a region to build its persistent spatial memory (the bad-location map), so future teleports skip known-unsafe coordinates. A bare /rtp scan resumes (or starts) a scan. Runs asynchronously and never blocks the main thread. (Replaces the older /rtp fill.)

Because learned data becomes useless if region settings change, run scans only after region configuration is finalized.

/rtp info [world=[world]|region=[region]]

Show loaded worlds, permanent regions, queue statistics, and learned-state summaries.

/rtp version (alias /rtp about)

Show plugin and server identity.

/rtp test stress player=[player] [iterations=N] [intervalTicks=T] [region=[region]]

Operator self-test: drive a player repeatedly through the real /rtp pipeline.