P_Randomtp

插件

· 作者 Mr_Haruki

优化版随机传送 RTP 插件

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

最新 1.5.0 · 1.21.8 · Bukkit / Paper

一键开服(送7天)

? P_Randomtp

面向 Paper/Spigot 1.21+ 服务器的优化版**随机传送 (RTP)**插件。
允许玩家安全地传送到世界中的随机位置,避免卡顿和常见 RTP 插件的问题。

✨ 功能特性

  • ? 安全的随机传送 – 避开液体、危险方块和下界天花板。
  • ? 自适应半径 – 若未找到有效地点,自动扩大搜索区域。
  • ⚡ 按 tick 分片搜索 – 将尝试分散到各个 tick 执行,防止服务器卡死。
  • ? 异步区块加载 – 即使距离很远也能保证快速 RTP。
  • ?️ WorldGuard 集成(可选)– 尊重受保护的区域。
  • ? Vault 集成(可选)– 针对不同世界收取自定义费用。
  • ⏳ 预热、冷却时间与权限等级 – 灵活设置以平衡使用频率。
  • ? 多语言支持 (pt_br, en_us) – 可根据语言自定义消息或在 config.yml 中强制指定。

? 安装

  1. 下载该插件编译好的 .jar 文件。
  2. 将其放入 Paper 1.21+ 服务器的 plugins/ 文件夹中。
  3. 重启服务器以生成配置文件。
  4. 根据需要编辑 config.yml。
  5. (可选)安装 Vault 以收取 RTP 费用,并安装 WorldGuard 以尊重区域保护。

⚙️ 配置

config.yml 文件包含多种选项。
以下是优化配置的示例片段:

settings:
  cooldown-seconds: 60
  warmup-seconds: 3
  per-tick-attempts: 6
  loaded-chunks-only: false
  allow-chunk-load: true
  async-chunk-loads-parallel: 8
  max-attempts: 120
  adaptive-radius:
    enabled: true
    step-percent: 25
    max-multiplier: 3.0
权限 描述 默认值
prandomtp.use 允许使用 /rtp ✅ 所有玩家
prandomtp.bypass 忽略冷却时间 ❌ 仅限 OP
prandomtp.free 免费使用 RTP(无需 Vault 付费) ❌ 仅限 OP
prandomtp.world.* 允许通过 /rtp 选择任意世界 ❌ 仅限 OP
prandomtp.admin 拥有 /rtp reload 命令的访问权限 ❌ 仅限 OP
prandomtp.tier.vip 自定义等级(更短的冷却时间,更大的半径) ❌ 仅限 VIP
prandomtp.tier.legend 自定义等级(极短的冷却时间,更大的半径) ❌ 仅限 Legend
命令 用法 描述
/rtp /rtp 传送到当前世界的随机位置
/rtp <mundo> /rtp world_nether 传送到其他世界(如果允许)
/rtp reload /rtp reload 重新加载配置和消息

? 集成

  • Vault – 根据每个世界配置的费用进行收费 (economy.cost.per-world)。

  • WorldGuard – 阻止在受保护区域内传送。

  • bStats – 发送匿名指标数据(可选)。

? 公共 API(供其他插件使用)

  • 可通过 ServicesManager 访问接口:

  • RtpService service = Bukkit.getServicesManager().load(RtpService.class);

  • // 查找安全的位置 Location safe = service.findSafeLocation(player, world);

  • // 请求完整的 RTP(如同执行 /rtp 命令) service.requestRtp(player, world);

  • 可用的事件 (RtpEvents):

  • WarmupStartEvent

  • WarmupCancelEvent

  • SuccessEvent

  • FailEvent

? 优化建议

  • 启用 allow-chunk-load: true 并根据硬件调整 async-chunk-loads-parallel。

  • 调整 per-tick-attempts(4–8 为理想值)。

  • 使用 adaptive-radius 以减少种子中存在大量海洋时的失败率。

  • 如果是高并发玩家服务器,请限制并发 RTP 数量(使用全局信号量)。

❓ 常见问题

