YuTeleport
🎲 YuTeleport / YuTP 跨版本安全传送插件
🛡️安全落点 | 🧭随机传送 | 📍Warp | 🏠Home | 🤝TPA | 🔙Back | 📡坐标分享 | 🧵Folia 支持
😱 随机传送怕玩家落进岩浆、水下、墙体、虚空边缘或下界危险平台?
🧭 想把资源世界散点、公共传送点、玩家 home、TPA、/back 和坐标分享统一交给一个插件管理?
🐌 不想让传统传送插件在搜索区块时卡主线程,也不想分别维护冷却、扣费、权限和消息?
🔧 不想让多个插件同时抢 /warp、/home、/tpa、/back,还要逐个排查冲突?
YuTeleport(YuTP) 是一款面向 Minecraft Java 服务器的跨版本安全传送套件。
它不是单一的 RTP 工具,而是一套完整的传送系统:随机传送、公共 warp、玩家 home、TPA 同意制互传、/back 返回、坐标分享、经济扣费、权限分组、PlaceholderAPI、公共 Java API、Folia/Paper 兼容,都由同一套传送管线处理。
当前版本:2.0.1.2
配置版本:config-version 20
---
🚀 核心卖点
- 🧭 随机传送 RTP:按世界配置半径、高度、中心点、方形/圆形分布、方块规则和生物群系过滤。
- 📍 Warp 公共传送点:支持 public、private、restricted 类型,支持描述、重命名、删除、数量上限和精确权限。
- 🏠 Home 玩家家:每名玩家独立保存 home,支持多 home、公开 home、跨玩家访问、描述和数量扩容。
- 🤝 TPA 玩家互传:支持
/tpa、/tpahere、接受、拒绝、撤回、忽略请求和全服 tpahere。 - 🔙 Back 返回系统:记录死亡点、插件传送前位置和外部传送前位置,支持
/back、/back death、/back list、/back clear。 - 📡 坐标分享:传送成功后可把当前位置分享给全服在线玩家,其他玩家点击即可传送。
- 🧩 统一传送管线:等待、打断、冷却、扣费、退款、安全复核、事件、状态记录和 hooks 统一处理。
- ⚡ 异步安全点搜索:Paper 1.13+ 可使用异步区块加载降低主线程压力,不支持时自动回退同步模式。
- 📦 落点预缓存:后台提前准备安全落点,命中缓存时可减少在线搜索等待。
- 🌿 生物群系过滤:支持黑/白名单、
*通配符和单次biome:<模式>指定。 - 💰 Vault / PlayerPoints 经济:按传送类型、世界和权限组定价,失败、取消或 Folia retired 场景会自动退款。
- 👥 权限分组覆盖:通过
yuteleport.group.<组名>配置不同冷却、费用、warp 上限和 home 上限。 - ⏳ 多通道倒计时:聊天、BossBar、ActionBar、静默等待可自由组合,移动、受伤、交互、聊天和命令打断可逐项开关。
- 🎵 完整视听反馈:倒计时音效、成功琶音、失败/取消/扣费/退款音效、标题、粒子、点击重试和悬停坐标。
- 📊 PlaceholderAPI 扩展:提供模块状态、冷却、费用、home/warp 数量、传送状态、统计数据和 back 状态。
- 🧑💻 Java API 与事件:外部插件可发起传送、读取模块数据、监听和取消传送生命周期事件。
- 🧵 Folia 调度适配:使用 Region / Entity / Global Scheduler,避免跨区域实体访问问题。
---
🧠 设计目标
YuTeleport 的目标不是“把玩家传走”这么简单,而是让一次传送从请求到抵达都可控、可回滚、可观察。
- 玩家是否有权限?
- 目标世界是否允许?
- 是否仍在冷却?
- 是否需要等待倒计时?
- 等待期间是否移动、受伤、聊天或执行命令?
- 是否需要扣费?余额在等待期间变化后如何处理?
- 目标点是否安全?目标世界是否仍然加载?
- 传送失败、取消或实体退休时是否退款?
- 第三方插件是否能监听、取消或读取结果?
- 玩家能否返回死亡点或上一次传送前的位置?
这些逻辑不再散落在多个插件或多个模块里,而是由统一传送管线处理。服主可以把它作为正式服的基础传送系统,而不是临时散点工具。
---
🧩 功能模块
🧭 随机传送 RTP
适合资源世界、野外探索、新人散点、活动地图和需要减少出生点拥挤的服务器。
- 每个世界独立配置半径、费用、高度范围、安全规则和搜索策略。
- 支持自定义随机中心点,不必固定围绕
(0, 0)。 - 支持方形环带或按面积均匀分布的圆形环带。
- 支持世界黑/白名单和
*通配符。 - 支持方块黑/白名单,排除岩浆、火焰、仙人掌、甜浆果丛、蜘蛛网等危险方块。
- 支持生物群系黑/白名单,例如
OCEAN、FOREST。 - 支持 Paper 异步区块加载、Folia 区域调度和同步兼容模式。
- 支持后台安全落点预缓存,降低高频传送时的在线搜索开销。
常用命令
/yuteleport
/ytp
/rtp
/yuteleport biome:*FOREST*
/yuteleport <玩家>
/yuteleport <玩家> <世界> biome:*PLAINS*📍 Warp 公共传送点
适合主城、资源世界入口、活动场地、商店区、副本入口和玩家自建公共点位。
/setwarp <名称>创建或更新 warp。publicwarp 可公开给全服玩家查看和使用。privatewarp 仅创建者和管理员可管理。restrictedwarp 需要yuteleport.warps.<名称>才可见、可用。- 支持描述、重命名、公开/取消公开、删除。
- 支持默认数量上限、权限上限和
groups.<组名>.warp.max-warps扩容。 - 权限过期后超额 warp 不会被删除,只会临时锁定,恢复权限后可继续使用。
- 创建公开 warp、使用公开 warp、普通 warp 传送都可单独设置费用。
常用命令
/warp
/warp <名称>
/warp public
/warp public <名称> true
/warp rename <旧名称> <新名称>
/warp desc <名称> <描述>
/setwarp <名称> [restricted|public|private] [描述]
/delwarp <名称>🏠 Home 玩家家
适合生存服、养老服、RPG 服、空岛服和需要玩家自主管理返回点的服务器。
/sethome [名称]设置个人 home,缺省名为home。/homes查看自己的 home 列表。- 玩家可公开自己的 home,其他在线玩家可查看并传送。
- 每个 home 可设置描述。
- 支持重命名、修改描述、公开/取消公开、删除。
- 管理员可查看或使用在线玩家的 home。
- 支持默认 home 上限、权限上限和
groups.<组名>.home.max-homes扩容。 - 权限过期后超额 home 不会被删除,只会临时锁定。
- 可配置禁止设置 home 的世界,例如活动世界、矿界或副本世界。
- 每名玩家独立文件保存,上线加载、下线释放内存。
常用命令
/home
/home <名称>
/home list
/home public
/home public <名称> true
/home rename <旧名称> <新名称>
/home desc <名称> <描述>
/home <玩家>:<名称>
/homes
/homes <玩家>
/sethome [名称] [public|private] [描述]
/delhome <名称>
/delhome <玩家>:<名称>🤝 TPA 玩家互传
适合玩家互访、组队探索、活动集合和常规生存服互传。
/tpa <玩家>请求传送到对方身边。/tpahere <玩家>邀请对方传送到自己身边。/tpaccept [玩家]接受请求。/tpdeny [玩家]拒绝请求。/tpacancel撤回自己的外发请求。/tpaignore临时忽略发给自己的 TPA 请求。/tpaall或/tpahere all向全服玩家发送 tpahere 请求。- 请求会自动过期,过期后需要重新发送。
- 新请求会替换自己的上一条外发请求,避免请求簿无限增长。
- 目标玩家可收到可点击的接受/拒绝按钮。
tpahere中被移动的是接受方,但费用和冷却归属请求发起者。
常用命令
/tpa <玩家>
/tpahere <玩家>
/tpahere all
/tpaccept [玩家]
/tpdeny [玩家]
/tpacancel
/tpaignore
/tpaall🔙 Back 返回系统
/back 适合死亡找回、传送误操作回退、跨插件传送后返回原位置等场景。
/back返回最近可用位置。/back death返回最近死亡点。/back list查看可返回历史,开启交互聊天时可点击指定记录返回。/back clear清空自己的 back 历史。- 支持记录插件内部传送前位置、玩家死亡位置和外部插件传送前位置。
- 支持按距离过滤,默认小于 3 格的移动不记录,避免刷屏。
- 支持最大历史条数,默认保留 5 条。
- 支持过期时间,默认 1800 秒。
- 支持持久化,玩家 back 历史会保存到
data/back。 - 支持独立暖场、冷却、费用、安全救援、世界黑白名单和 hooks。
- 支持选择优先级,默认优先返回死亡点,其次插件传送前位置,再次外部传送前位置。
常用命令
/back
/back death
/back list
/back clear核心配置
teleports:
back:
enabled: true
commands:
back: [back]
warmup-seconds: 5
cooldown-seconds: 10
cost: 0.0
safety-rescue: true
max-history: 5
expire-seconds: 1800
persist: true
capture:
plugin-teleports: true
death: true
external-teleports: true
include-types: [random, warp, home, tpa, share, back]
min-distance: 3.0
priority: [death, teleport, external]📡 坐标分享
适合临时集合点、资源发现、活动坐标、队友集合和探索分享。
玩家传送成功后,成功消息可附带“分享当前位置”按钮。点击后插件会向全服在线玩家广播坐标分享,其他玩家可点击传送。
- 分享有有效期,过期自动失效。
- 分享行为有独立冷却。
- 内存中保留的活跃分享数量有上限,防止长期堆积。
- 发起分享和点击分享传送可分别收费。
- 坐标分享可继承或单独配置世界黑/白名单。
常用命令
/yuteleport share
/yuteleport join <分享编号>---
🛡️ 安全落点与救援
YuTeleport 会在随机传送前检查
- 玩家脚下方块是否可承载。
- 玩家身体和头部空间是否足够。
- 头顶额外空气高度是否满足配置。
- 水、岩浆、火焰、仙人掌、蜘蛛网、岩浆块等危险方块。
- 虚空、世界最低/最高高度、世界边界。
- 生物群系黑/白名单。
- 下界等复杂维度的纵向候选位置。
这可以降低以下问题出现概率
- 玩家卡墙、卡方块。
- 传入岩浆、水下或危险方块。
- 传到世界边界外或边界线上。
- 传到虚空边缘或悬空位置。
- 下界随机到无可站立平台的位置。
固定点模块(warp、home、tpa、share、back)默认尊重设置者记录的坐标,不强制重新搜索随机安全点。如果担心点位被破坏,可开启对应模块的 safety-rescue,抵达后执行卡方块救援。
---
🌍 世界访问与独立配置
YuTeleport 支持全局默认世界访问规则,也支持每个模块覆盖:
teleports.defaults.world-access
teleports.rtp.world-access
teleports.warp.world-access
teleports.home.world-access
teleports.tpa.world-access
teleports.share.world-access
teleports.back.world-access世界名单支持 `*` 通配符
lobby
resource_*
*_nether
*event*
*典型用法
- 主世界:中等半径、低费用、排除海洋。
- 资源世界:超大半径、高费用、开启异步搜索和预缓存。
- 下界:限制高度、提高尝试次数、设置可落脚方块白名单。
- 活动世界:只允许指定模块进入,或完全加入黑名单。
- 大厅世界:禁用
/back或所有玩家发起的传送。
---
⚡ 异步搜索与预缓存
传统 RTP 在传送时同步加载新区块,高峰期容易造成卡顿。YuTeleport 提供两种优化方式。
异步安全点搜索
teleports:
rtp:
search-mode: async在 Paper 1.13+ 及兼容核心上,插件会使用异步区块加载寻找随机落点。当前服务端不支持时,插件会自动回退同步模式并输出提示。Folia 服务端会按区域调度模型执行,不依赖传统主线程假设。
落点预缓存
teleports:
rtp:
precache:
enabled: true
size: 3插件可在后台为每个世界提前准备 1-16 个安全落点。玩家发起随机传送时如果命中缓存,会跳过在线搜索阶段,直接进入传送复核和后续流程。
---
⏳ 倒计时、打断与反馈
所有传送模块都可以使用统一等待倒计时。
teleports:
defaults:
warmup-seconds: 5
countdown-display: actionbar
cancel-on-move: true
cancel-triggers:
move: true
damage: true
interact: true
chat: true
command: true支持显示通道
- 聊天
- BossBar
- ActionBar
- 静默等待
支持打断条件
- 移动
- 受伤
- 交互
- 聊天
- 执行命令
拥有 yuteleport.bypass.wait 权限的玩家可跳过等待。
拥有 yuteleport.bypass.cooldown 权限的玩家可跳过冷却。
拥有 yuteleport.bypass.cost 权限的玩家可跳过收费。
---
💰 经济系统
economy:
enabled: true
provider: vault # vault 或 playerpoints支持能力
- Vault 金币经济。
- PlayerPoints 点券经济。
- RTP 按世界定价。
- Warp / Home / TPA / Share / Back 按模块定价。
- 权限组覆盖费用。
- 余额不足提示。
- 等待结束后的二次余额校验。
- 传送失败、取消或 Folia retired 场景自动退款。
- 重复传送保护,避免重复扣费。
PlayerPoints 点券为整数货币,费用会向上取整,退款按同一规则返还。
---
👥 权限组覆盖
groups:
vip:
rtp:
cooldown-seconds: 10
cost: 5.0
warp:
cooldown-seconds: 2
max-warps: 40
home:
cooldown-seconds: 2
max-homes: 20
tpa:
cooldown-seconds: 5
cost: 0.25
mvp:
rtp:
cooldown-seconds: 0
cost: 0.0
warp:
cooldown-seconds: 0
cost: 0.0
max-warps: 100
home:
cooldown-seconds: 0
cost: 0.0
max-homes: 50
tpa:
cooldown-seconds: 0
cost: 0.0玩家拥有 yuteleport.group.vip 或 yuteleport.group.mvp 权限后,会自动套用对应配置。多个组同时匹配时,按配置文件顺序取第一个。
可实现
- 普通玩家有标准冷却和费用。
- VIP 降低冷却,提高 home/warp 数量。
- MVP 无冷却、免费传送。
- 活动期间临时降低某组费用。
---
🧰 命令速览
RTP
/yuteleport
/ytp
/rtp
/yuteleport biome:<模式>
/yuteleport <玩家>
/yuteleport <玩家> <世界>
/yuteleport <玩家> <世界> biome:<模式>
/yuteleport reload
/yuteleport helpWarp
/warp
/warp <名称>
/warp public
/warp public <名称> true
/warp rename <旧名称> <新名称>
/warp desc <名称> <描述>
/setwarp <名称> [restricted|public|private] [描述]
/delwarp <名称>Home
/home
/home <名称>
/home list
/home public
/home public <名称> true
/home rename <旧名称> <新名称>
/home desc <名称> <描述>
/home <玩家>:<名称>
/homes
/homes <玩家>
/sethome [名称] [public|private] [描述]
/delhome <名称>
/delhome <玩家>:<名称>TPA
/tpa <玩家>
/tpahere <玩家>
/tpahere all
/tpaccept [玩家]
/tpdeny [玩家]
/tpacancel
/tpaignore
/tpaallBack
/back
/back death
/back list
/back clear坐标分享
/yuteleport share
/yuteleport join <分享编号>命令名称和别名可在配置中修改。模块关闭时不会注册对应命令,避免与 EssentialsX、CMI 等插件发生不必要冲突。
---
🔑 权限速览
| 权限 | 说明 | 默认 |
|---|---|---|
| yuteleport.use | 使用随机传送 | 所有人 |
| yuteleport.biome | 使用 biome:<模式> 指定目标生物群系 | OP |
| yuteleport.teleport.others | 用主命令传送其他玩家 | OP |
| yuteleport.reload | 重载配置 | OP |
| yuteleport.warp.use | 使用 warp | 所有人 |
| yuteleport.warp.set | 创建或更新 warp | 所有人 |
| yuteleport.warp.delete | 删除自己的 warp | 所有人 |
| yuteleport.warp.public | 公开或取消公开自己的 warp | 所有人 |
| yuteleport.warp.admin | 编辑、删除所有玩家的 warp | OP |
| yuteleport.warp.limit.<数量> | 动态提高 warp 数量上限 | 权限插件分配 |
| yuteleport.warp.limit.unlimited | warp 数量无限 | 权限插件分配 |
| yuteleport.warp.limit.bypass | 无视 warp 数量过期锁定 | OP |
| yuteleport.warps.<名称> | 使用指定 restricted warp | OP |
| yuteleport.home.use | 使用 home 并查看自己的 home | 所有人 |
| yuteleport.home.set | 创建或更新 home | 所有人 |
| yuteleport.home.delete | 删除 home | 所有人 |
| yuteleport.home.others | 查看或使用在线玩家的 home | OP |
| yuteleport.home.public | 公开或取消公开自己的 home | 所有人 |
| yuteleport.home.limit.<数量> | 动态提高 home 数量上限 | 权限插件分配 |
| yuteleport.home.limit.unlimited | home 数量无限 | 权限插件分配 |
| yuteleport.home.limit.bypass | 无视 home 数量过期锁定 | OP |
| yuteleport.tpa.use | 使用 tpa、tpaccept、tpdeny、tpacancel | 所有人 |
| yuteleport.tpa.here | 使用 tpahere | 所有人 |
| yuteleport.tpa.ignore | 忽略发给自己的 TPA 请求 | 所有人 |
| yuteleport.tpa.all | 向全服玩家发送 tpahere 请求 | OP |
| yuteleport.share | 分享传送成功后的当前位置 | 所有人 |
| yuteleport.back.use | 使用 /back | 所有人 |
| yuteleport.back.death | 使用 /back death | 所有人 |
| yuteleport.back.clear | 清空自己的 back 历史 | 所有人 |
| yuteleport.back.admin | back 管理权限预留 | OP |
| yuteleport.bypass.cooldown | 跳过传送冷却 | OP |
| yuteleport.bypass.cooldown.others | 管理员传送他人时无视目标冷却 | OP |
| yuteleport.bypass.cost | 跳过传送收费 | OP |
| yuteleport.bypass.wait | 跳过等待倒计时 | OP |
| yuteleport.group.<组名> | 套用对应权限组配置 | 权限插件分配 |
---
📊 PlaceholderAPI、Java API 与事件
PlaceholderAPI 安装后可使用 %yuteleport_*% 占位符。
常用示例
%yuteleport_version%
%yuteleport_platform%
%yuteleport_search_mode%
%yuteleport_random_enabled%
%yuteleport_warp_enabled%
%yuteleport_home_enabled%
%yuteleport_tpa_enabled%
%yuteleport_share_enabled%
%yuteleport_back_enabled%
%yuteleport_cooldown_random%
%yuteleport_cooldown_warp%
%yuteleport_cooldown_home%
%yuteleport_cooldown_tpa%
%yuteleport_cooldown_share%
%yuteleport_cooldown_back%
%yuteleport_cost_random%
%yuteleport_cost_warp%
%yuteleport_cost_home%
%yuteleport_cost_tpa%
%yuteleport_cost_share%
%yuteleport_cost_back%
%yuteleport_home_count%
%yuteleport_home_max%
%yuteleport_visible_warp_count%
%yuteleport_tpa_pending_count%
%yuteleport_success_rate%适合用于
- 计分板
- TAB 列表
- 菜单插件
- 任务插件
- 成就系统
- 数据统计面板
开发者可通过 Bukkit ServicesManager 获取公共 Java API:
RegisteredServiceProvider<YuTeleportApi> registration =
Bukkit.getServicesManager().getRegistration(YuTeleportApi.class);
YuTeleportApi api = registration == null ? null : registration.getProvider();API 可发起随机传送、warp 传送、home 传送、back 传送和 TPA 请求,读取模块启用状态、冷却、费用、warp/home 列表和传送统计。
生命周期事件
PlayerTeleportStartEventPlayerTeleportDestinationEventPlayerTeleportCancelEventPlayerTeleportCompleteEvent
命令和 API 共用同一套入口,第三方插件不会绕过权限、世界访问、冷却、等待、经济或安全规则。
---
🧱 兼容范围
Minecraft 版本
插件以跨版本兼容为目标,面向 Minecraft 1.8.x - 1.26.x 的 Bukkit / Spigot / Paper 生态。
不同能力会自动探测并降级
- BossBar:1.9+ 支持,不支持时回退其他倒计时通道。
- ActionBar / Title:支持时启用,旧版本自动跳过或降级。
- 粒子效果:1.9+ 支持,不支持时不影响传送。
&#RRGGBB十六进制颜色:1.16+ 原生显示,旧版本自动降级到传统颜色。- Paper 异步区块加载:支持时可用于异步搜索和预缓存,不支持时回退同步搜索。
- 1.18+ 世界高度:自动读取世界最低/最高高度,兼容负高度世界。
服务端核心
- CraftBukkit / Spigot
- Paper / Purpur / Leaves 及多数 Paper 衍生核心
- Folia
- Youer / Arclight / Mohist / CatServer 等混合端
- 其他遵循 Bukkit / Spigot / Paper API 的服务端核心
软依赖
- Vault:启用金币经济时使用。
- PlayerPoints:启用点券经济时使用。
- PlaceholderAPI:安装后自动注册
%yuteleport_*%占位符。
未安装软依赖时,插件仍可独立运行;对应联动能力会自动跳过或输出明确提示。
---
⚙️ 配置示例
language:
default: zh_CN
use-player-locale: true
economy:
enabled: true
provider: vault
cooldowns:
persist: true
teleports:
defaults:
warmup-seconds: 5
countdown-display: actionbar
cancel-on-move: true
cancel-triggers:
move: true
damage: true
interact: true
chat: true
command: true
world-access:
blacklist:
- lobby
- "playerworld*"
whitelist: []
rtp:
enabled: true
warmup-seconds: -1
cooldown-seconds: 5
search-mode: async
precache:
enabled: true
size: 3
worlds:
default:
cost: 15.0
shape: circle
center:
x: 0
z: 0
radius:
min: 500
max: 10000
safety:
check: true
allow-void: false
allow-water: false
allow-lava: false
max-attempts: 32
min-air-above: 8
blocked-materials:
- "MAGMA*"
- "CACTUS"
- "SWEET_BERRY_BUSH"
- "COBWEB"
- "*FIRE*"
allowed-materials: []
blocked-biomes:
- "*OCEAN*"
allowed-biomes: []
warp:
enabled: true
warmup-seconds: 5
cooldown-seconds: 3
cost: 0.0
max-warps: 1
public:
enabled: true
publish-cost: 0.0
teleport-cost: 0.0
home:
enabled: true
warmup-seconds: 5
cooldown-seconds: 3
cost: 0.0
max-homes: 2
world-blacklist: []
public:
enabled: true
publish-cost: 0.0
teleport-cost: 0.0
tpa:
enabled: true
request-timeout-seconds: 60
warmup-seconds: 5
cooldown-seconds: 10
cost: 0.0
share:
enabled: true
cooldown-seconds: 60
expire-seconds: 120
max-active: 256
cost: 0.0
teleport-cost: 0.0
back:
enabled: true
warmup-seconds: 5
cooldown-seconds: 10
cost: 0.0
safety-rescue: true
max-history: 5
expire-seconds: 1800
persist: true
effects:
sounds:
enabled: true
titles:
enabled: true
particles:
enabled: true
smooth-bossbar: true
interactive-chat: true---
🎯 适合这些服务器
- 生存服
- 养老服
- 资源世界服务器
- RPG 大地图服务器
- 空岛拓展世界
- 科技 / 粘液科技服务器
- 商店区、主城和公共设施较多的服务器
- 活动世界服务器
- 硬核 / 大逃杀玩法服务器
- Paper / Purpur 高性能服务器
- Folia 多线程服务器
- Bukkit 混合端服务器
- 需要统一传送系统和玩家分流的服务器
---
🔗 官方链接
- 插件文档:https://vicuna-main.github.io/YuPluginHub/plugins/items/yu-teleport/
- Modrinth 下载页:https://modrinth.com/plugin/yuteleport
- 问题反馈:https://github.com/vicuna-main/YuTeleportIssueReport
- 官方交流群:https://qm.qq.com/q/xiwJYBYdh0
- 赞助作者:https://afdian.com/a/vicuna
---
🎲 YuTeleport
不是简单地随机坐标,也不是零散命令拼接,而是一套面向正式服的安全传送系统。
🧭 随机传送、📍Warp、🏠Home、🤝TPA、🔙Back、📡坐标分享、💰经济联动、👥分组权限、⏳统一倒计时、🛡️安全落点、🧵Folia 调度、📊PAPI 占位符和 🧑💻 Java API 都已经整合在 YuTeleport 中。
把服务器传送从“能用”升级成“统一、可控、可维护”。