DyRTP

插件

· 作者 Claww

支持安全随机传送、就绪位置检测、组队 RTP、生物群系选择,并提供五种语言;单个 JAR 文件,兼容 Folia。

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

最新 1.4.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

DyRTP — 简单的随机传送

发现新地点。选择你的世界。继续探索。

DyRTP 是一款基于命令的随机传送插件,适用于生存、SMP 和经济服务器。帮助玩家发现新地点,选择可前往的世界,并在无需 GUI 的情况下配置每个世界。

DyRTP 将可配置的世界配置文件、目的地安全检查、可选的保护钩子(hooks)和经济支持与熟悉的基于命令的工作流程相结合。版本 1.4.0 减轻了繁忙服务器的负担,增加了近/远距传送、一次性返回功能、RTP 统计信息、传送后执行的命令、远离其他玩家的功能以及供管理员使用的搜索测试。所有新功能默认关闭,需手动开启;现有设置、别名和玩家偏好均保持不变。


1.4.0 新增内容

减轻繁忙服务器的负载。 热身(warmups)和传送门的移动检查现在会在读取任何设置之前返回,传送门仅在当前玩家所在的世界中查找,且搜索仅在开始时读取一次设置而非每一步都读取。缓存的世界和方块列表意味着占位符和最终安全检查不再在每次调用时复制列表。

近距与远距。 启用 distance-presets.enabled 后,/rtp near 和 /rtp far 会在各自的距离范围内搜索(默认分别为 100–1000 块和 5000–20000 块)。玩家需要 dyrtp.near 或 dyrtp.far 权限。

一次性返回。 启用 back.enabled 后,/rtp back 可将玩家带回上次执行 /rtp、使用 RTP 告示牌或传送门之前的位置,有效期为 back.expire-seconds(120秒)。back.cooldown-seconds 用于限制使用间隔。权限:dyrtp.back。

统计信息。 启用 stats.enabled 后,DyRTP 会记录每位玩家的成功 RTP 次数:/rtp stats、/rtp stats <player>(需要 dyrtp.stats.others 权限)以及 %dyrtp_count% 占位符。

传送后执行命令。 after-teleport-commands 可在成功 RTP 后运行控制台或玩家命令,例如发放新手礼包,支持 {player}、{world}、{x}、{y} 和 {z} 变量。first-rtp-only 可将其限制为玩家的首次 RTP。

远离其他玩家。 rtp.safety.avoid-players-radius 会拒绝位于其他玩家周围指定距离内的目的地(默认为 0,即关闭)。

测试搜索。 /dyrtp admin test [world] 会执行一次搜索并报告其耗时和尝试次数,而不会传送任何人。

1.3.0 新增内容

选择世界。 启用 world-selection.enabled 后,/rtp world <world>(或 /rtp <world>)可在另一个世界中搜索,例如下界。world-selection.worlds 可限制可选世界列表,并通过 dyrtp.world.<world> 控制每个世界的权限。

按世界设置价格和冷却时间。 rtp.worlds.<world>.price 和 rtp.worlds.<world>.cooldown 可为进入特定世界的 RTP 设置独立的价格和等待时间。

RTP 告示牌。 管理员在告示牌上写入 [RTP],第二行可选填世界名称;右键点击即可开始 RTP。

传送门区域。 使用 /dyrtp admin portal pos1、pos2 和 create <name> [world] 可将一个区域设置为传送门:走进该区域即可启动 RTP。非常适合用作出生点出口。

1.2.0 新增内容

Folia 支持。 同一个 JAR 文件可在 Bukkit、Spigot、Paper、Purpur 和 Folia 上运行。在 Folia 上,每个目的地都在拥有它的线程上进行检查。

预设安全点。 DyRTP 会提前在每个世界中寻找几个安全点(rtp.queue.size,默认为 3),这样 /rtp 可直接传送而无需先进行搜索。每次传送前都会再次检查这些安全点;如果环境发生变化,则会转为实时搜索。

