原创 工具 娱乐 经济 YuTP --- 1.8.x-1.26.x现代化的游戏内传送插件 支持Paper/Spigot/Folia/Purpur/Youer/Arclight/等等 高度定可制 2.0.1.5

YuTP 传送插件 v2.0.1.5 燃情更新
1. 修复actionbar颜色符号异常bug
2. 修复actionbar传送成功后不显示100%进度的bug

YuTeleport v2.0.1.4 新版发布
修复一些bug

YuTeleport 2.0.1.2 更新日志
修复一些bug

[MD] 🎉 **YuTeleport 2.0.1.0 更新日志** 🎉 --- 📦 **版本升级**：`2.0.0.0` → `2.0.1.0` 🔥 **核心亮点**：新增 `/back` 返回模块，追忆你的每一步！ --- ✨ **新增内容** 🔹 **返回指令全家桶** - `/back` —— 返回最近一次可返回位置 📍 - `/back death` —— 返回最近死亡点 💀 - `/back list` —— 查看可返回历史，点击即可传送（需开启交互聊天）📋 - `/back clear` —— 清空自己的 back 历史 🗑️ 🔹 **记录更全面** - 支持记录：插件传送、死亡位置、外部插件传送位置 🔄 🔹 **数据持久化** - 默认保存最近 **5** 条记录 - 默认 **30 分钟** 自动过期 ⏳ 🔹 **独立配置支持** - `/back` 拥有独立的：暖场时间、冷却时间、经济消耗、安全落点检测、世界黑白名单、Hooks 配置 ⚙️ 🔹 **新增权限节点** - `yuteleport.back.use` —— 使用权限 - `yuteleport.back.death` —— 死亡返回权限 - `yuteleport.back.clear` —— 清空权限 - `yuteleport.back.admin` —— 管理员权限 👑 🔹 **PlaceholderAPI 支持** - 新增 back 模块开关占位符 🧩 🔹 **API 扩展** - 新增 Back 传送类型 & 请求接口 🧬 --- 🛠️ **调整与修复** - 配置文件版本升级至 `config-version: 20` 📄 - 新增 `teleports.back` 配置节，默认启用 ✅ - 🐛 **修复**：模块级世界黑白名单中空列表无法正确覆盖默认限制的问题 - 冷却底层重构为共用 YuLib 分桶冷却实现，并新增 back 独立冷却桶 🪣 --- ⚠️ **升级提示** 1. **更新前建议备份**： - `plugins/YuTeleport/config.yml` - 数据目录（`plugins/YuTeleport/data/`） 2. **若不需要 `/back`**： - 在配置中设置 `teleports.back.enabled: false` 即可关闭 🚫 3. **自定义权限组的服主请注意**： - 检查是否需要开放或限制新的 back 相关权限 🔐 --- 🚀 祝您使用愉快，传送无忧！如有问题欢迎反馈～ —— YuTeleport 开发组 ❤️ [/MD]

