Skip to content

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 界面设置为中文。具体操作步骤可参见以下截图。

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,可供参考使用。

DDLC 游戏界面

Ren'Py 项目列表

DDLC 启动

DDLC 游戏画面 1

DDLC 游戏画面 2

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 软件包:

sh
$ pip install unrpa

随后使用 unrpa 工具将指定的 RPA 文件解包到目标目录,-mp 参数用于指定输出目录。例如,将 archive.rpa 解包到 ./extracted 目录:

sh
$ unrpa -mp "解包目录" "XXX.rpa"

rpyc 文件是 Ren'Py 脚本文件的编译格式,包含游戏的剧情逻辑与交互规则。具体而言,rpyc 由 rpy 源文件编译而来,为二进制格式,不可直接阅读。rpyc 文件反编译工具:unrpyc

使用 unrpyc 工具反编译指定的 rpyc 文件,将其转换为可读的 rpy 源文件:

sh
$ 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 移动端。