组队传送。 /dyrtp group <player> 可邀请好友;好友通过 /dyrtp group join 接受邀请后,当站在队长周围 group.max-distance 块范围内时,将在队长的下一次 /rtp 中一同传送。最多支持 group.max-size(4 人)同时参与。

就地设置家。 安装 DyHomes 后,成功的 RTP 会提供一个点击选项,准备执行 /sethome。

1.1.0 新增内容

选择生物群系。 /rtp biome <biome> 会在选定的生物群系中寻找安全点,并支持 TAB 补全。服务器所有者可通过 biome-selection.biomes 限制可选范围或关闭此功能;被黑名单屏蔽的生物群系(如海洋)永远无法被选中。

权限组等级。 dyrtp.cooldown.<seconds> 和 dyrtp.price.<amount> 可为权限组设置独立的冷却时间或价格(取最低值),dyrtp.radius.<blocks> 为其设置最远传送距离(取最高值)。dyrtp.cooldown.0 可移除冷却时间。

占位符。 配合 PlaceholderAPI 使用:%dyrtp_cooldown%、%dyrtp_cooldown_formatted%、%dyrtp_ready%、%dyrtp_price%、%dyrtp_price_formatted% 和 %dyrtp_world%。

更多语言和 MiniMessage。 新增德语、西班牙语和俄语,与英语和土耳其语并列。消息文本现在支持全局 & 颜色代码,并且在 Paper 和 Purpur 上支持 MiniMessage 标签,例如 <gradient:#55ff55:#55ffff>。

首次加入与死亡传送。 首次加入和死亡 RTP 可通过 first-join-rtp.world 和 death-rtp.world 将玩家传送到指定世界。新安装默认读取原版 /worldborder 设置。

面向开发者。 DyRTPAPI 可报告冷却时间、价格和目的地世界,并可启动 RTP。匿名 bStats 统计信息可通过 metrics.enabled: false 关闭。

1.0.1 变更内容

保持目的地就绪。 受限的插件区块票(chunk ticket)会在整个热身期间保留所选目的地。票证在不同请求间安全共享,并在完成、取消、重载或关闭后释放;地形和保护检查仍会在传送前进行。

无经济提供商时免费。 缺少 Vault 或未注册的经济提供商会使 RTP 保持免费,包括对拥有旧版付费设置的普通玩家也是如此。在未检测到提供商之前,正数价格和启用支付功能将被拒绝。提供商交易错误仍会安全地阻止付费请求。

更短的命令。 /dyr 是 /dyrtp 的玩家快捷指令;/dyra 打开现有的管理分支,具有相同的权限和 TAB 补全建议。帮助菜单不再包含描述帮助命令本身的行。

选择你的服务器构建

服务器 JAR 文件
Bukkit, Spigot, Paper, Purpur, Folia DyRTP-1.4.0.jar

在每个服务器安装 一个 JAR 文件。在替换旧的 JAR 文件之前,请停止服务器并备份完整的 DyRTP 文件夹。现有的世界配置、玩家偏好设置和自定义翻译将被保留。

Java 17 字节码;请使用您的服务器所需的运行时环境。Minecraft 1.20.x–26.x 为发布列表;1.3.0 的实时测试使用了 Paper 26.2 和 Folia 1.20.4.20.4、Folia 1.20.4、Spigot 26.3 以及 Paper 26.2。可选集成也必须支持您选择的服务器。历史版本 1.0.0 下载保留了其原始文件名。

Downloads · Compatibility notes

Why DyRTP?

Your worlds, your rules. Choose a radius, center, shape and allowed biomes for each world. Add a warmup, cooldown or world redirect to fit your server.

Safety you can configure. Ground, liquids, height and headroom checks help reject unsafe destinations. Optional protection hooks keep players out of protected areas.

Automatic language. English, Turkish, German, Spanish and Russian messages and help follow the effective language. Players can save a preference, and administrators can choose one language for everyone.

