Ren’Py 汉化全家桶：rpatool + unrpyc 实战解包与文本提取教学

Ren’Py 是目前最流行的 GalGame / 视觉小说引擎之一，许多海外独立作品、同人作品都基于它开发。

因此，学习 Ren’Py 游戏的解包与翻译，常见目的包括：

学习 Ren’Py 脚本结构
个人学习用途的翻译
同人汉化（非商业）
研究游戏文本与演出逻辑

⚠️ 重要声明：

本文仅用于技术学习、个人研究与非商业翻译交流。请尊重原作者版权，不得将解包内容用于商业用途或未经许可的公开传播。

一、Ren’Py 游戏的基本结构#

一个典型的 Ren’Py 游戏目录大致如下：

1
game/
2
 ├── script.rpy
3
 ├── screens.rpy
4
 ├── options.rpy
5
 ├── gui/
6
 ├── audio/
7
 ├── images/
8
 └── archive.rpa

其中关键点：

.rpy：Ren’Py 脚本（可读文本）
.rpyc：编译后的脚本（需要反编译）
.rpa：资源归档文件（图片、音频、脚本）

二、Ren’Py 解包总体流程#

完整流程可以概括为：解包资源 → 反编译脚本 → 翻译文本 → 放回运行

具体步骤如下：

解包 .rpa 文件
反编译 .rpyc 脚本
翻译对话文本
使用 Ren’Py 内置翻译系统（推荐）
测试并运行

三、解包 Ren’Py 的 .rpa 资源文件#

准备工具：rpatool#

常用工具：

rpatool（Python 编写）

安装（需要 Python 3）：

1
pip install rpatool

解包 .rpa 文件#

进入游戏目录：

1
rpatool -x archive.rpa

解包后会得到：

1
audio/
2
images/
3
script.rpyc

如果有多个 .rpa 文件，全部解包即可。

四、反编译 .rpyc 脚本#

使用 unrpyc（主流工具）#

项目名通常叫 unrpyc，用于将 .rpyc 还原为 .rpy。

基本用法：

1
python unrpyc.py script.rpyc

成功后生成：

1
script.rpy

说明：

新版 Ren’Py 可能生成多个 .rpyc
可以一次性反编译整个目录

常见问题#

版本不兼容→ 使用支持新 Ren’Py 的 unrpyc 版本
变量名被混淆→ 不影响文本翻译

五、Ren’Py 推荐的“正确翻译方式”#

不建议直接改原 .rpy 文本！

Ren’Py 官方提供了 内置翻译系统，优点是：

不破坏原脚本
可随时切换语言
不影响游戏逻辑

生成翻译模板#

进入游戏根目录，执行：

1
renpy translate .

或在启动器中选择：Generate Translations

生成结构示例：

1
game/
2
 └── tl/
3
     └── chinese/
4
         └── script.rpy

翻译示例#

原文：

1
e "Hello, welcome to this world."

翻译文件中会出现：

1
translate chinese start_123456:
2
    e "你好，欢迎来到这个世界。"

你只需要改 引号里的内容。

六、翻译技巧与注意事项#

建议这样做#

保留变量和标签名不变
只翻译文本内容
注意换行和 {} 控制符

不要这样做#

不要删 translate 标签
不要修改函数或跳转语句
不要用全角引号

七、处理 UI / 菜单文本#

UI 文本通常在：

1
screens.rpy
2
options.rpy
3
gui.rpy

示例：

1
text _("Start Game")

在翻译文件中写：

1
translate chinese strings:
2
    old "Start Game"
3
    new "开始游戏"

这是 Ren’Py 字符串翻译机制。

八、测试与运行汉化版本#

启动 Ren’Py
选择语言（如有语言菜单）
进入游戏测试文本

如果出现问题：

查看 traceback.txt
检查是否漏翻或格式错误

九、常见坑汇总#

1. 中文乱码#

使用 UTF-8 编码
确认字体支持中文

2. 游戏无法启动#

翻译文件语法错误
少了冒号或缩进

3. 文本未生效#

没放在 tl/语言名/ 目录
语言未切换

十、进阶：自动翻译 + 人工润色#

常见流程：

提取翻译模板
使用机器翻译（DeepL / GPT）
人工校对润色
回到 Ren’Py 测试

机器翻译一定要人工检查，否则人物语气会崩

音乐