[MD] # 🚀 YuTeleport 2.0.0.0 更新公告 📢 **各位服主请注意** —— YuTeleport 已从 `1.3.0.1` 重磅升级至 `2.0.0.0`！🎉 本次是 **主版本大更新**，插件已从单一的随机传送工具，全面进化为 **完整传送系统** 💪 原有的 `/yuteleport`、`/ytp`、`/rtp` 随机传送功能继续保留，放心使用～ --- ## ✨ 主要更新内容 ### 🧭 新增 `warp` 公共传送点模块 - 支持 `/warp`、`/setwarp`、`/delwarp` 完整指令体系 - 可设置 **公开**、**私有**、**受限** 三种传送点类型 - 支持传送点 **描述**、**重命名**、**数量限制** 与 **权限控制** ### 🏠 新增 `home` 玩家家模块 - 支持 `/home`、`/homes`、`/sethome`、`/delhome` 全套指令 - 支持 **多 home**、**公开 home**、**分组 home 上限** 和 **权限扩容** ### 🤝 新增 `tpa` 玩家互传模块 - 支持 `/tpa`、`/tpahere`、`/tpaccept`、`/tpdeny`、`/tpacancel`、`/tpaignore`、`/tpaall` - 完整的玩家传送请求管理体验 ### 📍 新增坐标分享功能 - 玩家传送成功后 **自动分享当前位置**，其他玩家可 **点击消息直接传送** ✨ ### ⚙️ 统一传送管线 - 随机传送、warp、home、tpa 现在 **共用同一套传送管线** - 统一处理：冷却 ⏱️、等待倒计时 ⏳、移动打断 🚫、经济扣费 💰、退款 🔄、安全落点 🛡️、Folia/Paper 调度和传送状态 ### 📄 配置升级 - 配置结构升级到 `config-version: 19`，旧配置 **自动迁移并备份** 📦 ### 🔌 API & 占位符扩展 - PlaceholderAPI 新增模块状态、warp/home 数量、各类传送冷却、费用等占位符 - Java API 同步扩展，方便二次开发 ### 💎 经济系统支持 - 支持 **Vault** 与 **PlayerPoints** 双经济插件 - 随机传送、warp、home、tpa 可 **分别设置费用和冷却**，灵活管理 --- ## ⚠️ 升级须知（请仔细阅读） 1. 📁 **升级前建议备份** 整个 `plugins/YuTeleport/` 文件夹 2. 🔄 低峰期替换 jar 后启动服务器即可，插件会自动迁移 `config.yml` 并生成备份 3. ⚡ 如服务器已有 EssentialsX、CMI 等插件占用 `/warp`、`/home`、`/tpa`，请在 `teleports.<模块>.commands` 中 **改名** 或 **关闭对应模块** 4. 📂 新增数据文件包括： - `warps.yml` - `data/homes/<uuid>.yml` - `cooldowns.yml` ⚠️ 运行中 **不建议手动编辑** 5. 💰 如启用经济功能，请确认 `economy.enabled`、`economy.provider` 以及 Vault/PlayerPoints 已正确安装 6. 🔑 升级后建议检查新权限节点，尤其是 warp/home/tpa、公开点、数量上限和管理权限 --- ## 💡 最后的话 本次更新保持旧版随机传送主要行为兼容，但新增模块较多，建议服主 **先在测试服确认命令冲突、配置迁移和经济扣费逻辑** 后再投入正式服使用 🧪✅ 祝各位服主开服愉快！🎮🎊 —— YuTeleport 开发团队 ❤️ [/MD]

修复传送被打断再次传送未重新计时bug

[MD] - **新功能**(五大板块): - **传送核心** — 异步搜索模式、落点预缓存、圆形分布 + 自定义中心点、生物群系黑白名单 + `/yurtp biome:<模式>` 参数、世界边界感知、世界名单 `*` 通配符 - **倒计时与视听反馈** — 聊天/BossBar/ActionBar/静默多通道倒计时、绿→黄→红渐变血条、五项打断条件逐项开关、全阶段音效(倒计时音高爬坡、成功琶音)、内置本地化标题、离开/到达粒子、可点击重试与悬停坐标、`&#RRGGBB` 十六进制颜色 - **自动随机传送** — 首次进服、死亡重生(可尊重床/重生锚) - **经济与冷却** — PlayerPoints 点券提供者、`groups` 分组冷却/费用、冷却写入 cooldowns.yml 防重启刷新、失败自动退款、重复传送保护 - **PlaceholderAPI** — 占位符从 17 个扩到 45+(成功率、冷却进度条、分组、费用、参数化世界占位符、`_display` 本地化后缀,离线可用) - **改进与修复** — 提示补全、日志带世界名、核心重构、9 组单元测试 + CI、`--release 8` 编译校验 - **升级须知** — 8 条,包括 config-version 10→13 自动迁移、新权限(`yurtp.biome`、`yurtp.group.<组名>`)、新文件 cooldowns.yml、PlayerPoints 软依赖等 [/MD]

