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

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。
开始使用
- 停止服务器,备份当前的 JAR 文件和完整的
plugins/DyRTP/ 文件夹。
- 安装
DyRTP-1.4.0.jar 并启动服务器以生成任何缺失的默认配置。
- 配置你的世界、安全检查和安全提示消息。
- 运行
/dyrtp admin reload 以应用有效设置。
首次加入和死亡后的随机传送(RTP)在未配置前保持禁用状态。核心 RTP 功能无需其他插件支持;付费 RTP 功能需要 Vault 和经济系统提供程序。
源码与支持
文档 · 报告问题 · 许可证
By Claww / DyPlugin.
DyRTP — Random Teleportation Made Simple
Find new places. Choose your worlds. Keep exploring.
DyRTP is a command-based random teleport plugin for survival, SMP and economy servers. Help players find new places, choose where they can travel and configure each world without a GUI.
DyRTP combines configurable world profiles, destination safety checks, optional protection hooks and economy support with a familiar command-based workflow. Version 1.4.0 is lighter on busy servers and adds near/far teleports, a one-time way back, RTP statistics, commands after a teleport, keeping away from other players and a search test for administrators. Every new option is off until you turn it on; existing settings, aliases and player preferences are kept.
New in 1.4.0
Lighter on busy servers. Movement checks for warmups and portals now return before reading any setting, portals are looked up only in the player's own world, and searches read their settings once instead of on every step. Cached world and block lists mean placeholders and final safety checks no longer copy lists on each call.
Near and far. With distance-presets.enabled, /rtp near and /rtp far search between their own distances (100–1000 and 5000–20000 blocks by default). Players need dyrtp.near or dyrtp.far.
Go back once. With back.enabled, /rtp back takes a player back to where they stood before their last /rtp, sign or portal RTP, within back.expire-seconds (120). back.cooldown-seconds spaces out uses. Permission: dyrtp.back.
Statistics. With stats.enabled, DyRTP counts each player's successful RTPs: /rtp stats, /rtp stats <player> (dyrtp.stats.others) and %dyrtp_count%.
Commands after a teleport. after-teleport-commands runs console or player commands after a successful RTP, for example a starter kit, with {player}, {world}, {x}, {y} and {z}. first-rtp-only limits them to a player's first RTP.
Keep away from players. rtp.safety.avoid-players-radius rejects destinations within that many blocks of other players (0, off, by default).
Test a search. /dyrtp admin test [world] runs one search and reports its time and attempts without teleporting anyone.
Added in 1.3.0
Choose a world. With world-selection.enabled, /rtp world <world> (or /rtp <world>) searches in another world, for example the Nether. world-selection.worlds limits the choice, and dyrtp.world.<world> controls it per world.
Price and cooldown per world. rtp.worlds.<world>.price and rtp.worlds.<world>.cooldown give RTP into a world its own price and wait.
RTP signs. Administrators write [RTP] on a sign, with an optional world on the second line; right-clicking it starts an RTP.
Portal regions. /dyrtp admin portal pos1, pos2 and create <name> [world] turn an area into a portal: walking into it starts an RTP. Good for a spawn exit.
Added in 1.2.0
Folia. The same JAR runs on Bukkit, Spigot, Paper, Purpur and Folia. On Folia every destination is checked on the thread that owns it.
Ready spots. DyRTP finds a few safe spots per world ahead of time (rtp.queue.size, 3 by default), so /rtp can teleport without searching first. Each spot is checked again just before the teleport; if it changed, a live search takes over.
Travel together. /dyrtp group <player> invites friends; those who accept with /dyrtp group join come along on the leader's next /rtp when they stand within group.max-distance blocks. Up to group.max-size players (4).
Set a home there. With DyHomes installed, a successful RTP offers a click that prepares /sethome.
Added in 1.1.0
Choose a biome. /rtp biome <biome> finds a safe spot in the chosen biome, with TAB suggestions. Server owners can limit the choice with biome-selection.biomes or turn it off; blacklisted biomes such as oceans can never be chosen.
Ranks. dyrtp.cooldown.<seconds> and dyrtp.price.<amount> give a group its own cooldown or price (the lowest wins), and dyrtp.radius.<blocks> its own farthest distance (the highest wins). dyrtp.cooldown.0 removes the wait.
Placeholders. With PlaceholderAPI: %dyrtp_cooldown%, %dyrtp_cooldown_formatted%, %dyrtp_ready%, %dyrtp_price%, %dyrtp_price_formatted% and %dyrtp_world%.
More languages and MiniMessage. German, Spanish and Russian join English and Turkish. Messages accept & colour codes everywhere and, on Paper and Purpur, MiniMessage tags such as <gradient:#55ff55:#55ffff>.
First join and death. First-join and death RTP can send players to a chosen world with first-join-rtp.world and death-rtp.world. New installations read the vanilla /worldborder by default.
For developers. DyRTPAPI reports cooldown, price and destination world and can start an RTP. Anonymous bStats statistics can be turned off with metrics.enabled: false.
Changes in 1.0.1
Keep the destination ready. A bounded plugin chunk ticket retains the selected destination throughout warmup. Tickets are shared safely between requests and released after completion, cancellation, reload or shutdown; terrain and protection are still checked before teleport.
Stay free without a provider. Missing Vault or a registered economy provider keeps RTP free, including for ordinary players with older paid settings. Positive prices and enabling payments are rejected until a provider is detected. Provider transaction errors still stop paid requests safely.
Use shorter commands. /dyr is the player shortcut for /dyrtp; /dyra opens the existing admin branch with the same permissions and TAB suggestions. Help no longer includes a row describing the help command itself.
Choose your server build
| Server |
JAR |
| Bukkit, Spigot, Paper, Purpur, Folia |
DyRTP-1.4.0.jar |
Install one JAR per server. Stop the server and back up the complete DyRTP folder before replacing an older JAR. Existing world profiles, player preferences and custom translations are retained.
Java 17 bytecode; use the runtime required by your server. Minecraft 1.20.x–26.x is the release listing; the 1.3.0 live checks used Paper 26.2 and Folia 1.20.4.20.4, Folia 1.20.4, Spigot 26.3 and Paper 26.2. Optional integrations must support your selected server too. Historical 1.0.0 downloads retain their original filenames.
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

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
| Command |
Purpose |
/dyrtp or /dyr |
Search for a safe random destination |
/dyrtp help |
Show commands available to you |
/dyrtp biome <biome> |
Teleport to a random place in a chosen biome |
/dyrtp group <player> |
Invite a player to travel with your next RTP |
/dyrtp group join, decline, leave |
Answer an invitation or leave the group |
/dyrtp world <world> or /rtp <world> |
Teleport to a random place in another world |
/dyrtp near or /dyrtp far |
Teleport to a random place close by or far away |
/dyrtp back |
Return once to where you were before your last RTP |
/dyrtp stats [player] |
See how many times a player used RTP |
/dyrtp language <auto/en/tr/de/es/ru> |
Save your language preference |
/dyrtp confirm |
Confirm your current paid RTP request |
/dyrtp cancel |
Reject your pending confirmation |
/dyrtp admin help or /dyra |
Show administration commands |
/dyrtp admin force <player> |
Force RTP for an exact online player name |
/dyrtp admin economy <on/off> |
Enable or disable paid RTP |
/dyrtp admin price <amount> |
Set a finite, non-negative price |
/dyrtp admin cooldown <seconds/off> |
Configure the reuse cooldown |
/dyrtp admin delay <seconds/off> |
Configure the teleport warmup |
/dyrtp admin radius min <blocks> |
Configure the minimum radius |
/dyrtp admin radius max <blocks> |
Configure the maximum radius |
/dyrtp admin language <auto/en/tr/de/es/ru> |
Configure the global language |
/dyrtp admin reload |
Validate and reload settings and messages |
/dyrtp admin portal <pos1/pos2/create/delete/list> |
Manage RTP portal regions |
/dyrtp admin test [world] |
Test a search and show its time and attempts |
/dyr, /rtp, /randomtp, /wild, /wildtp, /forcertp and /rtpforce remain accepted. Help and TAB show the effective language, with the administration branch consistently named admin. Player names and other data arguments are never translated. Administrative settings and force commands work from the console; self-RTP and personal language changes require a player.
Legacy /confirm and /cancel registrations remain for compatibility. Other plugins can own those unqualified root commands. Use /dyrtp confirm or /dyrtp cancel; clickable buttons use /dyrtp:dyrtp and an expiring single-use request token, preventing an old button from approving a newer request or a DyClaim operation.
/dyra <operation> is equivalent to /dyrtp admin <operation>.
Language and permissions
Global language.default: en, tr, de, es or ru overrides saved preferences and client locale for messages, help and TAB. With auto, saved preference takes priority, then client locale when enabled, with English as the fallback. save-player-choice controls whether stored choices are used.
| Permission |
Bukkit default |
Purpose |
dyrtp.use |
true |
Self-RTP and confirmation |
dyrtp.admin |
op |
Administration, force RTP and update notices |
dyrtp.bypass.cooldown |
op |
Skip cooldown |
dyrtp.bypass.warmup |
op |
Skip warmup |
dyrtp.bypass.economy |
op |
Skip payment |
dyrtp.biome |
true |
Choose a biome with /dyrtp biome |
dyrtp.world.*, dyrtp.world.<world> |
true (*) |
Choose a world with /dyrtp world |
dyrtp.sign |
true |
Use RTP signs |
dyrtp.portal |
true |
Use RTP portal regions |
dyrtp.near, dyrtp.far |
true |
Near and far teleports |
dyrtp.back |
true |
Return once after an RTP |
dyrtp.stats, dyrtp.stats.others |
true, op |
Own and other players' RTP statistics |
dyrtp.cooldown.<seconds> |
not set |
Own cooldown; the lowest wins |
dyrtp.price.<amount> |
not set |
Own price; the lowest wins |
dyrtp.radius.<blocks> |
not set |
Own farthest distance; the highest wins |
Permission checks use Bukkit's effective permission result, including explicit denial. Being OP does not provide an additional unconditional bypass. Each bypass permission is checked separately; there is no new protection bypass.
Safety and operation lifecycle
World profiles retain center, square/circle radius, world-border, Y-range, biome and redirect settings. Normal worlds and the End use the highest motion-blocking surface excluding leaves; the Nether retains its vertical scan for ground and headroom. End void, liquids, waterlogged blocks, configured hazardous blocks, leaf ground and obstructed headroom are rejected. The existing configurable headroom and surface policies remain available.
Searches have configurable attempt, batch, time and server-wide concurrency limits. Defaults are 240 attempts, 32 cheap candidate checks per batch, 30 seconds and 16 concurrent searches. Each search waits for one candidate chunk load before requesting another, avoiding speculative generation. Loaded and rejected candidates still use the batch budget; rejected batches and failed loads continue on a later tick. Destination preloading retains its configured radius. load-chunks: false prevents generation of unloaded candidates. Bukkit world access, protection queries and teleport events execute on the server thread; supported async chunk loading only loads chunks. Already-started server chunk work cannot be undone, but late callbacks cannot apply a cancelled request.
A player has one active operation. Quit, death, external teleport/world change, reload and shutdown invalidate the relevant pending operation. Movement/damage cancellation applies during warmup according to the existing settings. Final validation uses fresh terrain and protection state after warmup and after supported teleport-event redirects; it rejects disabled worlds. Teleport failure or cancellation does not start cooldown or emit success. Successful teleport starts cooldown, preserving the original timing. Existing blindness is kept; cleanup only removes an effect matching DyRTP's own effect.
First-join and death RTP remain disabled by default. first-join-rtp.world and death-rtp.world send players to another world; an empty value keeps the current behaviour. Death RTP respects skip-if-bed-or-anchor. Their delay callbacks are invalidated by lifecycle changes. Forced RTP requires the administrator's permission and retains the existing cause policies for cooldown/payment.
Protection integrations
DyClaim is optional. When enabled in the protection settings and installed, DyRTP calls its existing getClaimManager().isChunkClaimed(worldName, chunkX, chunkZ) API without loading chunks. Signed block coordinates use arithmetic chunk conversion. Claimed chunks are excluded even for their owner or trusted players. Claims created after search are checked again before teleport.
DyClaim query/API errors and installed-but-disabled DyClaim stop RTP safely; warnings are rate limited. Explicitly disabling protection or the DyClaim hook retains the existing opt-out policy. protection.fail-closed controls errors from other adapters. Other existing reflection adapters remain, but their names in configuration are not proof of compatibility with every third-party version. Validate your installed integration versions separately.
Economy and confirmation
Player targets use their complete online name, including the Floodgate prefix (for example /dyrtp admin force .Player_Name). TAB preserves that prefix. Names are not stripped or guessed; .Player_Name and Player_Name remain separate targets. RTP, confirmation and saved preferences are bound to the player's UUID.
Paid RTP requires Vault and a registered economy provider. Without either, RTP remains free; positive prices and enabling payments are rejected until a provider is detected. Missing Vault, missing provider and transaction/query failures are logged separately. Invalid prices are rejected. The confirmation binds the player, cause, source/destination world and quoted price, and expires; permissions and settings are checked again. A changed price/world requires a new request.
The debit happens immediately before teleport. With economy.charge-on-success-only: true, a failed/cancelled teleport triggers one refund through the captured provider. With false, a successful debit can remain charged after a teleport failure. A successful teleport keeps its debit. Failed or uncertain withdrawals/refunds are never blindly retried; logs identify the player where reconciliation is required. Vault cannot guarantee atomic transactions across provider failures.
Configuration, upgrades and updates
Keep plugins/DyRTP/ when replacing the JAR. Missing defaults and message keys are added without resetting custom values or translations; the stock blue prefix/title text migrates to green when unchanged. Player preferences retain their YAML format. Malformed config/messages/player data and invalid bounded settings reject reload while preserving running settings. Administrative edits are validated separately before saving. Check the console when a reload/edit is rejected.
The existing Modrinth checker requests versions for the current Minecraft version and server loader every six hours. It selects stable releases, recognizes Beta-to-stable upgrades and links to the selected version. HTTP/parse errors are reported separately from an empty compatible feed. It notifies the console and players with dyrtp.admin; it does not install updates.
Build and verification
Release listing: Minecraft 1.20.x through currently available 26.x releases on Bukkit, Spigot, Paper, Purpur and Folia. Compile target: Java 17 and Purpur/Bukkit API 1.20.4. Runtime Java requirements follow your Minecraft server version. The 1.2.0 checks exercised Purpur 1.20.4 and Folia 1.20.4 on Java 21 and Spigot 26.3 and Paper 26.2 on Java 25; the listing is broader than the live matrix and does not establish verified compatibility with every Minecraft, Spigot, Purpur or protection-provider version.
gradle clean build
Use Gradle 9.1 with Java 25, or a Gradle/JDK combination supporting the Java 17 source target. The JAR is build/libs/DyRTP-1.4.0.jar. JUnit/Mockito tests are test dependencies only. See verification record for automated versus actual server coverage and limitations, and changelog for changes from the last stable 1.0.0 release.
An isolated BetterRTP comparison records common command-to-teleport measurements across five scenarios. Results vary by profile; they do not establish a universal performance or safety advantage.
License
DyRTP Source-Available License 1.0, the same terms as DyClaim: free to use and modify, no paid distribution, public source for distributed versions. It is a custom source-available license, not an OSI-approved open-source license. Versions up to 1.0.1 were distributed under LGPL-3.0-only and keep that license. See LICENSE.
Get started
- Stop the server and back up the current JAR and complete
plugins/DyRTP/ folder.
- Install
DyRTP-1.4.0.jar and start the server to generate any missing defaults.
- Configure your worlds, safety checks and messages.
- Run
/dyrtp admin reload to apply valid settings.
First-join and death RTP remain disabled until configured. Core RTP needs no other plugin; paid RTP requires Vault and an economy provider.
Source and support
Documentation · Report an issue · License
By Claww / DyPlugin.
评论 0
登录后参与评分
还没有评论,来抢沙发吧