Works with your server. DyClaim and other supported protection adapters are optional. Add Vault and an economy provider for paid RTP, or use core teleportation without them.


A measured look at teleport time

DyRTP and BetterRTP median command-to-teleport time across five scenarios

Measured with DyRTP 1.4.0 on Paper 26.1.2 with one non-OP client: DyRTP had the lower observed median and p95 in all five matched-setting samples. Each plugin completed 70 requests. These are command-to-teleport durations, not CPU/RAM measurements, and do not establish a universal speed or safety advantage. Protection and economy were disabled for the timing comparison.

Method, results and limitations

Commands

命令 用途
/dyrtp 或 /dyr 搜索一个安全的随机目的地
/dyrtp help 显示你可用的命令
/dyrtp biome <biome> 传送至所选生物群系中的随机地点
/dyrtp group <player> 邀请一名玩家与你一起进行下一次 RTP
/dyrtp group join, decline, leave 回复邀请或退出群组
/dyrtp world <world> 或 /rtp <world> 传送至其他世界中的随机地点
/dyrtp near 或 /dyrtp far 传送至附近或远处的随机地点
/dyrtp back 返回至上一次 RTP 之前的位置
/dyrtp stats [player] 查看某玩家使用 RTP 的次数
/dyrtp language <auto/en/tr/de/es/ru> 保存你的语言偏好设置
/dyrtp confirm 确认你当前的付费 RTP 请求
/dyrtp cancel 取消待处理的确认
/dyrtp admin help 或 /dyra 显示管理命令
/dyrtp admin force <player> 强制对指定在线玩家执行 RTP
/dyrtp admin economy <on/off> 启用或禁用付费 RTP
/dyrtp admin price <amount> 设置一个有限的、非负的价格
/dyrtp admin cooldown <seconds/off> 配置重复使用的冷却时间
/dyrtp admin delay <seconds/off> 配置传送预热时间
/dyrtp admin radius min <blocks> 配置最小半径
/dyrtp admin radius max <blocks> 配置最大半径
/dyrtp admin language <auto/en/tr/de/es/ru> 配置全局语言
/dyrtp admin reload 验证并重新加载设置与消息
/dyrtp admin portal <pos1/pos2/create/delete/list> 管理 RTP 传送门区域
/dyrtp admin test [world] 测试搜索并显示其耗时和尝试次数

/dyr, /rtp, /randomtp, /wild, /wildtp, /forcertp 和 /rtpforce 仍被支持。帮助命令与 TAB 补全会显示当前生效的语言,管理分支统一命名为 admin。玩家名称及其他数据参数不会被翻译。管理员设置与强制类命令可通过控制台执行;个人 RTP 操作及语言切换则需要玩家身份。

为保持兼容性,旧的 /confirm 和 /cancel 命令注册仍然保留。其他插件可以占用这些未限定的根命令。请使用 /dyrtp confirm 或 /dyrtp cancel;可点击按钮使用 /dyrtp:dyrtp 配合一个过期的单次使用请求令牌,以防止旧按钮批准新请求或 DyClaim 操作。

/dyra <operation> 等同于 /dyrtp admin <operation>。

语言与权限

全局配置项 language.default 设置为 en、tr、de、es 或 ru 时,将覆盖已保存的偏好设置与客户端区域设置,用于消息、帮助和 TAB 补全。当设为 auto 时,优先使用已保存的偏好设置;若启用,则其次使用客户端区域设置,最后回退到英文。save-player-choice 控制是否使用已存储的选择。

