joiplay 中文文档 下载 App

Ren'Py 不同大版本对应哪个插件

Ren'Py 引擎的大版本分裂

Ren'Py 引擎自 7.x 到 8.x 的迭代不仅是小修小补——8.x 引入了 Python 3 支持(7.x 用的是 Python 2)、Screen Language 重写、以及大量内部 API 变化。7.x 的代码和 8.x 的代码不完全兼容,所以 JoiPlay 分别为 7.x 和 8.x 提供了独立的插件 APK。

2025~2026 年的情况又进一步细分——Ren'Py 8 在 8.1 → 8.2 → 8.3 → 8.5 之间每次都有 API 变化,JoiPlay 跟进推出了多个 Ren'Py 8.x 的插件版本,部分是必装、部分是可选优化。

当前(2026-02)插件矩阵

插件覆盖 Ren'Py 版本体积定位推荐程度
Ren'Py 8.5 Plugin8.5+~53 MB官方主推,最新兼容⭐⭐⭐⭐⭐ 必装
Ren'Py 7.7.1 Plugin7.7+~38 MB最后一个 7.x 版本⭐⭐⭐⭐⭐ 必装
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 8.5 Plugin + Ren'Py 7.7.1 Plugin 两个必装,覆盖了当前绝大多数 Ren'Py 游戏。可选版本的插件只在某个具体游戏报兼容性问题时再安装——没必要一开始全装,占空间。

快速检测游戏的 Ren'Py 版本

打开游戏文件夹,按以下任一方法:

方法一:看 script.rpy 开头

打开 game/script.rpy(如果存在),第一行通常是注释或配置,可能有版本号:

# game init file
define config.version = "8.5.1"

方法二:看 .rpyc 文件命名

编译后的脚本 script.rpyc 包含版本信息,文件名可能带版本后缀:

script.rpyc (老版本通用)
script.rpyc8 (表示 Ren'Py 8.x 编译)
script.rpyc7 (表示 Ren'Py 7.x 编译)

方法三:运行看 JoiPlay 提示

当你启动一个 Ren'Py 游戏时,JoiPlay 会尝试自动检测版本并匹配最合适的插件。如果匹配失败,会弹警告说"找不到合适的 Ren'Py 插件"——这时就是缺对应版本的插件了。

Ren'Py 7.x → 8.x 的关键差异

如果一个 Ren'Py 游戏在 JoiPlay 上表现异常,搞清楚它是 7 还是 8 引擎可能是关键:

方面Ren'Py 7.xRen'Py 8.x
PythonPython 2Python 3
Screen Language旧版重写版,新语法
存档格式7.x部分不兼容
回滚(Rollback)支持支持,更灵活
翻译系统基础完整 i18n 框架
兼容性稳定但老旧持续迭代中

如果游戏的 script.rpy 里有 import renpy 后的 Python 3 语法(f-string、类型提示等),说明是 8.x,用 7.x 插件跑不起来。

共存策略

Ren'Py 8.5 和 Ren'Py 7.7.1 两个插件可以同时安装、互不冲突——它们是独立的安卓应用包。JoiPlay 加载游戏时会根据检测到的 Ren'Py 版本自动选对插件。这是 JoiPlay 模块化架构的另一个体现。