游戏启动后黑屏怎么办

黑屏是 JoiPlay 最常见的问题之一

黑屏的原因在不同引擎上不完全一样，按类型排查：

RPG Maker XP/VX/VX Ace 黑屏

最常见原因：缺少 RTP

如果 JoiPlay 没有自动弹出 RTP 下载对话框，手动去游戏设置里找 "RTP" 相关选项，触发自动下载流程。详见 RTP 运行库缺失。

第二常见原因：作弊功能冲突

社区反馈，开启了"作弊菜单（Cheat Menu）"后有相当比例的 RPG Maker 游戏会黑屏——作弊功能注入的代码可能干扰了游戏正常的启动流程。解决方法：

1. 进游戏内设置（顶栏箭头 → 齿轮）
2. 找到 "Cheat Menu" / "作弊菜单" 选项
3. 关闭它
4. 退出游戏重启 JoiPlay，再启动游戏

其他可能

• RPG Maker 插件版本过老 → 更新到最新版
• 游戏目录损坏 → 在 PC 上验证文件完整性后重新拷贝到手机
• RGSS 加密解密失败 → 某些自定义加密的游戏需要插件作者专门适配，试试换插件版本

RPG Maker MV/MZ 黑屏

最常见原因：大纹理处理失败

MV/MZ 使用 JavaScript + Canvas/WebGL 渲染，部分游戏有特别大的纹理贴图（比如动态场景、高清立绘等）。WebGL 后端在处理超大纹理时可能崩溃导致黑屏。

解决方法：

1. 游戏内设置 → 渲染后端选择
2. 把 WebGL 改成 Canvas（虽然性能稍低但兼容性更好）
3. 同时把画质档位降到 720P 流畅 或 低配机专用

其他可能

• MV/MZ 游戏强制要求 Node.js 环境 → 这种游戏 JoiPlay 本身就不支持，只能等插件更新
• 游戏需要网络资源 → 确保手机联网了（某些 MV/MZ 游戏启动时会尝试下载外部资源）

Ren'Py 黑屏

Ren'Py 游戏黑屏主要集中在插件版本不匹配：

1. 确认游戏的 Ren'Py 大版本（7.x 还是 8.x）
2. 确保对应版本的插件已安装且是最新版
3. 如果还是黑屏，试试同时安装多个可选版本的 Ren'Py 插件（8.1.3 / 8.2.3 / 8.3.7），让 JoiPlay 自动匹配

Flash（Ruffle）黑屏

Ruffle 的 Flash 支持还不完整，黑屏可能是 ActionScript 3 游戏不兼容导致的：

• 试试换另一个经典 AS2 的 Flash 小游戏确认 Ruffle 本身没问题
• 如果 Ruffle 能跑其他 Flash 游戏，说明是这个特定游戏不兼容，无解（等 Ruffle 项目后续更新）

通用排查步骤

1. 先重启 JoiPlay，有时候只是进程状态异常
2. 关闭作弊菜单，这是最高频的黑屏原因之一
3. 更新引擎插件（不只是核心 APK）
4. 检查 RTP（RPG Maker 类）
5. 切换渲染后端（WebGL ↔ Canvas）
6. 降低画质档位
7. 换一个确定能用的同引擎游戏，验证 JoiPlay 本身没坏