YuTeleport 安装部署

环境要求

项目	要求
Java	Java 8 及以上。源码通过 options.release = 8 编译。
服务端	Bukkit、Spigot、Paper、Purpur、Folia，以及 Mohist、Arclight、Youer 等兼容 Bukkit API 的混合端。
Minecraft	目标适配 1.8.x-1.26.x。源码以 Spigot API 1.8-R0.1-SNAPSHOT 为编译基线，通过反射兼容新版 API。
经济扣费	可选。economy.provider: vault 需要 Vault 和经济插件，playerpoints 需要 PlayerPoints。
PlaceholderAPI	可选。安装后可注册 %yuteleport_*% 变量。
网络访问	bStats 和更新检查会访问外部服务；核心传送功能不依赖外网。

从源码构建

在 YuTeleport 源码目录执行：

.\gradlew.bat clean shadowJar

构建完成后优先使用 build/libs/ 下的 YuTeleport-2.0.1.0-all.jar 或同版本 shadowJar 产物。该产物会重定位 bStats 与 YuLib，避免多个 Yu 系插件携带不同版本运行库时发生类冲突。

部署到服务端

1. 停止服务端。
2. 将 YuTeleport-2.0.1.0-all.jar 放入服务端 plugins/ 目录。
3. 启动服务端，等待生成 plugins/YuTeleport/config.yml、lang/zh_CN.yml、lang/en_US.yml。
4. 控制台会输出官方文档、Modrinth、Issue、QQ 群和爱发电链接。
5. 进入游戏执行 /rtp help、/ytp help 或 /yuteleport help 检查主命令。
6. 按需测试 /warp、/home、/tpa、/back 等模块命令是否已按配置注册。

首次配置检查

配置	默认位置	建议
世界访问	teleports.defaults.world-access	将登录服、主城、大厅等世界加入黑名单；资源世界可改用白名单。
RTP 范围	teleports.rtp.worlds.default.radius	根据资源世界大小设置 min 和 max。
安全检查	teleports.rtp.worlds.default.safety	正式服建议保持开启，必要时按世界覆盖。
等待与打断	teleports.defaults.warmup-seconds、cancel-triggers	生存/PVP 服务器建议保留等待和移动打断。
经济	economy、各模块 cost	先确认 Vault 或 PlayerPoints 可用，再配置费用。
冷却持久化	cooldowns.persist	正式服建议保留 true，重启后继续保留未到期冷却。
模块开关	teleports.rtp/warp/home/tpa/share/back.enabled	不需要的模块可关闭，关闭后不会注册对应命令。
配置更新模式	config-update-mode	template 会同步模板注释和顺序，preserve 会尽量保留现有排版。

官方链接

默认配置和插件启动日志内置这些入口：

入口	地址
官方文档 Wiki	https://vicuna-main.github.io/YuPluginHub/plugins/items/yu-teleport/
Modrinth 下载	https://modrinth.com/plugin/yuteleport
Bug / Issue 反馈	https://github.com/vicuna-main/YuTeleportIssueReport
官方 QQ 交流群	https://qm.qq.com/q/xiwJYBYdh0
爱发电支持	https://afdian.com/a/vicuna

升级已有 YuRTP/YuTeleport

1. 停服备份 plugins/YuTeleport/，旧 YuRTP 用户也应备份旧插件目录。
2. 替换 jar。
3. 启动一次服务端，让插件按 config-version: 20 合并配置。
4. 检查 config.yml.bak<旧版本号>-<时间戳> 备份。
5. 依次测试 /rtp、/yuteleport reload、一次管理员代传送、一次 warp/home/tpa/back 流程。
6. 如果使用 PAPI，执行 /papi parse me %yuteleport_status% 检查变量注册。

卸载

1. 停止服务端。
2. 删除 plugins/ 中的 YuTeleport jar。
3. 如不再需要配置和数据，删除 plugins/YuTeleport/ 目录。

插件本体不创建数据库表；经济数据由 Vault 或 PlayerPoints 对应插件维护。