?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Roam

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.

511downloads
2followers
511downloads
2followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.x
1.21.x
1.20.x

Platforms

Links

Report issues View source Join Discord server

Tags

Creators

Details

Licensed MIT
Published 5 months ago
Updated 3 weeks ago

Roam

Async random teleport plugin for Paper, Purpur and Folia.

Source-available • Folia-native • Even 16-direction spread • Iris/TerraformGenerator support • 7 languages

Requirements

  • Paper, Purpur or Folia
  • Minecraft 1.20.1 → 1.21.11 → 26.1.x → 26.2 → 26.3 — 20 releases, one jar
  • Java 17+ — this follows your Minecraft version, not Roam: 1.20.1–1.20.4 run 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 — there is no 1.21.12; the next release is 26.1.0.

Forward compatibility

The supported range isn't a claim, it's a build gate. Every build runs a checker 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.6.1 jar is verified clean against all 20 published releases in the range, and tested live on Paper 26.3.

Performance

  • ~0.91% CPU usage on production Folia servers
  • Sequential search 18.4 s → 2.1 s mean; 40 searches at once 0/40 → 40/40 at 20 TPS
  • Vanilla biome pre-filter and a server-wide chunk-load limit: searches no longer generate the world away
  • 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
  • Even spread (opt-in) — distribution: spread walks an outward spiral: 16 directions per lap, one distance ring further out each lap, so players land evenly everywhere
  • Built-in GUI, plus an admin menu to edit per-world settings in-game
  • Biome targeting, including cave biomes and the 26.3 Dappled Forest
  • Biome unlock progression (opt-in) — players discover biomes on foot before they can teleport to them
  • Biome collection GUI — crystal cards that reveal each biome as you explore
  • 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 spawn-points instead of a random 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

Every integration is detected automatically and degrades gracefully when absent.

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 gui Admin menu
/roamadmin info Diagnostics
/roamadmin edit Live config edit, no reload
/roamadmin testsearch Dry-run the search, works from console

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
    distribution: spread   # random (default) | spread

storage:
  type: SQLITE

API

RoamAPI roam = RoamProvider.get();

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

Events:

  • RoamPreTeleportEvent
  • RoamLocationFoundEvent
  • RoamPostTeleportEvent

Links

License

Source-available

Allowed:

  • Personal use
  • Commercial server use

Not allowed:

  • Redistribution
  • Resale