10 Upgrade Notes

10 升级说明

中文版本 | English version

这一页用于从旧版本升级到当前版本时快速核对。普通首次安装不需要阅读这一页，直接看 1 快速开始 即可。

升级前

升级前建议先做两件事：

• 备份服务器目录中的配置文件和存储数据。
• 确认服务器可以正常停止，不要在运行中直接替换模组文件。

当前配置文件位于：

config/teleport_commands.json

旧版存储如果仍然存在，会在首次启动时自动迁移到当前存储结构。迁移成功后，旧文件会被归档，避免重复迁移。

升级后优先检查

启动后建议按顺序检查：

/tpc status
/tpc help
/tpc config teleporting preload
/tpc config teleporting defaultSafetyCheck
/tpc debug

重点确认：

• 各模块是否处于预期启用状态。
• teleporting.preloadEnabled 是否符合服务器需求。
• teleporting.defaultSafetyCheck 是否符合服务器需求。
• 额外调试日志是否仍然关闭。

v2.0 后的重要默认行为

当前默认行为更偏向轻量和可预测：

• debugEnabled=false，额外调试日志默认关闭。
• teleporting.preloadEnabled=false，目标区块预加载默认关闭。
• teleporting.defaultSafetyCheck=false，已知目标传送默认不做安全落点搜索。
• RTP 使用独立随机落点安全检查，不受 defaultSafetyCheck 和目标预加载开关影响。

如果希望 /home、/warp、/back、/worldspawn 在目标点附近寻找安全落点，需要同时开启：

/tpc config teleporting preload true
/tpc config teleporting defaultSafetyCheck true

配置迁移

配置文件会自动迁移到当前结构。旧版中的部分字段会被规范化，例如旧的 RTP 半径字段会迁移为当前的最小/最大半径结构。

如果你手动维护配置文件，升级后建议重新对照 4 配置文件，确认字段名和默认值。

存储迁移

旧版 JSON 存储会在启动时迁移到当前存储格式。迁移逻辑会尽量保留：

• 玩家 homes。
• 全局 warps。
• 默认 home。
• 地图显示/隐藏偏好。

迁移失败通常说明旧文件损坏或数据结构异常。不要直接删除旧数据；应先备份，再查看服务端日志。

回滚注意事项

升级到新版本并完成存储迁移后，不建议直接回退到旧版模组。旧版可能无法识别新存储结构。

如果必须回滚，应使用升级前备份的数据。