YuRandomTeleport 命令手册
主命令为 /yurtp，别名为 /rtp。玩家常用 /rtp，管理员和脚本系统建议使用完整命令 /yurtp。
命令总览
| 命令 | 权限 | 执行者 | 说明 |
|---|---|---|---|
/yurtp | yurtp.use | 玩家 | 将自己随机传送到当前世界的安全位置。 |
/rtp | yurtp.use | 玩家 | /yurtp 的别名。 |
/yurtp help | 无固定权限；按权限显示内容 | 玩家或控制台 | 查看帮助。 |
/yurtp reload | yurtp.reload | 玩家或控制台 | 重载 config.yml 与 messages.yml。 |
/yurtp <玩家> | yurtp.teleport.others | 管理员或控制台 | 将指定在线玩家随机传送到其当前世界。 |
/yurtp <玩家> <世界> | yurtp.teleport.others | 管理员或控制台 | 将指定在线玩家随机传送到指定世界。 |
玩家随机传送
text
/rtp
/yurtp执行后插件会：
- 检查玩家是否有
yurtp.use。 - 检查冷却。
- 检查当前世界是否允许随机传送。
- 根据当前世界配置读取费用、半径、高度和安全规则。
- 如果开启经济且玩家余额足够，进入等待或直接寻找安全点。
- 成功传送后扣费并刷新冷却。
如果找不到安全位置，插件会移除本次冷却，玩家可以立即重试。
管理员代传送
text
/yurtp Steve
/yurtp Steve resource代传送时需要 yurtp.teleport.others。目标玩家仍然需要拥有 yurtp.use，这样可以避免管理员命令绕过服务器的基础使用授权。
代传送会使用目标玩家所在世界或命令中指定世界的配置。若目标玩家正在冷却，默认会阻止本次传送；拥有 yurtp.bypass.cooldown 的目标玩家可绕过冷却。
重载配置
text
/yurtp reload重载会重新读取：
config.ymlmessages.yml- 世界配置覆盖
- 自定义控制台命令
- Vault 经济挂钩状态
重载不会清空已存在的玩家冷却表。如果需要彻底清空运行状态，应重启服务器。
帮助命令
text
/rtp help
/yurtp help帮助内容会根据执行者权限显示。拥有 yurtp.reload 时会显示重载命令。
Tab 补全
第一段参数会补全：
reloadhelp- 在线玩家名
- 已加载世界名
第二段参数会补全已加载世界名。
使用示例
| 目标 | 命令 |
|---|---|
| 玩家在当前世界随机传送 | /rtp |
| 管理员将 Alex 传送到当前所在世界的随机点 | /yurtp Alex |
| 管理员将 Alex 传送到资源世界 | /yurtp Alex resource |
| 修改配置后热重载 | /yurtp reload |
行为细节
- 控制台不能在不指定玩家时执行
/yurtp，因为控制台没有当前位置。 - 如果指定世界不存在，会返回
world-not-found消息。 - 白名单非空时，只有白名单中的世界允许随机传送。
teleport.wait-seconds大于0且玩家没有yurtp.bypass.wait时，玩家会进入等待倒计时。- 等待期间移动位置、受伤、交互、聊天、执行命令或离线，会取消传送并移除本次冷却。