
tools · 作者:Vicuna
YuTeleport (YuTP) 传送套件
2.0.1.0 将旧 YuRTP 升级为完整安全传送套件,覆盖 warp、home、tpa、/back、坐标分享、PlayerPoints、预缓存、更新检查与更完整的 API/PAPI。
随机传送RTP传送WarpHomeTPABack死亡返回VaultPlayerPointsPlaceholderAPIFoliaAPI跨版本混合端MohistArclightYouer工具
文档入口
YuTeleport 2.0.1.0,简称 YuTP,是从旧 YuRTP 随机传送插件演进而来的跨版本安全传送套件。它把随机传送、warp、home、tpa、坐标分享、/back 历史返回、经济扣费、权限分组、Folia/Paper 兼容、PlaceholderAPI 与公开 Java API 放进同一套传送管线。
安装部署构建、放置 jar、首次启动、可选依赖、升级检查和卸载路径命令手册/yuteleport、/ytp、/rtp、warp、home、tpa、back 与坐标分享命令配置说明模块开关、世界规则、经济、冷却、/back 历史、预缓存、音效标题和权限组权限节点随机传送、warp、home、tpa、back、分享、绕过权限与动态上限PlaceholderAPI%yuteleport_*% 状态、冷却、模块、世界、费用和统计变量Bukkit 事件开始、目标点、取消与完成四个泛化传送生命周期事件Java APIRTP、warp、home、tpa、back、冷却、列表、费用、快照和平台检测常见问题命令兼容、经济、世界限制、安全点、back、PAPI、Folia 与配置升级排查
核心能力
| 能力 | 说明 |
|---|---|
| 广版本与混合端适配 | 面向 Minecraft 1.8.x-1.26.x,覆盖 Spigot、Paper、Paper 衍生端、Folia,并兼顾 Mohist、Arclight、Youer 等混合端运行环境。 |
| 随机传送 | /yuteleport、/ytp 与 /rtp 共用安全点搜索,支持方形/圆形范围、世界中心点、高度限制、生物群系黑白名单和后台预缓存。 |
| warp 模块 | 支持 /warp、/setwarp、/delwarp,可创建私有、公开或 restricted warp,并通过权限控制数量和可见性。 |
| home 模块 | 支持 /home、/homes、/sethome、/delhome,可公开 home,支持按权限和分组扩展 home 数量。 |
| tpa 模块 | 支持 /tpa、/tpahere、/tpaccept、/tpdeny、/tpacancel、/tpaignore 与全服 tpahere 请求。 |
| 坐标分享 | 传送成功后可点击分享当前位置,其他玩家可在有效期内点击传送到该坐标。 |
/back 历史返回 | 可记录插件传送、死亡和外部传送前位置,支持 /back、/back death、历史列表、过期、持久化和安全救援。 |
| 经济扣费 | 可选接入 Vault 或 PlayerPoints,RTP、warp、home、tpa、分享和 back 可分别配置费用。 |
| 冷却与等待 | 各模块独立冷却和等待时间,支持持久化冷却,移动、受伤、交互、聊天和命令可按项打断。 |
| 权限组覆盖 | 通过 groups 与 yuteleport.group.<组名> 覆盖不同玩家组的冷却、费用、home 数量和 warp 数量。 |
| 视听反馈 | 支持聊天、BossBar、ActionBar 倒计时,内置标题、粒子、音效、交互式点击重试和坐标悬停。 |
| 插件联动 | 公开 YuTeleportApi,通过 Bukkit ServicesManager 注册,并提供 PlayerTeleport* 生命周期事件。 |
| PlaceholderAPI | 注册 %yuteleport_*%,覆盖全局状态、玩家冷却、模块可用性、世界规则、费用、warp/home/tpa/back 统计。 |
| 官方链接 | 插件启动和默认配置内置文档、Modrinth、Issue、QQ 群与爱发电链接。 |
| 统计接入 | 内置 bStats Bukkit 统计,插件 ID 为 32443。 |
快速开始
- 构建或获取发布版
YuTeleport-2.0.1.0-all.jar。 - 将 jar 放入服务端
plugins/目录并启动一次服务器。 - 打开
plugins/YuTeleport/config.yml,检查teleports.defaults.world-access、teleports.rtp.worlds.default、经济和冷却设置。 - 普通玩家使用
/rtp、/ytp或/yuteleport在当前世界随机传送。 - 按需要启用
/warp、/home、/tpa、/back和坐标分享,并分配对应权限。 - 修改配置或语言文件后执行
/yuteleport reload热重载。
适合的服务器
| 场景 | 推荐用法 |
|---|---|
| 生存服 | 使用随机传送和 home,减少出生点拥挤,并设置合理冷却和等待打断。 |
| 资源世界 | 通过世界白名单只允许资源世界 RTP,并用预缓存降低瞬时搜索开销。 |
| 经济服 | 使用 Vault 或 PlayerPoints 对 RTP、warp、home、tpa、back 和分享分别定价。 |
| RPG/活动服 | 使用 warp、tpa、back、坐标分享和命令钩子接入活动、任务、广播或日志系统。 |
| 混合端 | 保持安全检查开启,按世界配置高度、方块、生物群系和黑白名单。 |
当前版本定位
- 插件版本:
2.0.1.0 - 主类:
org.yutay.yuteleport.YuTeleport - 主命令:
/yuteleport - 别名:
/ytp、/rtp - 模块命令:
/warp、/setwarp、/delwarp、/home、/homes、/sethome、/delhome、/tpa、/tpahere、/tpaccept、/tpdeny、/tpacancel、/tpaignore、/tpaall、/back - Java 目标版本:Java 8
- 编译 API:Spigot API
1.8-R0.1-SNAPSHOT - 兼容定位:Minecraft
1.8.x-1.26.x,Bukkit/Spigot/Paper/Purpur/Folia 与兼容 Bukkit API 的混合端 - 软依赖:Vault、PlaceholderAPI、PlayerPoints
- Folia 声明:
folia-supported: true - bStats 插件 ID:
32443 - 默认配置版本:
config-version: 20 - 内置语言:
zh_CN、en_US
