
Roam
Advanced asynchronous random teleport (RTP) plugin for Paper, Purpur and Folia. Features a modern GUI, biome targeting, favorites, history, stats, claim protection bypass, Vault economy integration, and full customization.
- Загрузки
- 79
- Подписчики
- 1
- Обновлён
- 10 июня 2026 г.
- Лицензия
- MIT
Опубликован 6 мая 2026 г.
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
- Java 21+
- Minecraft 1.21.1 → 1.21.11 → 26.1.x
Spigot is NOT supported.
Roam depends on:
- Adventure API
- Async chunk loading
- Folia schedulers
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 reveal curated icons as players explore
- Claim-aware teleportation
- YAML / SQLite / MariaDB
- 7 languages (chat + GUI): EN, ES, PT_BR, RU, ZH_CN, RO, DE
- Favorites & history
- Density preview
- 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
Commands
| Command | Description |
|---|---|
/rtp |
Random teleport |
/rtp biome |
Biome collection |
/rtp location |
Admin-defined presets |
/rtp back |
Return |
/rtp check |
Density preview |
/roamadmin info |
Diagnostics |
Quick Start
- Put the
.jarin/plugins/ - Start the server
- Configure the plugin
- Run
/roamadmin reload - 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
Ченджлог
1.3.0Релиз26.1, 26.1.1, 26.1.2 · 10 июня 2026 г.
Roam 1.3.0
Added
- Exploration-gated biome unlocks (opt-in,
biome-finder.unlock.enabled):/rtp biome— new alias/rtp biomes— only accepts biomes the player has physically discovered. First contact grants an advancement toast, a chat notice and a sound. Staff bypass viaroam.biome.bypass-unlock. Existing discoveries are honoured on upgrade. - Biome collection GUI: undiscovered biomes render as sealed crystal cards that flip to each biome's own icon once
explored — 54 curated textured heads bundled, plus a description and a "You'll find:" line for all ~110 shipped
biomes, and a
Discovered: N/Mprogress counter. Custom heads viaicon: "head:<base64>"inbiomes.yml. /rtp location <name>: teleport to admin-defined spawn-point presets, gated per-preset withroam.location.<name>.- Four new languages: Russian, Simplified Chinese, Romanian and German join EN/ES/PT_BR — seven bundled
translations covering chat and GUI (
gui_<lang>.yml), switched together bylanguage:.
Performance
- Chunk-free candidate screening on Iris worlds: water and biome checks now run against Iris' own noise streams instead of generating a chunk per rejected candidate — the single biggest cost of RTP on custom generators is gone.
- Adaptive mode (on by default): an MSPT probe classifies the server as RELAXED / BUSY / STRESSED — background
generation throttles down to zero under load, and search parallelism clamps so
/rtpnever piles chunk loads onto a struggling tick loop. Each world also learns its own search difficulty and borrows extra parallel candidates only where they pay off. - Demand-gated location cache: idle worlds stop generating terrain in the background entirely (one bootstrap entry
kept); active worlds refill as a slow trickle. With
warm-chunks, a cache hit costs a disk read instead of fresh generation — effectively instant/rtp, even on Iris. - Two-phase chunk preload: teleports block only on the 9 chunks around the player; the outer ring loads in the background after arrival.
- Per-candidate slot timeouts with replacement: one stuck chunk generation no longer freezes the whole search, and late-finishing winners are rescued instead of discarded.
- Cached biome rosters and engine handles: tab-complete and the biome menu no longer walk registries/reflection on every keystroke.
Fixed
- GUI pagination dying after the first page navigation; border/footer clicks could resolve to a real biome; world menu broke with customised item names.
- "Searching..." boss bar stuck on screen after teleporting — full lifecycle rework (kind-tagged bars, exception-safe teleport tail, quit cleanup) plus a self-healing watchdog.
- Search slot timeouts discarding valid locations found moments later on slow hardware.
- Citizens biome NPCs bypassed the biome-finder toggle and the unlock gate.
Changed
- Iris integration flagged experimental: works without server lag, but chunk loading on Iris teleports is still slow. Mitigations documented in the README.
- Unified teleport pipeline (seven entry points over four shared gates) backed by a 21-test suite that gates every build.
- Professional text pass: emojis removed from every player-facing surface (GUI, boss bars, titles, messages in all languages).
Removed
/rtp structure— out of scope for Roam's design.
No config migration needed — every new key ships with a sensible default.
1.2.0Релиз26.1, 26.1.1, 26.1.2 · 6 мая 2026 г.
Initial release
- Initial release of Roam
- High-performance asynchronous RTP system
- Modern GUI with favorites, history, and stats
- Support for vanilla biomes, Iris and TerraformGenerator
- Protection against claims from 12 popular plugins
- Vault economy and Citizens NPC integration
- Full support for Paper, Purpur and Folia
- Multiple storage backends (YAML, SQLite, MariaDB)
Комментарии
Загружаем…