故障恢复

日志在哪

载体	日志	崩溃数据
LeviLamina	logs/latest.log	logs/crash/ —— trace_*.log 与 minidump_*.dmp
Endstone	logs/latest.log，另有轮转的 logs/YYYY-MM-DD-N.log.gz	.sentry-native/
自持态	启动器的输出，以及服务端自己的日志	—

LeviLamina 下日志是共用的：服务端行与框架行落在同一个文件。Endstone 的轮转上限是 1000 个文件； LeviLamina 的在 plugins/LeviLamina/config/Config.json 里配。

框架没起来

启动序列会报告结果，载体把它写进日志而不是结束进程。找十六进制码：

日志里的码	含义
0xFFFFFFFE	插件管理器缺少寄宿契约入口。
0xFFFFFFFD	载体与插件管理器的寄宿契约版本不一致。

这两个是 -2 与 -3 按无符号打印的结果。它们都不是进程退出码：服务端继续运行，只是框架不在。 把不一致修掉——通常是升级做了一半——再重启。见升级与回滚。

缺 .NET 10 运行时失败在更早的位置，表现也不同：运行时查找会先返回自己的错误码。

插件没装上

插件管理器会逐个报告它拒绝了哪些包、为什么。常见原因：

• 目录名与清单 name 不一致。 两者必须相等。
• 声明的依赖不在。 插件被跳过，不会半装载。
• api_version 与这条框架线不兼容。
• 没有加载器认领这个包。 源码插件需要对应的加载器包；父级态下，从别的服务器搬来的包跑不起来， 多半是这个原因。

排除插件

服务端起不来又不知道是哪个插件时，先把它们全部移走：

1. 停服。
2. 把 plugins/ 下的插件目录移走，但把基础设施留下：
   • plugins/hosihikari/ 每次都留——那是框架本身；
   • LeviLamina 下 plugins/LeviLamina/ 也要留——那是父级加载器，就装在这个目录里；
   • Endstone 的父级不在 plugins/ 下，不用另留。
3. 启动。能起来，说明框架没问题，问题在某个包里。
4. 分两半搬回来，每轮之间重启，直到服务端失败。最后那一批里有问题插件。
5. 把它留在外面，然后上报。

把父级加载器连同插件一起移走，什么也证明不了：没有父级，就没有东西去激活框架，失败原因跟插件无关。 每个载体都适用。自持态目前没有运行期启停，每轮都必须重启，步骤一样。

插件卸不掉

卸载是经过验证的：框架让加载器确认程序集装载上下文已被回收，默认最多等 30 秒。超时按卸载失败记录， 插件留在 Detached 槽里——不会被当成已经消失。常见原因是静态状态、还在跑的线程，以及插件在 OnUnload 里没清掉的引用。见插件包与清单。

上报要带什么

• 框架、加载器与插件的版本（lip list）。
• 载体与 BDS 版本。
• 失败前后的日志行，取自 logs/latest.log。
• 上面那些路径里的崩溃文件。
• 出问题之前改了什么——一次升级、一个新插件、一处配置。

发布前删掉服务器 IP、玩家名与世界数据。漏洞走所属仓的私有表单上报，不要开公开 issue；见该仓的安全策略。