Roam

Async RTP

Async random teleport plugin for Paper, Purpur and Folia.

Source-available • Folia-native • Iris/TerraformGenerator support • 7 languages

---

Requirements

• Paper, Purpur or Folia
• Minecraft 1.20.1 → 1.21.11 → 26.1.x → 26.2 — 19 releases, one jar
• Java 17+ — this follows your Minecraft versiun on 17, 1.20.5–1.21.11 on 21, 26.x on 25. Roam's bytecode targets 17, so it never raises your floor.

Spigot is NOT supported.

Roam depends on:

• Adventure API
• Async chunk loading
• Folia schedulers

Paper renamed its versions after 1.21.11 —t release is 26.1.0.

Forward compatibility

The supported range isn't a claim, it's a build er that walks each API call the shipped jar makes and resolves it against the newest server API, failing on removed members and on class↔interface flips. The 1.4.0 jar is verified clean against all 19 publi

---

Performance

• ~0.91% CPU usage on production Folia servers
• Adaptive self-tuning: background work throttles to zero when the server is busy
• No chunk generation per rejected candidate on Iris worlds (noise-stream screening)
• No idle loops
• No unsafe thread usage
• Async-first architecture

Parallel Search

Roam evaluates multiple teleport candidates concurrently (1–16).

Typical teleport search times:

• Dense/claimed worlds: ~1–2s
• Traditional RTP plugins: ~5–10s

---

Features

• Async parallel RTP
• Built-in GUI
• Biome targeting
• Biome unlock progression (opt-in) — players discover biomes on foot before they can teleport to them
• Biome collection GUI — crystal cards that revexplore
• Claim-aware teleportation
• YAML / SQLite / MariaDB
• 7 languages (chat + GUI): EN, ES, PT_BR, RU, ZH_CN, RO, DE
• Favorites & history
• Density preview
• Per-permission tiers — different zones, cooldowns and costs per rank
• Custom locations / presets — named, weighted som search
• Pre-warmed location cache + chunk preload
• Append-only audit log (opt-in)
• [RTP] signs
• RTP on death
• NPC integration
• Vault economy support
• Cooldowns & warmups
• First-join RTP
• Post-teleport protection

---

Compatibility

Region Plugins

• WorldGuard
• GriefPrevention
• GriefDefender
• Towny
• Lands
• Residence
• RedProtect
• Factions
• KingdomsX
• HuskClaims
• HuskTowns
• CrashClaim

Other Plugins

• Vault
• PlaceholderAPI
• EssentialsX
• Iris (experimental — chunk loading on Iris teleports is still slow)
• TerraformGenerator
• Chunky
• Citizens
• CombatLogX
• HMCCosmetics

---

Commands

Command	Description
/rtp	Random teleport
/rtp biome	Biome collection
/rtp location	Admin-defined presets
/rtp back	Return
/rtp check	Density preview
/rtp save / go / history	Favorites & history
/roamadmin info	Diagnostics
/roamadmin edit	Live config edit, no reloa

---

Quick Start

1. Put the .jar in /plugins/
2. Start the server
3. Configure the plugin
4. Run /roamadmin reload
5. Use /rtp

---

Example Config

global:
  warmup: 3
  cooldown: 300
  search-parallelism: 4

worlds:
  world:
    min-radius: 100
    max-radius: 5000

storage:
  type: SQLITE

---
API

RoamAPI roam = RoamProvider.get();

if (roam != null) {
    roam.randomTeleport(player);
}

Events:

- PreTeleport
- LocationFound
- PostTeleport

---
License

Source-available

Allowed:

- Personal use
- Commercial server use

Not allowed:

- Redistribution
- Resale