Skip to content

日志系统 ​

每个插件实例自带一个 Logger 属性,输出会自动打上插件名称前缀,并同时送往三个地方:

  1. Studio 控制台与 Unity Debug.Log
  2. 运行时内存循环历史缓冲区(可在 F10 面板的「运行日志」标签页查看)
  3. 本地磁盘日志文件:%LOCALAPPDATA%\Studio 2.0\Logs\modloader.log

使用 ​

csharp
Logger.Info("一般信息提示");
Logger.Warning("警告:某资源未能正常加载");
Logger.Error("操作失败", exceptionObj);
Logger.DebugLog("调试细节日志");

约定 ​

级别用途
Info正常流程节点,用户可见的关键动作
Warning可恢复的异常、降级行为
Error操作失败,建议同时传入 Exception 对象以便打印堆栈
DebugLog排查期细节,正式发布前尽量收敛

排查加载失败

插件在加载阶段抛出的异常会被 Loader 捕获,连同完整堆栈一起显示在 F10 控制台的「已加载插件」页,并写入 modloader.log。用户报障时让对方提供这个日志文件即可。

为 BrickLink Studio 2.0 打造的第三方 Mod 加载框架 · 与 BrickLink / LEGO 官方无关联