Roam
适用于 Paper、Purpur 和 Folia 的异步随机传送插件。
源码可用 • Folia 原生支持 • 16 方向均匀分布 • 支持 Iris/TerraformGenerator • 7 种语言
要求
- Paper、Purpur 或 Folia
- Minecraft 1.20.1 → 1.21.11 → 26.1.x → 26.2 → 26.3 — 20 个版本,一个 jar 文件
- Java 17+ — 跟随你的 Minecraft 版本,而非 Roam:1.20.1–1.20.4 运行于 17,1.20.5–1.21.11 运行于 21,26.x 运行于 25。Roam 的字节码目标为 17,因此它永远不会提高你的最低要求。
不支持 Spigot。
Roam 依赖以下组件:
- Adventure API
- 异步区块加载
- Folia 调度器
Paper 在 1.21.11 之后重命名了其版本号 — 没有 1.21.12;下一个
发布版本是 26.1.0。
前向兼容性
支持范围不是一个声明,而是一个构建门控。每个构建都会运行一个检查器,遍历已发布的 jar 所做的每个 API 调用,并将其与最新的服务器 API 进行解析,在成员移除或类↔接口翻转时失败。1.6.1 jar 已针对范围内所有 20 个已发布版本验证通过,并在 Paper 26.3 上进行了实时测试。
性能
- 在生产环境的 Folia 服务器上 CPU 使用率约为 0.91%
- 顺序搜索平均时间从 18.4 秒 → 2.1 秒;同时处理 40 次搜索时,成功率从 0/40 → 40/40(在 20 TPS 下)
- 原版生物群系预过滤和全服务器区块加载限制:搜索不再导致世界生成过载
- 自适应自调优:当服务器繁忙时,后台工作节流至零
- 在 Iris 世界中,被拒绝的候选者不生成区块(噪声流筛选)
- 无空闲循环,无不安全线程使用 — 异步优先架构
并行搜索
Roam 并发评估多个传送候选项(1–16 个)。
典型传送搜索时间:
- 密集/受保护的世界:约 1–2 秒
- 传统 RTP 插件:约 5–10 秒
功能
- 异步并行 RTP
- 均匀分布(可选)—
distribution: spread 沿向外螺旋行走:每圈 16 个方向,每圈距离进一步增加,使玩家均匀落在各处
- 内置 GUI,以及管理员菜单可在游戏内编辑按世界设置的配置
- 生物群系目标定位,包括洞穴生物群系和 26.3 版的斑驳森林 (Dappled Forest)
- 生物群系解锁进度(可选)— 玩家必须步行探索后才能传送到这些生物群系
- 生物群系收集 GUI — 水晶卡片,随着你的探索揭示每个生物群系
- 领地感知传送
- YAML / SQLite / MariaDB
- 7 种语言(聊天 + GUI):EN, ES, PT_BR, RU, ZH_CN, RO, DE
- 收藏 & 历史记录
- 密度预览
- 按权限分级 — 不同区域、冷却时间和费用对应不同等级
- 自定义位置 / 预设 — 命名的、带权重的出生点,而非随机搜索
- 预热的位置缓存 + 区块预加载
- 追加式审计日志(可选)
[RTP] 告示牌
- 死亡时 RTP
- NPC 集成
- Vault 经济支持
- 冷却时间与准备时间
- 首次加入时 RTP
- 传送后保护
兼容性
每个集成都会被自动检测,并在缺失时优雅降级。
区域插件
- WorldGuard
- GriefPrevention
- GriefDefender
- Towny
- Lands
- Residence
- RedProtect
- Factions
- KingdomsX
- HuskClaims
- HuskTowns
- CrashClaim
其他插件
- Vault
- PlaceholderAPI
- EssentialsX
- Iris(实验性 — Iris 上的区块加载在传送时仍然较慢)
- TerraformGenerator
- Chunky
- Citizens
- CombatLogX
- HMCCosmetics
命令
| 命令 |
描述 |
/rtp |
随机传送 |
/rtp biome |
生物群系收集 |
/rtp location |
管理员定义的预设 |
/rtp back |
返回 |
/rtp check |
密度预览 |
/rtp save / go / history |
收藏 & 历史 |
/roamadmin gui |
管理员菜单 |
/roamadmin info |
诊断信息 |
/roamadmin edit |
实时配置编辑,无需重载 |
/roamadmin testsearch |
试运行搜索,可从控制台执行 |
快速开始
- 将
.jar 放入 /plugins/
- 启动服务器
- 配置插件
- 运行
/roamadmin reload
- 使用
/rtp
示例配置
global:
warmup: 3
cooldown: 300
search-parallelism: 4
worlds:
world:
min-radius: 100
max-radius: 5000
distribution: spread # random (默认) | spread
storage:
type: SQLITE
API
RoamAPI roam = RoamProvider.get();
if (roam != null) {
roam.randomTeleport(player);
}
事件:
RoamPreTeleportEvent
RoamLocationFoundEvent
RoamPostTeleportEvent
链接
许可证
源码可用
允许:
不允许:
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
- Put the
.jar in /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
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:
评论 0
登录后参与评分
还没有评论,来抢沙发吧