Skip to content

LeafRTP: Minecraft Random Teleport (/rtp & /wild) Plugin and Mod

Build Coverage Release Java

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 (.mca and .linear) and keeps a pre-warmed queue of safe destinations ready before anyone types /rtp
  • Easy region setup: configure simple CIRCLE, SQUARE, RECTANGLE, ELLIPSE, or POLYGON regions using block or kilometer radii (e.g. radius: 5000b or 10km)
  • 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.

  1. Download the jar (Modrinth for the free download, or BuiltByBit for paid priority support).
  2. Bukkit-family servers (Paper, Spigot, Folia and their forks, Arclight, Mohist, Velocity): drop the jar in plugins/. Fabric / NeoForge: drop it in mods/. Start the server.
  3. Run /rtp (or /wild). Configuration generates on first run under plugins/RTP/ on the Bukkit family, or config/rtp/ on Fabric / NeoForge. Use /rtp editor or /rtp admin setup whenever 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

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.