12.1 Ren'Py 视觉小说引擎
12.1.1 概述
Ren'Py 官方支持 Windows、macOS 和 Linux,尚未适配 FreeBSD。FreeBSD 社区曾维护 games/renpy,但该 Port 已于 2025 年 11 月因依赖已弃用的 Python 版本而被移除。本节介绍如何通过官方二进制包安装与创建项目。
Ren'Py 是用于制作视觉小说的引擎。视觉小说以文字叙述为主,配合图像、音乐和选项分支实现互动叙事。与通用游戏引擎不同,Ren'Py 专注于视觉小说的特定需求,提供简化的脚本系统和内置资源管理功能。
Ren'Py 核心基于 Python 语言,除桌面平台外,还可导出至 Android 和 iOS 等移动平台。
12.1.2 安装 Ren'Py
games/renpy 已于 2025 年 11 月被移除,无法再通过 pkg 或 Ports 安装。可从 Ren'Py 官网 https://www.renpy.org/latest.html 下载 Linux 版本的 SDK 压缩包,解压后直接运行目录中的 renpy.sh 启动器。Ren'Py 基于 Python 开发,Linux 二进制包可通过 FreeBSD Linux 兼容层运行。
12.1.3 Ren'Py 设置中文界面
本小节介绍如何将 Ren'Py 界面设置为中文。具体操作步骤可参见以下截图。


12.1.4 玩《心跳文学部!》
警告
《心跳文学部!》是一款恐怖游戏,可能会 致郁!
本节以《心跳文学部!》为例,其他游戏也可采用相同操作方式。选择同时包含 Windows 和 Linux 版本的游戏文件,解压后使用。
12.1.4.1 运行 Ren'Py
默认游戏路径位于 ~/。Ren'Py 基于 Python 开发,底层文件处理机制对非 ASCII 字符路径支持不佳,不识别中文路径。必须将解压后的文件夹 DDLC-1.1.1-pc 放置于用户主目录下,例如 /home/ykla。
中文语言包位置:Doki Doki Literature Club 简体中文汉化补丁 v1.02(2025 更新)。将中文语言包解压后放置于游戏目录的 game 子目录中。
在引擎界面左侧点击“刷新”,“工程(Projects)”列表中即可看到刷新后的游戏 DDLC-1.1.1。点击该游戏后,选择右下角的“启动工程(Launch Project)”即可加载游戏。
上述游戏的 FreeBSD 适配版本已发布于 https://github.com/ykla/DDLC/releases,可供参考使用。





12.1.5 RPA 解包
本节介绍 RPA 文件的解包方法与相关工具。
12.1.5.1 选择游戏版本
尽量选择附有 Linux 版本的游戏。如果游戏仅支持 Windows 系统,可通过 Ren'Py 启动器的“构建分发”功能打包 Linux 版本。
12.1.5.2 解包工具
RPA 文件是 Ren'Py 的归档格式,用于打包游戏资源(图像、音频、脚本等)。RPA 文件解包工具:unrpa。
也可使用 pip 安装 unrpa 软件包:
$ pip install unrpa随后使用 unrpa 工具将指定的 RPA 文件解包到目标目录,-mp 参数用于指定输出目录。例如,将 archive.rpa 解包到 ./extracted 目录:
$ unrpa -mp "解包目录" "XXX.rpa"rpyc 文件是 Ren'Py 脚本文件的编译格式,包含游戏的剧情逻辑与交互规则。具体而言,rpyc 由 rpy 源文件编译而来,为二进制格式,不可直接阅读。rpyc 文件反编译工具:unrpyc。
使用 unrpyc 工具反编译指定的 rpyc 文件,将其转换为可读的 rpy 源文件:
$ python3 unrpyc.py -c "XXX.rpyc"该步骤仅用于脚本翻译或二次开发。
12.1.6 参考文献
- itch.io. itch.io is a simple way to find and share indie games online for free.[EB/OL]. [2026-03-26]. https://itch.io/. 免费独立游戏分享平台,支持创作者自主发布作品。
- Ren'Py Project. Why Ren'Py?[EB/OL]. [2026-04-17]. https://www.renpy.org/why.html. Ren'Py 官方平台支持说明,涵盖 Windows、macOS、Linux 桌面端及 Android、iOS 移动端。