外观
F10 运行时控制台
在 Studio 2.0 里随时按 F10,呼出框架内置的即时调试管理控制台。也可以从顶部 Mods 菜单 → 🧩 Mod 管理器 打开。
控制台是一个深色主题的浮动窗口,顶部三个标签页:
已加载插件(Plugins)
- 列出所有已激活 Mod 的名称、版本、作者,以及生效的 Harmony 补丁数量。
- 加载失败时直接展示完整堆栈与错误原因(红色徽章标记)。
- 支持关键字搜索过滤,插件多了也好找。
- 一键在资源管理器中打开该 Mod 的配置目录。
补丁数量为 0 说明什么
说明 PatchAll 没扫到这个插件的任何补丁类。常见原因是 [HarmonyPatch] 特性写错,或目标方法签名与 Studio 版本不匹配。
运行日志(Logs)
- 实时滚动的
ModLoader与各 Mod 打印的日志流,新日志自动滚到底部。 - 一键调用记事本打开完整的
modloader.log。
日志文件位置:
text
%LOCALAPPDATA%\Studio 2.0\Logs\modloader.log框架信息(About)
- 显示引擎版本、Unity 环境、当前打开工程状态。
- 支持一键打开
Mods文件夹。 - 内测版构建下,这里还提供框架自动更新的入口(检查 → 下载签名包 → 退出 Studio 后备份替换)。
排查问题的顺序
- 按
F10→ 运行日志 看有没有红色Error,Bootstrapper/LoaderManager前缀的日志反映框架自身状态。 - 切到 已加载插件,找目标插件:加载成功但补丁数为 0 → 补丁问题;带红色徽章 → 插件
OnLoaded()抛异常,看堆栈。 - 需要更完整的历史日志时,点「打开日志文件」,把
modloader.log交给开发者。
关于实现方式
F10 覆盖层是 IMGUI 实现(OnGUI),只用于调试,不作为正式插件 GUI 的范例。正式 Mod 窗口支持 NGUI 和 WebView2,见 Mod 窗口开发规范。