插件崩溃或加载失败怎么处理

插件安装成功但 JoiPlay 不识别

这是常见情况——你明明装了 APK，但 JoiPlay 设置里显示插件"未安装"或版本号为空。

排查步骤

第一步：确认插件 APK 真的装了

Android 上装了 APK 不等于"功能可用"。去手机设置 → 应用 → 找对应插件的包名：

如果应用列表里找不到，说明没装上——可能是 APK 文件损坏，或装到了 SD 卡上权限不够。

第二步：存储权限

每个插件是独立的 Android APP，需要单独授予存储权限：

• 设置 → 应用 → 每个插件 → 权限 → 存储 → 允许

很多人只给了 JoiPlay 核心存储权限，忘了给插件权限——插件读不到游戏文件自然无法加载。

第三步：版本兼容

如果上面两步都确认了还是不行，可能是插件版本太老不兼容当前核心 APK：

• 检查核心 APK 的版本号（比如 1.21.000）
• 插件版本是否太落后？去官方下载最新版插件
• 特别是 RPG Maker 插件——它的版本号通常高于核心 APK（比如核心 1.21，插件 1.22），不要因为"插件版本号更大"就不敢装

插件运行中崩溃

如果插件能加载但游戏一启动就崩（闪退）或插件进程被杀死：

方法一：卸载重装

1. 卸载插件（设置 → 应用 → 插件名 → 卸载）
2. 清空 JoiPlay 缓存
3. 重新安装最新版插件
4. 重新授权存储权限

方法二：强制停止并重新启动

1. 设置 → 应用 → JoiPlay → 强制停止
2. 设置 → 应用 → 插件 → 强制停止
3. 重新打开 JoiPlay

方法三：检查是否有同名冲突

如果你之前装过插件的旧版本没卸干净，可能出现"残留"。Android 设置 → 应用 → 确保没有多个同类型插件同时安装。例如：

• 同时装了 Ren'Py 8.1.3 和 8.2.3 和 8.3.7 和 8.5？——这没问题，可以共存
• 但装了两个"Ren'Py 8.5"的不同版本？——这会冲突，卸一个

方法四：更新 Android 系统版本

某些 Android 版本（特别是安卓 12~13 的某些更新）有 Bug 导致跨应用通信（JoiPlay ↔ 插件）失败。如果你最近刚更新了系统，JoiPlay 突然不行了，试试：

1. 重启手机（先试这个，最简单）
2. 如果不行 → 卸载所有插件 → 重新逐个安装
3. 如果还不行 → 社区搜"你手机型号 + Android 版本 + JoiPlay 插件"看有没有已知问题

插件损坏的终极解决

如果所有方法都试过了插件还是不行：

1. 完整卸载 JoiPlay 核心和所有插件
2. 重启手机（重要！清进程）
3. 从官方重新下载最新版的核心 APK + 所有需要的插件（下载到手机不要用 PC 传输，避免传输损坏）
4. 逐个安装（先核心，再插件）
5. 每个都确认存储权限已授予

这是最彻底的重置方式——实测能解决 90% 的莫名其妙插件问题。