MobileGlues 黑屏或渲染丢失的处理

干净启动测试

第一步永远是干净启动：移除所有模组、关闭所有光影、用 Minecraft 原版默认设置启动。

如果干净启动还是黑屏，问题基本锁定在 MobileGlues 核心库与你的设备 ES 驱动的兼容性上。

干净启动正常但一加光影就黑屏

说明问题在光影包或 Iris/OptiFine 的配置上：

1. 先跑官方兼容列表里标记为 ✅、且不需要 ANGLE 的光影包（如 iterationT 3.2.0、BSL、Chocapic13 V6 Lite）
2. 尝试在插件 Settings 标签页开启「忽略 shader/program 报错」
3. 确认你用的 Iris 或 OptiFine 版本是最新稳定版

干净启动正常，加模组就黑屏

按上次排错页的二分法，逐个加模组定位。重点注意：

• OptiFine 和 Sodium/Embeddium 不能共存
• Mali GPU 上 Create 的 flywheel instancing 后端有已知问题（开 ANGLE 或切批处理后端）

原生 ES 驱动 vs ANGLE 切换

如果在原生 ES 驱动下反复出现黑屏、渲染丢失、图形 glitch 等问题，试试切换到 ANGLE 驱动：

1. 打开 MobileGlues 插件 → Settings 标签页
2. 找到 ANGLE 相关开关并启用
3. 重启启动器（不是只重启游戏）

ANGLE 能绕过很多厂商原生 ES 驱动的 bug，特别是在部分 Mali GPU 上效果显著。

升级 MobileGlues 版本

很多渲染问题是已知 bug，在新版本中已经修复。v1.3.5 修复了 Sodium 的 VULKAN 定义问题，v2.0.0 修复了 JourneyMap 和 Xaero's World Map 的渲染问题。如果你用的是旧版，升级到最新版是最优先的尝试。