Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
LeafRTP - Random Teleport for Paper, Spigot, Folia, Fabric, NeoForge & Velocity
Once upon a time, I wanted to explore a minecraft world. I asked for /rtp in servers I played on. They told me "no, that's laggy", and I took that personally.
Random teleport that's easy to set up, easy to tune, and fast. Drop the jar in and /rtp works with zero config, tune it in-game with /rtp menu, or build on the public rtp-api.
At a glance:
- ๐ Plug-and-play: drop the jar in, type
/rtp, done. Zero config. - ๐ ๏ธ No YAML required: tune regions, safety, and effects in-game with
/rtp menu. - ๐งฉ One jar, every platform: build on the public
rtp-apiand ship a single addon for all of them. - โก No "Finding a safe location..." wait: destinations are pre-verified off-tick, never on the main thread.
- ๐ Measured on a public harness: 19.8 TP/s on Paper, 4 ms worst tick (next-best: 70 ms).
- ๐ก๏ธ Audited safety: no unsafe blocks, no force-loaded chunks, no claim bypass, no silent failures.
Minecraft 1.20.x / 1.21.x / 26.x. Legacy Forge isn't native; run this jar under Arclight / Mohist.
Trusted since 2021: 4.6 stars over 30+ reviews, 430k+ downloads.
Why operators pick LeafRTP
Everything below ships in the free build, no add-ons:
- 12 claim integrations bundled (GriefDefender, GriefPrevention, WorldGuard, Towny, Lands, +7 more). No teleport into protected land.
- Vault economy: optional charge per teleport, per-region pricing, auto-refund on cancel.
- Effects engine: particles, sounds, fireworks, potions on every teleport phase.
- Per-player cooldowns & usage limits out of the box.
- PvP/combat-tag gate, PlaceholderAPI, live map heatmaps, multi-world overrides.
- Extend it without a fork: the
rtp-apihooks take one-line suppliers to veto destinations, charge economy, add placeholders, override the world border, gate combat, replace the bare/rtpaction, or build custom arrival platforms. The bundled rtp menu addon does exactly this, swapping bare/rtpfor its own picker.
(How each feature stays cheap: Architecture.)
The clickable /rtp menu: players pick a world or region by clicking, no commands to memorize.
Install (30 seconds)
- Drop
LeafRTP-x.y.z.jarintoplugins/. - Start the server. A
defaultregion is generated for you. - Type /rtp.
- Run /rtp menu to browse regions, worlds, and configuration in-game (book on Paper / Folia, chat-paginated elsewhere).
Tune plugins/RTP/config.yml and plugins/RTP/regions/*.yml later. Full guide: admin guide.
Bundled addons unpack themselves on first run. Four addon jars ride inside the LeafRTP jar and self-extract into plugins/RTP/addons/ the first time the plugin starts - no second download. Delete one from that folder to turn it off (the folder then exists, so it is never re-extracted):
- LeafRTPGuiAddon (GUI demo) - a clickable chest destination-picker. It binds the bare
/rtproot action, so with a GUI renderer present typing/rtpopens the picker instead of teleporting immediately (instant teleport stays reachable from the menu and as a fallback), and adds/rtp gui(rtp.gui). - LeafRTPClaimAddon (claim integrations) - the 12 claim/protection checkers, so claim-aware teleport works out of the box on the Bukkit family.
- LeafRTPRiftAddon (effect demo) - registers a "Virtual Rift" teleport effect that tears the terrain open into a void during warmup (presentation-only client-side blocks, so it can never compromise safety), usable by name in
effects/*.yml. - LeafRTPCountdownAddon (addon-system reference demo) - live teleport and queue-position countdowns, and the canonical copy-paste reference addon.
For those interested in writing their own: every one of these is shipped as a worked coding example. Their full source lives under addons/ in the repo, and the Rift and Countdown demos are pure rtp-api / effects-api (zero platform imports), so they double as copy-paste starting points for your own addon.
Verification & sources
Every number on this page is anchored in the repo:
- Reproducible benchmarks with raw CSVs and per-run analyses:
helpers/StressTestRTP/ - Requirements traced to tests: every requirement, including the safety prohibitions, has an implementing class and regression test:
TRACEABILITY.md - Every design decision is documented: dated, linkable notes on why teleports are queued, how the Anvil pre-filter skips chunk loads, and more:
docs/adr/ - bStats enabled. Anonymous usage stats help prioritize platform work.
See the engine work, and watch it live
LeafRTP isn't a black box. /rtp scan paints region safety onto a real in-game map (green safe, red unsafe) as it verifies it. /rtp info reports live TPS/MSPT, heap, latency percentiles, and rejection causes, no metrics add-on needed.
Watch the scan paint a region live (video). Details: Scan & spatial memory, Diagnostics.
Requirements
Hard requirements. If any are a no, EssentialsX /rtp or HuskHomes are fine alternatives.
- โ Java 21+ (REQ-RTP-SYS-001, non-negotiable).
- โ Paper, Spigot, or a Bukkit-family fork, or Fabric / NeoForge (1.21.x / 26.1.x). Arclight / Mohist for Forge bridges.
- โ Vault (optional) for the economy charge; dormant when not installed.
Full feature list (full reference on the wiki)
Deterministic spiral selection, persistent spatial memory, pre-generated location queue, full safety pipeline, per-region/per-world config and shapes, arrival schematics, the effects engine, Vault economy, 12 claim integrations, PvP/combat-tag gate, the public rtp-api, platform-agnostic addons, live heatmaps, /rtp info diagnostics, and 12 parity-enforced locales. Full reference: Home | Commands | Economy | Effects | Integrations | API.
Platform support
| Platform | Status | Notes |
|---|---|---|
| Paper (+ forks: Purpur, Pufferfish, Leaf, Leaves, DivineMC) | โ Recommended | Fully async via native getChunkAtAsync. |
| Spigot (+ Spigot forks) | โ Supported | Off-tick .mca Anvil pre-filter -> Paper-class throughput on plain Spigot. |
| Arclight / Mohist (Forge bridges) | โ Officially supported | Use the Spigot/Paper jar. Recommended way to run on Forge. |
| Folia | โ Supported (free) | Regionized scheduling + async teleport, zero config. Out-teleports every other Folia /rtp I tested (latest run: 12.5 TP/s, 100% success, 4.15 ms main-thread/teleport) with zero region-watchdog stalls. |
| Multi-server / proxy (Velocity) | โ proxy-direct | proxy-direct transport ships in the free build: cross-server /rtp over a lightweight TCP socket, no Redis/SQL. |
| Fabric | โ Supported | First-class, stable, in-scope platform; tested regularly, at feature parity with the Bukkit family in the latest builds. |
| Native NeoForge | โ Supported | First-class adapter on Minecraft 1.21.x / 26.1.x. |
| Native Forge | ๐ Use Arclight / Mohist | No native adapter planned. |
Full benchmark vs. alternative random teleport plugins on Paper, Spigot, and Folia
Paper rows: 2 OPed clients spamming /rtp back-to-back, queues enabled where the plugin offers them, cooldowns/delays zeroed. Folia run: 3 OPed clients, radius equalized to 4096 blocks, ~600 s per plugin.
Confidence legend: ๐งช = measured locally ยท ๐ = read from plugin docs ยท โ = inferred from architecture.
Metrics: Throughput (TP/s, higher better) ยท MSPT p99 (worst 1-in-100 main-thread tick in ms, lower better) ยท Min TPS (lowest TPS observed; 20.00 = no hiccup) ยท CPU / TP (main-thread CPU per successful teleport).
Paper 1.20.1 / 1.21.11 is the reference dataset. Eight plugins, same harness, same world, same two OPed clients.
| Plugin | TP/s | MSPT p99 (ms) | Min TPS | CPU / TP (ms) | Success |
|---|---|---|---|---|---|
| ๐งช LeafRTP | 19.8 | 4 | 20.00 | 16.9 | 100 % |
| ๐งช JakesRTP | 20.0 | 70 | 20.00 | 26.0 | 100 % |
| ๐งช BetterRTP | 7.3 | 852 | 20.00 | 53.6 | 100 % |
| ๐งช HuskHomes | 6.2 | 372 | 20.00 | 52.2 | 100 % |
| ๐งช AdvancedRTP | 2.16 | 2 100 | 19.95 | 92.1 | 96.3 % |
| ๐งช EzRTP | 1.76 | 2 903 | 19.95 | 139.6 | 100 % |
| ๐งช AsyRTP | 1.67 | 4 534 | 19.95 | 38.8 | 100 % |
๐งช EssentialsX /tpr |
0.96 | 4 504 | 19.95 | 88.9 | 75.9 % ยง |
ยง EssentialsX /tpr is a teleport-request command (handshake + accept), not a teleport-do command; the harness's 5 s per-attempt deadline times out a fraction of the request-accept latencies. Numbers are dispatch-shaped, not plugin-broken.
Spigot 1.20.1: Spigot's platform-wide chunk-gen ceiling caps everyone in the 1-1.5 TP/s range during the burst; the latency tail is what matters.
| Plugin | TP/s | MSPT p99 (ms) | Min TPS |
|---|---|---|---|
| ๐งช LeafRTP | 1.52 | 3 | 6.4 |
| ๐งช JakesRTP | 1.04 | 2 252 | 7.5* |
| ๐งช BetterRTP | 1.33 | 3 790 | 2.18 |
| ๐งช HuskHomes | 0.93 | 4 939 | 2.59 |
Folia 26.1: the free build alone, no Pro adapter; on Folia, throughput plus the server-emitted region watchdog are the discriminators (global MSPT is a single-region sample and not meaningful).
| Plugin | TP/s | CPU / TP (ms) | Watchdog stalls | Success |
|---|---|---|---|---|
| ๐งช LeafRTP | 12.5 | 4.15 | 0 | 100 % |
| ๐งช EzRTP | 5.3 | 6.34 | 7 (one region 20.4 s) | 96.2 % |
EzRTP's 7 watchdog stalls (one region unresponsive 20.4 s) are the server's own record of synchronous World.loadChunk calls on region threads; LeafRTP issued none. For reference, the Pro Folia adapter cleared the same run at 13.5 TP/s. The shared rtp-core engine, not a Pro-only adapter, carries the free build's Folia result.
Architecture support matrix (Spigot / Paper-and-forks / Folia)
- LeafRTP - โ
๐งช Off-tick Anvil pre-filter ยท โ
๐งช Fully async via
getChunkAtAsyncยท โ ๐งช Region Scheduler + off-tick pre-filter, no 1-tick stalls - BetterRTP - โ ๏ธ๐ Sync chunk load on miss ยท โ ๏ธ๐ No off-tick safety pre-filter ยท โ ๐งช Folia 1.21.11 functional, p99 ~1.2 s
- EzRTP - โ๐งช
NoSuchMethodErroron Spigot 1.20.1 (Paper-only API) ยท โ ๐งช Works on Paper, no off-tick pre-filter ยท โ ๏ธ๐งช Folia: syncWorld.loadChunkon region threads, 7 watchdog stalls, 20.4 s freeze - AsyRTP - โ๐งช Fails to enable on Spigot 1.20.1 (Paper-only API in
onEnable) ยท โ ๐ Paper ยท โ ๐ Folia - SorekillRTP - โ ๏ธโ Designed for Redis cross-server, not single-server perf ยท โ ๏ธโ Same ยท โ๐
- AdvancedRTP - โ ๏ธ๐ Safety-first, sync chunk load ยท โ ๏ธ๐ Same ยท โ๐
- JakesRTP - โ ๏ธ๐ Async via flag; 10-slot cache ยท โ ๐ Same ยท โ๐ No Folia
- EssentialsX /rtp - โ ๐ Main-thread chunk load per candidate ยท โ ๐ Same ยท โ๐
- HuskHomes RTP - โ ๐ Bundled with homes suite ยท โ ๏ธ๐ Same ยท โ ๐งช Folia functional, p99 ~900 ms
Caveats. Small client counts only (2 on Paper, 3 on Folia; the number is a floor, not a ceiling); hardware, view distance, world state, and other plugins will move them. Paper rows are 2-client runs (LeafRTP reproduced n=2; others n=1 on a single rig); the Folia run used 3 clients and its EzRTP failure is corroborated by the server's own watchdog log, independent of the harness. Competitor plugins update frequently; corrections welcome via GitHub issue with a contradicting repro or doc link. This table measures performance only; feature breadth is not benchmarked here. LeafRTP ships the clickable GUI menu, Vault economy, the lifecycle effects engine, and twelve bundled claim integrations alongside these numbers. It does not trade features for speed.
Full methodology, raw CSVs, per-run analyses: helpers/StressTestRTP/. Video benchmark of /rtp on a custom world generator: youtu.be/V0NyNK9JydM.
Commands, placeholders, soft-deps
Commands (full reference: admin guide)
- /rtp: teleport to the default region for your current world.
- /rtp [parameter]:[value]: specify
region:,world:,player:, or temporary overrides. - /rtp reload: reload all configuration from disk.
- /rtp scan start|pause|resume|reset|cancel: pre-warm spatial memory by walking a region (renamed from
/rtp fillin 2.x). Demo: youtu.be/Ftjy1zw_S04. - /rtp menu: interactive admin menu; book on Paper / Folia, chat-paginated fallback elsewhere. Hardened in
3.0.0-beta.3.
PlaceholderAPI
- %rtp_player_status%: idle, waiting, teleporting, ...
- %rtp_total_queue_length%, %rtp_public_queue_length%, %rtp_personal_queue_length%
- %rtp_teleport_world%, %rtp_teleport_x%, %rtp_teleport_y%, %rtp_teleport_z%
Soft dependencies (all optional): Vault (for the optional economy charge), PlaceholderAPI, ProtocolLib. PaperLib is no longer required.
FAQ
Q: How do I stop /rtp from lagging my server, and why is LeafRTP faster?
A: Destinations are pre-verified and chunk-loaded into a queue before you type the command, so /rtp serves instantly without loading chunks on the main thread. Persistent spatial memory skips known-bad ground, and an off-tick Anvil pre-filter rejects unsafe spots before any chunk loads.
Q: Is it hard to set up, and does it have economy, a menu, and effects? A: No, and yes. It works zero-config out of the box; regions, safety, and effects are optional to tune later. The clickable menu, Vault economy, effects engine, heatmaps, and twelve claim integrations all ship in the free build.
Q: Why is it called "LeafRTP" now instead of just "RTP"?
A: "RTP" is the generic term for random teleport, so the old name was nearly impossible to find. It collided with every other random-teleport plugin, command, and forum thread in search and marketplace indexes. "LeafRTP" is a distinct, indexable name that points unambiguously at this plugin while keeping the /rtp command, rtp-api, config paths, and data files exactly as they were. Nothing changes for existing installs, only the public name.
Q: Does it work with Iris / Terra / custom datapack generators?
A: Yes. Region files are read directly, so modded and namespaced biome and block IDs are preserved, no configuration needed. /rtp biome:<x> stays correct even on pregenerated or version-migrated worlds, since biome data comes from the .mca files rather than a seed lookup.
Q: Do you support triangle / diamond region shapes?
A: Use the Polygon shape. A triangle is a 3-vertex polygon and a diamond is a rotated square, so both are already expressible without a separate shape type.
Q: Do I need Chunky or another pre-generator?
A: No. /rtp scan is a built-in, off-tick generator that walks a region and builds persistent spatial memory. Rather than loading every chunk up front, LeafRTP pre-verifies and remembers which sectors are unsafe so it avoids loading bad ground at all. Run Chunky alongside it if you still want a fully pre-generated map.
Q: I'm on NeoForge. A: NeoForge is a first-class supported platform on Minecraft 1.21.x / 26.1.x. Just drop the mod in.
Q: I'm on Forge. A: Run Arclight or Mohist (officially supported) and use this jar. A native Forge adapter is not planned.
Q: Memory and MSPT: should I worry?
A: LeafRTP trades a bounded amount of RAM (the queue, bounded by cacheCap) for speed. TPS should not drop below ~19 from LeafRTP alone on a healthy server; MSPT spikes during new-area generation are expected. That's the cost of generating chunks, not RTP.
Q: How do I report a bug? A: GitHub issue with server version, LeafRTP version, platform, relevant config files, and the error log section. See the admin guide for the full reproduction template.
Community Support Policy (read before filing an issue)
Support for the free build is community-tier and best-effort. I ship fixes when properly-reported issues land. Respecting this is how the plugin stays fast and current.
- Support covers bugs and configuration questions, after you've read the admin guide.
- Bug reports need a reproduction: server version, LeafRTP version, platform (Spigot / Paper / fork),
config.yml,regions/,safety.yml, and the relevantserver.logsection. Reports without these are asked for them once, then closed. - "It doesn't work" is not a bug report. Tell me what you did, what you expected, and what actually happened.
- Unsupported on the free tier: native Forge (use Arclight / Mohist), plugin conflicts I can't reproduce, general MC-server admin questions.
- Response time: no SLA on the free build. Critical safety issues jump the queue regardless.
- Feature requests via GitHub issues. Priority follows the published roadmap, not ticket volume.
Lite build boundaries & known issues
safety.ymlaccepts flat material names (LAVA,MAGMA_BLOCK,CACTUS,FIRE). Block tag / state-predicate grammar (#minecraft:leaves,OAK_SLAB[waterlogged=true], wildcards) and SQL/Redis shared-state backends are not part of this build.- Edits to
safety.ymland biome filters do not yet invalidate the persisted shape cache. Workaround:/rtp scan reset <region>. - Emergency landing platform default is now
platformRadius: -1(disabled). Set to0or higher to restore legacy 2.x behavior.
Live list: CHANGELOG.
Links
- LeafRTP admin & configuration guide: install, configure, command reference
- LeafRTP addon / API developer guide:
rtp-apiand examples - LeafRTP changelog & roadmap
- LeafRTP source on GitHub: star, watch, contribute, file issues
If block tag / state-predicate safety rules or SQL/Redis shared-state backends matter to your setup, a higher-tier build is available separately on BuiltByBit. Same engine, same config, same data files, drop-in compatible.