Skip to content

CustomRTP Command Reference

Jump to bottom
Jonathan edited this page May 19, 2026 · 1 revision

CustomRTP Command Reference

The /customrtp command allows administrators, players, and console executors to randomly teleport players using either standard configurations or custom mathematical boundaries.

Command Syntax

Depending on the number of arguments provided, the command executes in one of three distinct modes:

1. Standard RTP

Teleports a player randomly within their current world using default configuration settings.

/customrtp <player>

2. Standard Cross-World RTP

Teleports a player randomly within a specific world using default configuration settings.

/customrtp <player> <world>

3. Fully Custom RTP

Requires all 6 base arguments to define a specific search area. Optional parameter flags can be appended to customize behavior.

/customrtp <player> <world> <startRadius> <endRadius> <originX> <originZ> [params...]

Note: The %player% placeholder can be used in place of the <player> argument when the command is executed by an in-game player to target themselves.

Optional Parameters

When utilizing the Fully Custom RTP mode, you can append optional parameters to the end of the command. Parameters use the key:value syntax format.

Target Height Boundaries

  • y-min:<number> (Default: 60) - The minimum Y-coordinate allowed for a landing location.
  • y-max:<number> (Default: 120) - The maximum Y-coordinate allowed for a landing location.

Search Settings

  • tries:<number> (Default: 25) - The maximum number of attempts the algorithm will make to find a safe location before failing.
  • shape:CIRCLE - Restricts the random selection area to a circle around the origin.
  • shape:SQUARE - Restricts the random selection area to a square bounding box around the origin.

Scanning Strategies

Defines how the algorithm scans the Y-axis to find a safe solid block.

  • strategy:AUTO
  • strategy:HIGHEST_BLOCK
  • strategy:BOTTOM_UP
  • strategy:TOP_DOWN

Feature Toggles

  • **feedback:true / feedback:false**
  • **cooldown:true / cooldown:false**
  • `movetimer:true / movetimer:false
  • **spawnpoint:true / spawnpoint:false**

Examples

Standard Target Execution

/customrtp Player2

Target World Redirect

/customrtp Player2 world_nether

Complex Custom Boundary Execution

Teleports player Player2 within event_world, centered at X:1000, Z:1000, using a bounding search radius between 0 and 500 blocks. Restricts the height search between Y levels 60 and 120, forces a square boundary, and bypasses cooldown checks:

/customrtp Player2 event_world 0 500 1000 1000 y-min:60 y-max:120 shape:SQUARE cooldown:false

Clone this wiki locally