YuRandomTeleport 1.2.0.2 更新通知
修复倒计时不显示最后一秒的bug

YuRandomTeleport 1.2.0.1 更新通知
修复倒计时显示bug

[MD] # YuRandomTeleport 1.2.0.0 更新通知 ## 从 1.1.2.2 升级到 1.2.0.0：更安全、更稳定、更适合正式服 各位腐竹好，**YuRandomTeleport 随机传送插件已更新至 1.2.0.0**。 本次属于一次比较重要的稳定性与功能升级，主要围绕三个方向优化： **传送更安全、配置更好管、兼容性更强。** 建议正在使用 **1.1.2.2 及以下版本** 的服务器尽快升级。 --- ## 一、本次更新重点 ### 1. 安全落点算法大幅增强 新版对随机传送落点进行了更严格的安全检查。 现在插件会综合判断： * 玩家脚下是否有可靠支撑 * 脚部与头部空间是否安全 * 头顶是否有足够空气 * 附近是否存在岩浆、水、火、仙人掌、蛛网、传送门、岩浆块等危险方块 * 落点是否为半砖、楼梯、栅栏、地毯、压力板等不稳定站立面 * 下界是否存在狭小洞穴、危险平台或悬空风险 相比旧版，1.2.0.0 更不容易出现传进墙里、落在危险方块旁、传到岩浆边、水洞里或下界危险平台上的情况。 --- ### 2. 新增传送等待倒计时与打断机制 新版支持配置传送前等待时间。 玩家执行 `/rtp` 后，可以先进入倒计时状态，再正式传送。 等待期间如果玩家出现以下行为，可以自动取消传送： * 移动 * 受伤 * 交互 * 聊天 * 执行命令 * 离线 这个功能非常适合正式服使用，可以减少玩家在战斗、危险环境或其他特殊场景中滥用随机传送。 新增相关配置： ```yaml teleport: wait-seconds: 5 cancel-on-move: true ``` 新增权限： ```text yurtp.bypass.wait ``` 拥有该权限的玩家可以跳过等待时间。 --- ### 3. 新增世界白名单模式 旧版主要依赖世界黑名单，新版新增了世界白名单。 如果你只想让资源世界、野外世界、活动世界可以使用随机传送，现在可以直接使用白名单模式。 ```yaml world-whitelist: [] ``` 当白名单不为空时，只有列表中的世界允许随机传送，黑名单会被忽略。 --- ### 4. 支持每个世界独立传送费用 新版支持在不同世界设置不同 RTP 费用。 例如主世界免费，资源世界收费，下界单独收费，都可以实现。 ```yaml default: cost: 0.0 worlds: resource: cost: 10.0 ``` 经济功能仍然需要 Vault 与经济插件支持。 --- ### 5. 新增方块白名单 allowed-materials 除了原有的危险方块黑名单，新版增加了落脚方块白名单。 当 `allowed-materials` 不为空时，插件只允许玩家落在指定类型的方块上。 适合特殊玩法，例如： * 只允许传送到草方块 * 只允许传送到石头 / 泥土 * 下界只允许传送到下界岩、灵魂沙、玄武岩等方块 * 活动世界限制可落地方块 支持 `*` 通配符，例如： ```yaml allowed-materials: - "GRASS_BLOCK" - "DIRT" - "*DEEPSLATE*" ``` --- ### 6. 多语言系统升级 新版内置语言系统，支持： * 简体中文 * 英文 * 自定义语言文件 * 根据玩家客户端语言自动选择消息 配置位置： ```yaml language: default: en_US use-player-locale: true ``` 需要服务器默认中文的腐竹，可以把默认语言改成： ```yaml language: default: zh_CN ``` 旧版 `messages.yml` 中修改过的中文消息会尽量兼容保留。 --- ### 7. 新增 PlaceholderAPI 支持 如果服务器安装了 PlaceholderAPI，新版可以注册 `%yurtp_*%` 占位符。 可用于菜单、计分板、变量显示、状态提示等场景。 常用信息包括： * 插件版本 * 当前平台类型 * 玩家冷却时间 * 玩家是否正在传送 * 玩家最近一次传送状态 * 最近传送坐标 * 成功 / 失败 / 取消统计 --- ### 8. 新增公共 Java API 与事件系统 1.2.0.0 提供了更完整的开发接口，方便其他插件联动。 新增能力包括： * 通过 API 请求随机传送 * 取消正在进行的随机传送 * 查询玩家传送状态 * 查询冷却剩余时间 * 获取最近一次传送快照 * 统计成功、失败、取消次数 同时新增传送生命周期事件： * 随机传送开始事件 * 目标点确认事件 * 传送取消事件 * 传送完成事件 适合菜单插件、任务插件、活动插件、权限插件或服务器自研系统接入。 --- ### 9. Folia / Paper 兼容增强 新版内置平台调度层，支持： * Bukkit / Spigot 常规调度 * Paper 异步传送 * Folia Entity Scheduler * Folia Region Scheduler * Folia Global Scheduler 这意味着新版在 Folia 与新架构服务端上的表现会更加稳定。 --- ### 10. 配置升级体验优化 新版加入智能配置更新逻辑。 升级时插件会尽量： * 自动补齐新版缺失配置项 * 保留原有配置值 * 保留原有注释与格式 * 避免中文被转义 * 配置损坏时自动备份并重建 * 修复旧版服务端不兼容字符导致的 YAML 读取问题 不过仍然建议腐竹升级前手动备份： ```text plugins/YuRandomTeleport/config.yml plugins/YuRandomTeleport/messages.yml plugins/YuRandomTeleport/lang/ ``` --- ## 二、升级建议 ### 推荐升级步骤 1. 关闭服务器。 2. 备份 `plugins/YuRandomTeleport/` 文件夹。 3. 删除旧版 jar，放入新版 `YuRandomTeleport-1.2.0.0.jar`。 4. 启动服务器，让插件自动补齐新版配置。 5. 检查 `config.yml` 中新增的语言、等待、白名单、方块白名单等配置。 6. 如果希望默认中文显示，请设置： ```yaml language: default: zh_CN ``` 7. 使用 `/yurtp reload` 重载配置，或重启服务器。 --- ## 三、需要重点检查的配置 升级后建议重点查看以下几项： ```yaml language: default: zh_CN use-player-locale: true ``` ```yaml teleport: wait-seconds: 5 cancel-on-move: true ``` ```yaml world-whitelist: [] ``` ```yaml default: cost: 0.0 safety: allowed-materials: [] ``` 如果你的服务器只允许资源世界使用 RTP，建议使用白名单模式： ```yaml world-whitelist: - resource ``` --- ## 四、适合立即升级的服务器 如果你的服务器遇到过以下情况，建议优先升级到 1.2.0.0： * 玩家随机传送后偶尔卡墙 * 下界随机传送不稳定 * 玩家被传到水里、岩浆旁、危险方块附近 * 希望加入传送倒计时 * 希望玩家移动或受伤时取消传送 * 想给不同世界设置不同收费 * 想接入菜单、变量、任务或其他插件联动 * 正在使用 Folia / Paper / 混合端服务端 --- ## 五、总结 YuRandomTeleport 1.2.0.0 不是简单的小修小补，而是一次面向正式服使用体验的稳定性升级。 本次更新让随机传送更加安全、更加可控，也更方便腐竹根据服务器玩法进行深度定制。 建议所有 1.1.2.2 及以下版本用户升级体验。 --- YuRandomTeleport 让玩家放心出发，让腐竹少操心。 [/MD]