已认证
tools · 作者：Vicuna
YuRandomTeleport 随机传送插件
主打 1.8.x-1.26.x 跨版本与 Spigot、Paper、Paper 衍生、Mohist、Arclight、Youer 等混合端适配。
随机传送RTP传送Vault跨版本混合端MohistArclightYouer工具
文档入口
YuRandomTeleport 是面向 Minecraft 1.8.x-1.26.x 的跨版本随机传送插件，重点适配 Spigot、Paper、Paper 衍生端，以及 Mohist、Arclight、Youer 等 Bukkit API 混合端。它围绕“找到安全落点、控制使用频率、按世界定价、允许管理员代传送”这几个核心流程设计，适合生存服资源世界、野外探索、活动世界、RPG 大地图和需要减少出生点拥挤的服务器。
安装部署构建、放置 jar、首次启动、Vault 经济接入和升级检查命令手册/yurtp 与 /rtp 的玩家用法、管理员代传送和重载命令配置说明世界黑白名单、半径、高度、安全方块、等待打断和自定义控制台命令权限节点普通玩家、管理员、绕过冷却、绕过费用和跳过等待插件联动Vault、bStats、命令回调、消息文件与可扩展接入方式常见问题找不到安全点、无法扣费、等待被取消、下界配置和世界限制排查
核心能力
| 能力 | 说明 |
|---|---|
| 广版本与混合端适配 | 面向 1.8.x-1.26.x，覆盖 Spigot、Paper、Paper 衍生端，并兼顾 Mohist、Arclight、Youer 等混合端运行环境。 |
| 安全随机传送 | 在配置半径内随机抽取 X/Z，加载区块后检查脚下方块、脚部空间、头部空间和头顶额外空气。 |
| 主世界与下界适配 | 普通世界使用最高地表作为候选点；下界会在高度范围内随机扫描 Y 轴，避免只抽少量高度导致卡墙。 |
| 世界访问控制 | 支持 world-blacklist 黑名单和 world-whitelist 白名单；白名单非空时优先生效。 |
| 按世界覆盖 | 每个世界可单独设置费用、半径、高度、安全检查、禁止方块和允许方块。 |
| 等待与打断 | 可配置传送前等待秒数；移动、受伤、交互、聊天、执行命令或离线可取消等待中的传送。 |
| 冷却与扣费 | 内置冷却；开启经济后通过 Vault 调用服务端经济插件扣费。 |
| 自定义反馈 | 可在传送开始、成功、失败时由控制台执行命令，适合接入 title、音效、广播、任务或日志系统。 |
| 自动配置升级 | 插件会根据 config-version 与 messages-version 合并默认配置并保留已有值。 |
| 统计接入 | 内置 bStats Bukkit 统计，插件 ID 为 30589。 |
快速开始
- 构建或获取发布版
YuRandomTeleport-1.1.2.2-all.jar。 - 将 jar 放入服务端
plugins/目录并启动一次服务器。 - 打开
plugins/YuRandomTeleport/config.yml，确认world-blacklist、半径和安全规则。 - 普通玩家使用
/rtp或/yurtp在当前世界随机传送。 - 管理员可用
/yurtp <玩家> [世界]将指定玩家随机传送到指定世界。 - 修改配置后执行
/yurtp reload重载配置与消息。
适合的服务器
| 场景 | 推荐用法 |
|---|---|
| 生存服 | 允许玩家离开主城后快速分散探索，设置合理冷却和等待打断。 |
| 资源世界 | 使用白名单只允许 resource、resource_nether 等世界执行随机传送。 |
| 经济服 | 开启 Vault 扣费，对不同世界设置不同成本。 |
| 活动服 | 使用 commands.on-success 发放标题、记录日志或触发活动系统。 |
| 高版本大地图 | 保持安全检查开启，并按世界设置高度范围和禁止方块。 |
当前版本定位
- 插件版本：
1.1.2.2 - 主类：
org.yutay.yurtp.YuRandomTeleport - 主命令：
/yurtp - 别名：
/rtp - Java 目标版本：Java 8
- 兼容定位：Minecraft
1.8.x-1.26.x，Spigot、Paper、Paper 衍生端、Mohist、Arclight、Youer 等混合端 - 软依赖：Vault
- bStats 插件 ID：
30589 - 默认配置版本：
config-version: 5 - 默认消息版本：
messages-version: 4
