MobileGlues 启动失败排查步骤

第一步：确认 MobileGlues 正常加载

启动游戏后查看游戏日志（启动器通常会在控制台或导出文件里显示）。如果日志里没有 Initializing MobileGlues ...，说明启动器没有成功注入 MobileGlues。

没有看到初始化日志时

• 确认你在启动器里选择的渲染器确实是 MobileGlues（不是 Zink、VirGL 或其他）
• 确认 MobileGlues 插件已安装，打开插件时没有报权限或损坏错误
• 确认你选的 Minecraft 版本是 1.17 及以上，低于此版本 MobileGlues 无法工作

看到了初始化日志但游戏仍崩溃

继续看日志里 MobileGlues 初始化后的输出：

• 有没有出现 [MobileGlues] Setting: enableAngle ... 这类配置项打印？
• 有没有 GLSL 或 shader 相关的编译错误？
• 有没有 Exception 或 FATAL 级别的错误堆栈？

第二步：二分排除模组

如果日志正常打印了初始化信息，但游戏闪退：

1. 移除所有模组，只保留 Fabric Loader 或 NeoForge 启动核心
2. 先加 Sodium（或 Embeddium），看能不能启动
3. 再加 Iris，看能不能启动
4. 再加第一个光影包，看能不能启动
5. 每次加一个，出问题就是刚加的那个东西

第三步：确认权限

MobileGlues 插件 v1.3.5 起需要 MANAGE_EXTERNAL_STORAGE（所有文件访问）权限。如果权限没授予，核心库可能无法正常写入缓存或日志，导致启动异常。

检查方式：打开 Android 设置 → 应用 → MobileGlues → 权限管理 → 存储 → 授予所有文件访问权限。

第四步：检查 Android 版本与 OpenGL ES

确认你的设备满足最低要求：

• Android 系统版本：6.0+
• OpenGL ES：3.0+（设置里能查到，或用 Android 开发者选项的 GPU 渲染器信息）