权限 Bukkit 默认值 用途
dyrtp.use true 自我随机传送(RTP)及确认
dyrtp.admin op 管理功能,强制 RTP 并更新通知
dyrtp.bypass.cooldown op 跳过冷却时间
dyrtp.bypass.warmup op 跳过准备时间
dyrtp.bypass.economy op 跳过费用支付
dyrtp.biome true 使用 /dyrtp biome 选择生物群系
dyrtp.world.*, dyrtp.world.<world> true (*) 使用 /dyrtp world 选择世界
dyrtp.sign true 使用 RTP 告示牌
dyrtp.portal true 使用 RTP 传送门区域
dyrtp.near, dyrtp.far true 近距与远距传送
dyrtp.back true RTP 后返回一次
dyrtp.stats, dyrtp.stats.others true, op 查看自身和其他玩家的 RTP 统计数据
dyrtp.cooldown.<seconds> 未设置 自身冷却时间;取最低值生效
dyrtp.price.<amount> 未设置 自身费用;取最低值生效
dyrtp.radius.<blocks> 未设置 自身最远距离;取最高值生效

权限检查使用 Bukkit 的有效权限结果,包括显式拒绝。拥有 OP 权限并不提供额外的无条件绕过。每个绕过权限都会单独检查;不存在新的保护绕过。

安全性与操作生命周期

世界配置保留中心点、方形/圆形半径、世界边界、Y 轴范围、生物群系和重定向设置。普通主世界和末地使用除树叶外的最高运动阻挡表面;下界保留其用于地面和头部空间的垂直扫描。末地虚空、液体、被水浸没的方块、配置的危险方块、树叶地面以及受阻的头部空间均会被拒绝。现有的可配置头部空间和表面策略仍然可用。

搜索具有可配置的尝试次数、批次、时间和服务端全局并发限制。默认值为 240 次尝试、每批次 32 个廉价候选检查、30 秒和 16 个并发搜索。每次搜索在请求下一个之前等待一个候选区块加载完成,从而避免推测性生成。已加载和被拒绝的候选项仍消耗批次预算;被拒绝的批次和加载失败会在后续刻继续处理。目的地预加载保留其配置的半径。load-chunks: false 防止未加载候选项的生成。Bukkit 世界访问、保护查询和传送事件在服务端线程上执行;支持的异步区块加载仅负责加载区块。已开始的服务端区块工作无法撤销,但延迟回调无法应用已取消的请求。

玩家只有一个活跃的操作。退出、死亡、外部传送/世界变更、重载和关机将使相关的待定操作失效。移动/伤害取消根据现有设置在预热期间应用。最终验证使用预热后和支持的传送事件重定向后的最新地形和保护状态;它会拒绝禁用的世界。传送失败或取消不会启动冷却时间或发出成功信号。成功的传送会启动冷却时间,并保留原始计时。现有的失明效果会被保留;清理操作仅移除与 DyRTP 自身效果匹配的效果。

首次加入和死亡 RTP 默认处于禁用状态。first-join-rtp.world 和 death-rtp.world 将玩家发送到另一个世界;空值保持当前行为。死亡 RTP 遵循 skip-if-bed-or-anchor。它们的延迟回调会因生命周期变更而失效。强制 RTP 需要管理员权限,并保留现有的冷却时间和支付原因策略。

保护集成

DyClaim 是可选的。当在保护设置中启用且已安装时,DyRTP 调用其现有的 getClaimManager().isChunkClaimed(worldName, chunkX, chunkZ) API 而不加载区块。带符号的方块坐标使用算术区块转换。即使对于所有者或受信任的玩家,已划定的区块也会被排除。搜索后创建的声明会在传送前再次检查。

DyClaim 查询/API 错误以及已安装但未启用的 DyClaim 会安全地停止 RTP;警告会进行速率限制。显式禁用保护或 DyClaim 挂钩会保留现有的退出策略。protection.fail-closed 控制来自其他适配器的错误。其他现有的反射适配器仍然存在,但配置文件中的名称并不能证明其与每个第三方版本的兼容性。请单独验证您安装的集成版本。

经济与确认

玩家目标使用其完整的在线名称,包括 Floodgate 前缀(例如 /dyrtp admin force .Player_Name)。TAB 会保留该前缀。名称不会被剥离或猜测;.Player_Name 和 Player_Name 仍然是独立的目标。RTP、确认和保存的偏好绑定到玩家的 UUID。

