YuRandomTeleport 安装部署

环境要求

项目	要求
Java	Java 8 及以上。源码以 `sourceCompatibility = JavaVersion.VERSION_1_8` 构建。
服务端	Spigot、Paper、Paper 衍生端，以及 Mohist、Arclight、Youer 等兼容 Bukkit API 的混合端。
Minecraft	目标适配 `1.8.x-1.26.x`。源码使用 Spigot API `1.8-R0.1-SNAPSHOT` 编译，并通过反射读取新版世界高度。建议在正式服同版本测试后上线。
经济扣费	可选。需要 Vault 与一个 Vault 经济服务提供者，例如 EssentialsX Economy、CMI 或其他经济插件。
网络访问	bStats 统计会尝试访问统计服务；不影响核心随机传送功能。

YuRandomTeleport 的核心定位不是只服务某一个新版本，而是尽量覆盖从老版本生存服到新版本混合端的随机传送需求。

兼容范围	说明
Minecraft 版本	目标适配 `1.8.x-1.26.x`。
Bukkit 系服务端	Spigot、Paper、Paper 衍生端。
混合端	Mohist、Arclight、Youer 等 Bukkit API 混合端。
世界高度	旧版本使用传统高度逻辑；新版通过反射读取 `getMinHeight` / `getMaxHeight`，适配负高度和更高世界上限。
下界传送	下界不依赖最高地表点，而是在配置高度范围内扫描候选 Y，降低混合端和不同世界生成器下卡墙概率。

压缩包内是 Gradle 项目，已包含 gradlew 与 gradlew.bat。在插件源码目录执行：

powershell

.\gradlew.bat clean shadowJar

构建完成后通常会在 build/libs/ 下生成包含依赖重定位后的 jar。发布部署时优先使用 shadowJar 产物，因为 bStats 已被重定位到插件包内。

首次上线前至少检查这些配置：

配置	默认值	建议
`world-blacklist`	`lobby`	将主城、登录服、小游戏大厅等世界加入黑名单。
`world-whitelist`	空列表	如果只允许资源世界 RTP，建议改用白名单。白名单非空时会覆盖黑名单。
`default.radius.min`	`500`	控制玩家离出生点或世界坐标中心的最小距离。
`default.radius.max`	`2000`	控制随机范围。大型资源世界可调高。
`teleport.wait-seconds`	`5`	PVP 或生存服建议保留等待时间，防止战斗逃脱。
`teleport.cancel-on-move`	`true`	正式服建议保持开启。
`cooldown.seconds`	`3`	生产环境通常建议根据玩法提高到 30 秒、60 秒或更高。
`default.safety.max-attempts`	`32`	找不到安全点时可适当增加，但过高会增加瞬时区块加载压力。

经济功能默认关闭：

yaml

economy:
  enabled: false

启用扣费需要同时满足：

示例：

yaml

economy:
  enabled: true

default:
  cost: 100.0

worlds:
  resource:
    cost: 50.0
  world_nether:
    cost: 250.0

如果开启经济但没有 Vault，控制台会提示安装 Vault。如果检测到 Vault 但没有经济服务提供者，控制台会提示安装经济插件。

插件会读取 config-version 和 messages-version，当版本落后时合并默认配置并备份旧文件。

文件	当前版本	备份行为
`config.yml`	`5`	更新时生成类似 `config.yml.bak4` 的备份。
`messages.yml`	`4`	更新时生成类似 `messages.yml.bak3` 的备份。

升级建议：

插件不会创建数据库表；经济扣费由 Vault 经济插件处理。