-
Notifications
You must be signed in to change notification settings - Fork 1
EN 5 6 RTP
中文版本 | English version
This module searches for random targets within configured radius and attempts safe teleport.
It is commonly used on exploration/survival/event servers to spread player positions or provide non-fixed mobility.
When server wants players to explore naturally outside central areas, or provide controlled random movement, rtp fits well.
/rtpMainly related: rtp.enabled, rtp.maxRadius, rtp.minRadius, teleporting.delay, teleporting.cooldown.
rtp.maxRadius and rtp.minRadius together define the search range. Both must be at least 1. If no usable target can be found after attempts, command fails. Long-range random exploration is provided by the separate 5.8 Wild module.
Random teleport is not "pick any point and go". It searches for standable/safe locations in allowed range. More complex terrain or stricter constraints generally increase failure probability. Actual teleport execution still follows global delay/cooldown. RTP uses its own random-destination safety logic and is not affected by teleporting.defaultSafetyCheck or the target teleport preload switch.
rtp.maxRadius has a hard upper limit of 128. This is intentionally conservative: RTP reads block data around random candidate positions and checks whether each candidate is safe. A much larger radius is more likely to push checks into areas around the player that are not actually prepared, increasing hidden chunk-loading risk and main-thread pressure. If the parallel RTP path is triggered, chunk loading while the main thread is blocked may cause a deadlock. Therefore, if your server simulation distance is less than or equal to 5, manually lower the RTP maximum radius to avoid this issue.
If you want wider spread, consider server load distance, player location, and terrain first instead of simply raising radius. The current cap keeps random teleport behavior within a controlled range.
If players often report /rtp failure, first check whether rtp.maxRadius and rtp.minRadius are set appropriately or unreasonable. In extreme terrain/restricted environments, finding valid points is naturally harder.