joiplay 中文文档 下载 App

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 的版本号:

这也是 JoiPlay 模块化设计的优势——引擎层的兼容性问题只需要更对应的插件。

插件安装成功的标志

安装完 RPG Maker Plugin 后,在 JoiPlay 的应用内设置或游戏详情页应该能看到插件版本号被正确识别。如果显示"未安装"或版本为空,说明:

特殊情况:强制 Miniz

JoiPlay RPG Maker 插件有一个"Force Miniz"的开关——Miniz 是一个轻量级压缩库,部分 RPG Maker 游戏的资源文件用了这个压缩格式。默认情况下插件会自动检测,但有时检测失败需要手动开启。如果某个 VX/VX Ace 游戏报资源加载错误、或画面显示乱码,就进游戏内设置找这个开关试试。