Roam

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： folia paper purpur

标签： management transportation utility

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

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