❓ - RTP 在存在大量海洋的世界中失败怎么办?

启用 adaptive-radius 并增加 max-attempts 以允许扩展至海洋之外。

❓ - 当玩家从 2000 格外使用 RTP 时会导致卡顿。

确保你使用的是 Paper 1.21+ 服务器,并启用 allow-chunk-load: true。加载过程是异步的,不会阻塞主线程 tick。

❓ - 如何添加更多语言?

在 plugins/P_Randomtp/idiomas/ 目录下创建以语言代码命名的文件,例如:es_es.yml。

❓ - 我可以在特定世界中禁用 RTP 吗?

可以,在 config.yml 中配置 worlds.<name>.allow: false。

? bStats

?‍? 作者

  • 由 Pedro 开发。欢迎提供建议、报告错误或提交 PR!

config.yml 文件包含若干选项。
优化配置示例(片段):

settings:
  cooldown-seconds: 60
  warmup-seconds: 3
  per-tick-attempts: 6
  loaded-chunks-only: false
  allow-chunk-load: true
  async-chunk-loads-parallel: 8
  max-attempts: 120
  adaptive-radius:
    enabled: true
    step-percent: 25
    max-multiplier: 3.0

? 权限

权限 描述 默认值
prandomtp.use 允许使用 /rtp ✅ 所有人
prandomtp.bypass 忽略冷却时间 ❌ 仅限 OP
prandomtp.free 免费 RTP(Vault) ❌ 仅限 OP
prandomtp.world.* 允许通过 /rtp 传送至任意世界 ❌ 仅限 OP
prandomtp.admin 访问 /rtp reload ❌ 仅限 OP
prandomtp.tier.vip 自定义等级(更短冷却、更大半径) ❌ 仅限 VIP
prandomtp.tier.legend 自定义等级(大幅缩短冷却、超大半径) ❌ Legend

⌨️ 命令

命令 用法 描述
/rtp /rtp 传送到当前世界的随机位置
/rtp <world> /rtp world_nether 传送到其他世界(若允许)
/rtp reload /rtp reload 重新加载配置和消息

? 集成

  • Vault – 按世界收取配置的费用(economy.cost.per-world)。
  • WorldGuard – 阻止传送到受保护的区域。
  • bStats – 发送匿名指标数据(可选)。

? 公共 API(供其他插件使用)

可通过 ServicesManager 获取:

RtpService service = Bukkit.getServicesManager().load(RtpService.class);

// 查找安全的位置
Location safe = service.findSafeLocation(player, world);

// 请求完整 RTP(等同于 /rtp)
service.requestRtp(player, world);

? 事件 (RtpEvents)

  • WarmupStartEvent
  • WarmupCancelEvent
  • SuccessEvent
  • FailEvent

? 优化

  • 启用 allow-chunk-load: true,并根据你的硬件调整 async-chunk-loads-parallel。
  • 调整 per-tick-attempts(4–8 为理想值)。
  • 使用 adaptive-radius 以减少在拥有大面积海洋的种子中的失败率。
  • 对于玩家数量较多的高负载服务器,限制并发的 RTP 次数(使用全局信号量)。

❓ 常见问题

❓ 在世界中因海洋过多导致 RTP 失败,该怎么办?

启用 adaptive-radius 并增加 max-attempts 以扩大搜索范围,超越海洋区域。

❓ 当玩家传送到 2000+ 格之外时出现卡顿。

请确保你使用的是 Paper 1.21+ 并启用 allow-chunk-load: true。
区块加载是异步进行的,不会冻结主线程 tick。

❓ 如何添加更多语言?

在 plugins/P_Randomtp/languages/ 目录下创建语言文件,文件名使用语言代码,例如 es_es.yml。

❓ 我可以在特定世界中禁用 RTP 吗?

可以,在 config.yml 中设置 worlds.<name>.allow: false。


? bStats

(可选)通过 bStats 收集匿名指标数据。


?‍? 作者

  • 由 Pedro 开发。欢迎提供建议、Bug 报告和 PR!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源