LeafRTP: Minecraft Random Teleport (/rtp & /wild) Plugin and Mod¶
LeafRTP is a Minecraft random teleport (/rtp and /wild) plugin and mod for Paper,
Spigot, Folia, Fabric, NeoForge, and Velocity. Drop the single jar into plugins/ or
mods/ and the default circular region works out of the box - players run /rtp or
/wild to teleport to a safe random location without lagging the server.
Server owners can adjust region borders visually on a browser map (/rtp editor), run the
60-second in-game setup wizard (/rtp admin setup), or migrate existing settings in one
command (/rtp config import) from BetterRTP, JustRTP, or EzRTP:
- Zero main-thread chunk stalls: checks terrain from region files on disk (
.mcaand.linear) and keeps a pre-warmed queue of safe destinations ready before anyone types/rtp - Easy region setup: configure simple
CIRCLE,SQUARE,RECTANGLE,ELLIPSE, orPOLYGONregions using block or kilometer radii (e.g.radius: 5000bor10km) - Even player spacing: spreads players across the region without clumping at the center or repeating known-bad ocean/lava chunks (see How it works and Why for the internal engine design)
- Built-in gameplay & claim support: wilderness portals, party scatter, arrival schematics, Vault economy, and 18+ land-claim integrations
Supported platforms¶
Backend servers (where the plugin/mod jar runs and teleports happen): Paper and Spigot 1.18+, Folia 1.21.11+, Fabric 1.20.1 and 1.21+, and NeoForge 1.21.1+, up to Minecraft 26.3. Java 17+ is required (Minecraft itself needs Java 21 from 1.20.5 and Java 25 on 26.x). Bug reports are accepted for 1.21.11 through the latest release; older versions are best effort, except Folia, which is experimental and not supported below 1.21.11 (support matrix). Legacy Forge is not native - run the Spigot/Paper jar under Arclight / Mohist.
Proxy (a different role, not another backend): the same jar also runs on a Velocity
proxy, where it acts as the router/transport for cross-server "network mode" rather than
teleporting players itself. Drop the jar in the proxy's plugins/, install RTP on each
backend as usual, and a bare /rtp on one server can send a player to a region on
another over proxy-direct (zero external dependencies), SQL, or Redis. See
Proxy mode.
Install¶
One jar covers every platform - there is no per-platform download.
- Download the jar (Modrinth for the free download, or BuiltByBit for paid priority support).
- Bukkit-family servers (Paper, Spigot, Folia and their forks, Arclight, Mohist, Velocity): drop
the jar in
plugins/. Fabric / NeoForge: drop it inmods/. Start the server. - Run
/rtp(or/wild). Configuration generates on first run underplugins/RTP/on the Bukkit family, orconfig/rtp/on Fabric / NeoForge. Use/rtp editoror/rtp admin setupwhenever you want to customize borders or presets.
Note
Both the free Modrinth download and the paid BuiltByBit listing ship the exact same MIT-licensed
code, features, Folia scheduler, and cross-server transports (proxy-direct, SQL, and Redis) -
nothing in the plugin is locked. Optional soft dependencies (all auto-detected): Vault
(economy charge), PlaceholderAPI, ProtocolLib.
Where to start¶
- Quick start and Server administrators guide
- Web Workspace & Editor (
/rtp editor) and Migration guide (/rtp config import) - Intended usage - the mental model the rest of the documentation assumes
- Commands, the interactive menu, and permissions
- Core Configuration and the Configuration overview
- Regions, Schematics / shapes, and Safety
- 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.