Roam

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 classinterface 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

---

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