入口:实例设置 → 模组管理 →「启动前模组体检」。在面板内可关闭「启动前自动体检」,默认开启。原版实例启动时跳过自动检查。检查标准 mods 目录、旧版 Forge 的 mods/游戏版本 子目录,以及 LabyMod 的实例模组目录。
界面使用 PCL Ultra 原生卡片、按钮、搜索框、复选框、滑条和滚动条;共用启动器配色、标题渐变及主题花纹,跟随当前主题即时更新。错误与警告保留独立语义色。
关闭、最小化按钮采用主窗口的 MyIconButton 与 lucide/x、lucide/minus 图标和动画;图标大小保持原样,控件大小为 22×22,相邻按钮间留出 10 像素的空隙供拖动标题栏。移除额外的固定圆形裁剪,允许原生按下/释放回弹完整绘制;标题栏使用主窗口同款 48 像素高度和 WPF 拖动处理。标题栏双击仍可最大化/还原。
- 节点图展示当前实例顶层模组文件、选中的内嵌模组提供者、运行时依赖和缺失项。箭头从声明方向依赖方;缺失/确定不匹配用红色,未知/可选用橙色,禁用文件用灰色。
- 可搜索名称、Mod ID、文件名,点击问题条目聚焦相关节点,支持缩放与滚动。最多同时绘制 160 个节点、1800 条边;完整问题判断不受绘图裁剪影响。问题列表显示前 500 项。
- 点击模组节点查看依赖声明和禁用影响;模组管理中实际禁用前,原有级联检查会列出受影响模组,并可选择仅禁用所选、连带禁用或取消。删除仍走原有级联选择。
- 下载按钮在浏览器中按 Mod ID 搜索 Modrinth。ID 不等于项目名称;需要自行核对项目、MC 版本和加载器。不会猜测文件后自动安装。加载器/Java 版本问题请在启动器的版本安装或 Java 设置中解决。
检查位于 Java 选择、参数与文件准备完成之后,高性能显卡设置、自定义启动命令和游戏进程启动之前。完整检查发现缺失必需依赖、必需版本不匹配或元数据中已声明的硬冲突时,暂停本次启动,可以打开体检面板或取消。可选依赖不拦截,软冲突/未知版本只警告,用户可继续。
复用现有 Fabric/Forge/NeoForge/Quilt 元数据和 Jar-in-Jar 解析器,保留加载器/Java 原始依赖约束;支持 Fabric 数组 OR、复合谓词、常见 SemVer 范围以及 Maven 区间与区间并集。Maven 裸版本视为推荐。未知或畸形范围、占位符、未知实际版本不会伪装成已确认的版本冲突。Quilt 对 Fabric Loader 的兼容版本和 Cleanroom 的 Forge 兼容版本不冒充当前加载器版本。Fabric 服务端专用节点和 Forge 服务端依赖不参与客户端分析。
损坏/缺失元数据、超限、超时、未识别的加载器或检测到 Fabric 依赖覆盖文件时,报告不完整,降为警告并允许用户选择是否继续,不根据残缺的提供者集合硬拦截。尚未执行加载器完整的 SAT 求解、依赖覆盖配置求值和运行时代码分析;现有内嵌版本选择器提供候选筛选,不能保证等同于每一版加载器的最终选择。
只在本地读取模组内容,不运行 JAR,不上传模组或清单。解析器可能在启动器缓存目录提取图标,并在实例 PCL/JarInJar.bin 复用原有内嵌解析缓存;不会因体检更改模组启禁用状态。缓存格式更新使旧内嵌缓存重新解析,保存运行环境和加载器约束。
后台扫描单项 JAR 上限 512 MiB;条目 30000;非嵌套资源条目 64 MiB;元数据条目 2 MiB;顶层批次元数据 128 MiB;顶层文件 1500;关系分析节点 3000、声明 30000。嵌套解析沿用原模块深度/条目/展开量限制。合作式解析预算约 25 秒,等待上限 30 秒;同一时间只接受一个体检任务。超时后未结束的任务保持单任务锁至退出,避免重复堆积。关闭窗口会请求取消。
“未发现依赖问题”不等于“绝对兼容”或“绝对安全”。它检查元数据声明,无法发现全部 Mixin、未声明冲突、恶意行为、运行时下载、原生库及自定义加载路径问题;Mod 安全扫描仍是独立的百宝箱工具。
语义参考:Fabric 元数据规范、NeoForge Mod Files。未复制 Prism/ZL2 源码。
- 10 项纯依赖图测试:缺失、可选、禁用提供者、未知约束、别名和替代提供者、平台版本、硬/软冲突、传递与循环、物理宿主、1500 节点链;加上原有 8 项 Mod 安全扫描回归,18 项通过。
- 发布包 DLL 集成检查:真实 Fabric JSON / Forge TOML、加载器原始约束保留、范围比较、模拟实例冷/热内嵌缓存、服务端节点、损坏 JAR 降级,以及实际 WPF 图形面板创建和离屏渲染。
- 本轮未运行真实 Minecraft 游戏,不能据此承诺所有整合包均可成功启动。