备份与还原

值得留的备份有两半：游戏自己的，和插件自己的。

备份什么

路径	内容	什么时候会变
worlds/	所有世界，一个 level-name 一个目录	玩家在线时持续变化
keys/server_identity_key.pem	服务端身份钥	一次
allowlist.json	白名单	改名单时
plugins/	插件包，含 plugins/hosihikari/	安装与升级时
config/hosihikari/	服务端侧的配置覆盖	改配置时
data/hosihikari/	框架交给插件的数据	插件运行时

后三项是框架的。plugins/ 虽然能重装，也值得备份：一台能跑的服务端上装的到底是哪几个版本的包， 本身就是你要保住的东西。

停服备份

停服，拷上表路径，再启动。这是唯一不会拍到半个世界的做法。

运行中备份

BDS 可以按需准备一份一致的世界副本。在服务端控制台里：

save hold
save query

save hold 只是请求服务端开始准备，它立刻返回，准备在后台进行。反复调用 save query，直到它 返回一份文件清单。在那之前它会回答准备尚未完成，文件还不能拷。

save query 成功时返回的清单列出要拷的每个文件及各自长度。只拷这些文件——不是整个 worlds/ 目录——并把每个拷出来的文件截断到服务端给的长度。拷贝期间服务端仍在运行，文件可能在被读的同时 变长；截断才是让副本等于那个快照的东西。

拷完再解除：

save resume

然后照常拷框架那几个路径。它们是普通目录，不受世界刷盘覆盖。

还原

1. 停服。
2. 用备份替换 worlds/、keys/ 与 allowlist.json。
3. 替换 plugins/、config/hosihikari/ 与 data/hosihikari/。
4. 启动，看日志里框架是否重新接管、插件列表是否正确。

把旧的 plugins/ 配上新框架，是插件因 api_version 被拒绝的常见原因。框架与插件用同一天的备份还原。

备份覆盖不到的东西

• BDS 本体与它自己的文件。留着你安装时用的那份服务端压缩包。
• .NET 运行时。重装，不要拷贝。
• 插件写在 data/hosihikari/ 之外的东西。那个路径是契约；写到别处的插件在契约之外，得知道它自己的布局。