Перейти к содержимому
Mineforgian

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

  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

Ченджлог

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 via roam.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/M progress counter. Custom heads via icon: "head:<base64>" in biomes.yml.
  • /rtp location <name>: teleport to admin-defined spawn-point presets, gated per-preset with roam.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 by language:.

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 /rtp never 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)

Комментарии

Загружаем…