付费 RTP 需要 Vault 和一个注册的经济提供商。如果没有其中任何一个,RTP 保持免费;直到检测到提供商为止,正价格和启用支付都会被拒绝。缺少 Vault、缺少提供商以及交易/查询失败会分别记录。无效的价格会被拒绝。确认绑定玩家、原因、源/目标世界和报价金额,并具有过期机制;权限和设置会再次检查。价格/世界的变更需要新的请求。

扣款发生在传送前立即执行。如果 economy.charge-on-success-only: true,失败/取消的传送会通过捕获的提供商触发一次退款。如果为 false,成功的扣款可能在传送失败后仍然保持收费。成功的传送会保留其扣款。失败或不确定的提取/退款绝不会盲目重试;日志会标识需要对账的玩家。Vault 无法保证跨提供商故障的原子事务。

配置、升级和更新

替换 JAR 时请保留 plugins/DyRTP/。缺失的默认值和消息键会被添加,而不会重置自定义值或翻译;未更改的默认蓝色前缀/标题文本会迁移为绿色。玩家偏好保留其 YAML 格式。格式错误的配置/消息/玩家数据以及无效的有界设置会拒绝重载,同时保留正在运行的设置。管理编辑在保存前会单独验证。当重载/编辑被拒绝时,请检查控制台。

现有的 Modrinth 检查器每六小时请求当前 Minecraft 版本和服务端加载器的版本。它选择稳定版本,识别从 Beta 到稳定的升级,并链接到所选版本。HTTP/解析错误会与空的兼容 feed 分开报告。它会通知控制台和拥有 dyrtp.admin 权限的玩家;它不安装更新。

构建与验证

发布说明:支持 Bukkit、Spigot、Paper、Purpur 和 Folia 上从 Minecraft 1.20.x 到当前可用的 26.x 版本。编译目标:Java 17 及 Purpur/Bukkit API 1.20.4。运行时 Java 要求取决于你的 Minecraft 服务器版本。1.2.0 版本在 Java 21 上测试了 Purpur 1.20.4 和 Folia 1.20.4,并在 Java 25 上测试了 Spigot 26.3 和 Paper 26.2;该列表覆盖范围比实际测试矩阵更广,并未验证与每个 Minecraft、Spigot、Purpur 或防护提供程序版本的兼容性。

gradle clean build

使用 Gradle 9.1 配合 Java 25,或使用支持 Java 17 源码目标的 Gradle/JDK 组合。生成的 JAR 文件为 build/libs/DyRTP-1.4.0.jar。JUnit/Mockito 测试仅作为测试依赖项。有关自动化测试与实际服务器覆盖范围及限制的详细信息,请参阅 验证记录;有关自上一个稳定版 1.0.0 以来的变更,请参阅 更新日志。

独立的 BetterRTP 对比 记录了五种场景下常见指令到传送的测量数据。结果因配置文件而异,并不代表普遍的性能或安全性优势。

许可证

DyRTP Source-Available License 1.0,与 DyClaim 条款相同:可免费使用和修改,禁止付费分发,分发版本需公开源代码。这是一个自定义的“源码可用”许可证,而非 OSI 批准的开源许可证。1.0.1 及更早版本采用 LGPL-3.0-only 许可证并保留该许可。详见 LICENSE。

开始使用

  1. 停止服务器,备份当前的 JAR 文件和完整的 plugins/DyRTP/ 文件夹。
  2. 安装 DyRTP-1.4.0.jar 并启动服务器以生成任何缺失的默认配置。
  3. 配置你的世界、安全检查和安全提示消息。
  4. 运行 /dyrtp admin reload 以应用有效设置。

首次加入和死亡后的随机传送(RTP)在未配置前保持禁用状态。核心 RTP 功能无需其他插件支持;付费 RTP 功能需要 Vault 和经济系统提供程序。

源码与支持

文档 · 报告问题 · 许可证

By Claww / DyPlugin.

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源