joiplay 中文文档 下载 App

JoiPlay 首次安装必须准备哪些组件

三件套的概念

社区常说的"JoiPlay 三件套"指的是核心 APK + RPG Maker 插件 + Ren'Py 插件这三个独立安装包。这个说法是因为绝大多数用户接触 JoiPlay 都是为了玩 RPG Maker 同人作品或 Ren'Py 视觉小说,这两个插件是最高频的必装项。

但严格来说,"三件套"不是硬性规定——你只玩 HTML5 游戏的话,装一个核心 APK 就够了;只玩 Flash 的话,核心 APK 加 Ruffle 插件就行。按需安装是 JoiPlay 模块化设计的初衷。

组件清单

核心 APK(必须)

项目信息
名称JoiPlay Required
当前版本1.21.000(2026-02-14)
体积约 26 MB
包含功能游戏库 UI、HTML5/HTML 游戏支持、TyranoBuilder 支持、所有插件的加载器
推荐来源官方 mega.nz 直链 或 Patreon 公开构建

核心 APK 是所有功能的基础,它本身能独立运行,但只内置了 HTML5 和 TyranoBuilder 的解释能力。RPG Maker、Ren'Py、Flash、Godot 等引擎全部依赖额外插件。

RPG Maker Plugin(按需装)

项目信息
当前版本1.22.008(2026-02-14)
体积约 80 MB
覆盖引擎RPG Maker XP / VX / VX Ace / MV / MZ
内部机制内嵌 Ruby 解释器(RGSS 系)+ V8 JS 引擎(MV/MZ)

这是 JoiPlay 最重要的插件,因为 RPG Maker 是当前兼容度最高、用户基数最大的引擎系列。

Ren'Py Plugin(按需装,分版本)

Ren'Py 插件的情况比较特殊——由于 Ren'Py 引擎本身的大版本迭代(7.x → 8.x → 8.5),JoiPlay 为不同版本提供了独立的插件 APK:

插件覆盖版本体积定位
Ren'Py 8.5 Plugin8.5+约 53 MB当前主推必装
Ren'Py 7.7.1 Plugin7.7+约 38 MB兼容老游戏必装
Ren'Py 8.3.7 Plugin8.3.7约 46 MB可选,特定版本优化
Ren'Py 8.2.3 Plugin8.2.3约 44 MB可选,特定版本优化
Ren'Py 8.1.3 Plugin8.1.3约 41 MB可选,特定版本优化

如果不确定目标游戏用的 Ren'Py 版本,建议Ren'Py 8.5 和 7.7.1 两个必装,可选版本按需下载。JoiPlay 会根据游戏的 Ren'Py 版本自动匹配最优的插件。

Ruffle Plugin(Flash 专用)

项目信息
当前版本1.02.002
体积约 26 MB
作用提供 Adobe Flash (SWF) 文件的运行能力

Ruffle 是用 Rust 重写的 Flash Player,开源项目,兼容 ActionScript 2 和部分 ActionScript 3。

Godot Plugin(按需装)

Godot 同样分 3.x 和 4.x 两个独立插件,体积分别约 50 MB 和 74 MB。当前兼容度约 50%,2D GDScript 游戏优先支持。

安装方式

所有 APK 的安装方式相同:

  1. 下载到手机(浏览器直接下载、或从电脑通过 USB/局域网传输)
  2. 在手机设置中允许"未知来源应用安装"
  3. 用文件管理器找到 APK 文件,直接安装
  4. 插件安装后 JoiPlay 会自动识别,无需额外配置

Google Play 版本注意:社区反馈 Google Play 上的 JoiPlay 构建可能已不再维护,最新功能和修复只在 Patreon 和官方公开构建中发布。如果发现 Play 版本落后几个大版本,建议切换到官方来源。

存储权限

首次运行时 JoiPlay 会请求存储访问权限——这是必须的,因为游戏文件、插件缓存、存档数据都要读写。如果拒绝对权限,JoiPlay 无法扫描游戏目录、也无法保存进度。