Roam

插件

· 作者 naren.sanchez.h

适用于 Paper、Purpur 和 Folia 的高级异步随机传送(RTP)插件。具备现代化 GUI、生物群系定向、收藏功能、历史记录、统计信息、领地保护绕过、Vault 经济集成以及全面自定义功能。

0 本站下载 0 关注 更新于 1 个月前

最新 1.6.1 · 26.3 · Folia / Paper

一键开服(送7天)

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 试运行搜索,可从控制台执行

快速开始

  1. 将 .jar 放入 /plugins/
  2. 启动服务器
  3. 配置插件
  4. 运行 /roamadmin reload
  5. 使用 /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

链接


许可证

源码可用

允许:

  • 个人使用
  • 商业服务器使用

不允许:

  • 再分发
  • 转售

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源