RPG Maker 插件(Ace 插件)到底做了什么
为什么 RPG Maker 需要单独的插件
JoiPlay 核心 APK 内置了 HTML5/WebView,所以 MV/MZ(JavaScript 引擎)可以走 HTML5 路线。但 XP/VX/VX Ace 这三代用的是Ruby 脚本(分别叫 RGSS / RGSS2 / RGSS3),这就需要一个完整的 Ruby 运行时在安卓上跑起来。这就是 RPG Maker Plugin(社区俗称 Ace 插件)的作用。
插件名里虽然写着 "Ace",但它同时覆盖 XP、VX、VX Ace 三代——因为这三代的 RGSS 是同一语言的三个版本,插件内嵌了三个版本的 Ruby 运行时。
插件内部架构
| 组件 | 作用 | 覆盖引擎代 |
|---|---|---|
| RGSS Ruby 解释器 | 执行 XP 游戏的 .rb 脚本 | RPG Maker XP |
| RGSS2 Ruby 解释器 | 执行 VX 游戏的 .rb 脚本 | RPG Maker VX |
| RGSS3 Ruby 解释器 | 执行 VX Ace 游戏的 .rb 脚本 | RPG Maker VX Ace |
| RGSS2A 解密器 | 解密 VX 游戏的 .rgss2a 打包文件 | RPG Maker VX |
| RGSS3A 解密器 | 解密 VX Ace 游戏的 .rgss3a 打包文件 | RPG Maker VX Ace |
| V8 JS 引擎 | 执行 MV/MZ 的 JavaScript 脚本 | RPG Maker MV / MZ |
| 战斗系统兼容层 | 处理各代战斗系统的差异 | 全部代际 |
| 贴图 / 瓦片系统 | 渲染地图瓦片和精灵图 | 全部代际 |
RGSS 加密的处理
很多独立 RPG Maker 作者为了保护游戏资源,会把 Data/ 目录打包加密成一个 .rgss2a(VX)或 .rgss3a(VX Ace)文件。在 PC 上游戏引擎会自动解密加载;在 JoiPlay 上,插件内置了解密器——检测到这些文件时自动解密到内存中,用户完全无感知。
这也是为什么你可以放心用 JoiPlay 跑打包后的 RPG Maker 游戏,不需要额外用解包工具先拆资源。
插件版本与核心 APK 的关系
RPG Maker 插件的版本号独立于 JoiPlay 核心 APK 的版本号:
- 核心 APK 1.21.000 可能搭配 RPG Maker Plugin 1.22.008
- 两者互不绑定,可以单独更新
- 兼容性修复通常先在插件里发布(比如某个 VX Ace 游戏的脚本 bug 修复),不需要等核心 APK 大版本更新
这也是 JoiPlay 模块化设计的优势——引擎层的兼容性问题只需要更对应的插件。
插件安装成功的标志
安装完 RPG Maker Plugin 后,在 JoiPlay 的应用内设置或游戏详情页应该能看到插件版本号被正确识别。如果显示"未安装"或版本为空,说明:
- APK 可能被清理了,重新安装一次
- 或权限没给,确认 JoiPlay 的存储访问权限已开启
- 或插件版本太老不兼容当前核心 APK,去官方下载最新版
特殊情况:强制 Miniz
JoiPlay RPG Maker 插件有一个"Force Miniz"的开关——Miniz 是一个轻量级压缩库,部分 RPG Maker 游戏的资源文件用了这个压缩格式。默认情况下插件会自动检测,但有时检测失败需要手动开启。如果某个 VX/VX Ace 游戏报资源加载错误、或画面显示乱码,就进游戏内设置找这个开关试试。