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 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) * `` 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 ```yaml 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