Home

Welcome to the RTP wiki!

This wiki explains roughly how the plugin works, including setup and configuration.

RTP was designed to fill operator needs that are still unmet by more popular random teleportation plugins, e.g.

• performance management (no synchronous chunk loads on the main thread)
• instant response times via a pre-warmed location cache
• multiple regions per world
• placement learning (spatial memory), for improving time-stability as the plugin learns
• unique placements, so players more easily find new places with fewer teleports and less exploration
• optionally grow regions to add new area as space is used up
• cache locations ahead of time on a timer
• queue teleporting players by command input times

A custom selection algorithm lets the plugin step over learned placements rather than reroll, without affecting the random distribution. See the Why page for the source algorithm.

Supported platforms

Paper, Folia, Spigot, Fabric, and NeoForge (Minecraft 1.20.x / 1.21.x / 26.x). Java 21+ is required. Legacy Forge is not native - run the Spigot/Paper jar under Arclight / Mohist.

Install

One jar covers every platform - there is no per-platform download.

1. Download the jar (Modrinth for the free build, or BuiltByBit for Pro).
2. Bukkit-family servers (Paper, Spigot, Folia and their forks, Arclight, Mohist): drop the jar in plugins/. Fabric / NeoForge: drop it in mods/. Restart the server.
3. Configuration generates on first run under plugins/RTP/ on the Bukkit family, or config/rtp/ on Fabric / NeoForge.

Note Folia, multi-server / proxy, and SQL/Redis shared state are LeafRTP-Pro features. The free jar runs on Paper / Spigot / Fabric / NeoForge as-is. Optional soft dependencies (all auto-detected): Vault (economy charge), PlaceholderAPI, ProtocolLib.

Where to start

• Commands, the interactive Menu, and Permissions
• Core Configuration and the Typical Configuration Order
• Regions, Shapes, and Biome Controls
• What NOT to do!

Beyond the basics

Recent versions also add a multi-server / proxy "network mode" (cross-server /rtp via Velocity with SQL/Redis shared state), runtime metrics, Vault economy, a lifecycle Effects engine, and a cross-platform addon API.