Ren'Py游戏解包与汉化完全手册

1
游戏目录/
2
├── game/                    # 游戏核心资源目录
3
│   ├── script.rpyc          # 加密脚本文件（运行时使用）
4
│   ├── script.rpy           # 源代码脚本（如果开发者未删除）
5
│   ├── images/              # 图片资源（CG、立绘、背景等）
6
│   ├── audio/               # 音频资源（BGM、音效、语音）
7
│   ├── fonts/               # 字体文件
8
│   ├── tl/                  # 翻译文件目录
9
│   └── persistent/          # 存档数据
10
└── renpy/                   # 引擎核心文件

1
label start:
2
    "这是开场白"
3

4
    e "你好，欢迎来到这个世界！"
5

6
    menu:
7
        "选项A":
8
            "你选择了A"
9
        "选项B":
10
            "你选择了B"

1
# 使用file命令识别文件类型
2
file script.rpyc
3
# 输出示例：script.rpyc: data

1
# 查找版本配置
2
cat game/tl/common.rpyc | strings | grep "version"

1
python unrpyc.py game/script.rpyc
2
# 如果输出"Unknown encryption"，说明版本不匹配或加密强度较高

1
# 1. 克隆项目仓库
2
git clone https://github.com/CensoredUsername/unrpyc.git
3
cd unrpyc
4

5
# 2. 安装Python依赖
6
pip install -r requirements.txt
7

8
# 3. 验证安装
9
python unrpyc.py --help

1
# 基础解密
2
python unrpyc.py 游戏目录/game/ -o 解包输出目录/
3

4
# 批量处理
5
python unrpyc.py 游戏目录/game/*.rpyc -o 解包输出目录/
6

7
# 跳过加密验证（慎用）
8
python unrpyc.py --no-preserve 游戏目录/game/ -o 解包输出目录/

1
# 下载Ren'Py SDK（以8.2.1版本为例）
2
wget https://www.renpy.org/dl/8.2.1/renpy-8.2.1-sdk.tar.bz2
3

4
# 解压
5
tar -xjf renpy-8.2.1-sdk.tar.bz2
6
cd renpy-8.2.1-sdk
7

8
# 启动Ren'Py（可选）
9
./renpy.sh

1
# 单文件解密
2
./rcc --decrypt 游戏文件.rpyc
3

4
# 批量解密
5
./rcc --decrypt game/*.rpyc
6

7
# 指定输出目录
8
./rcc --decrypt game/script.rpyc -o output/

1
# 下载rpatool
2
wget https://github.com/shizmob/rpatool/raw/master/rpatool.py

1
# 基础提取
2
python rpatool.py extract game.rpa 输出目录/
3

4
# 列出rpa内容
5
python rpatool.py list game.rpa
6

7
# 创建rpa文件
8
python rpatool.py create output.rpa 输入目录/

1
chmod +x unpack_game.sh
2
./unpack_game.sh

1
from renpy import game, script
2

3
def extract_with_sdk():
4
    """使用Ren'Py SDK提取文本"""
5
    game.init()
6

7
    # 遍历所有脚本标签
8
    texts = {}
9
    for label, node in script.script.nodes.items():
10
        if hasattr(node, 'what'):  # 对话节点
11
            texts[label] = node.what
12

13
    return texts

1
解包游戏
2
    ↓
3
提取文本
4
    ↓
5
翻译文本
6
    ↓
7
打包成tl文件
8
    ↓
9
测试汉化效果
10
    ↓
11
打包发布

1
game/
2
└── tl/
3
    └── chinese/
4
        ├── common.rpy          # 通用翻译
5
        ├── script.rpy          # 主脚本翻译
6
        └── [其他rpy文件].rpy

1
# 1. 解包图片资源
2
python rpatool.py extract game/images.rpa extracted_images/
3

4
# 2. 使用Photoshop/GIMP编辑图片
5
# 保持原始分辨率和格式（推荐PNG）
6

7
# 3. 替换原图
8
cp edited_image.png extracted_images/original_name.png
9

10
# 4. 重新打包为rpa
11
python rpatool.py create new_images.rpa extracted_images/

1
# game/tl/chinese/字体配置.rpy
2

3
init python:
4
    # 字体替换映射
5
    config.font_replacement_map = {
6
        'DejaVuSans': ('NotoSansCJKsc.ttc', True, True),
7
        'SourceHanSansCN': ('NotoSansCJKsc.ttc', True, True),
8
        'Arial': ('SimHei.ttf', True, True),
9
    }
10

11
    # 自定义字体设置
12
    style.default.font = "fonts/NotoSansCJKsc.ttc"

1
game/
2
└── fonts/
3
    ├── NotoSansCJKsc.ttc      # 思源黑体（推荐）
4
    ├── SimHei.ttf             # 黑体（备选）
5
    └── custom_font.ttf        # 自定义字体

1
# 假设游戏名称为"EnglishGame"
2
python unrpyc.py EnglishGame/game/ -o EnglishGame/unpacked/
3
python rpatool.py extract EnglishGame/game/images.rpa extracted_images/

1
# 使用Ren'Py Translation Editor导入
2
# 导出为texts.txt

1
# 使用Google Translate API批量翻译
2
python translate_tool.py --input texts.txt --output translated.txt --api-key your-key

1
# 测试
2
cd EnglishGame
3
python renpy.py tl/chinese
4

5
# 打包
6
./create_patch.sh

1
# 自动识别并转换编码
2
import chardet
3

4
def convert_encoding(input_file, output_file):
5
    with open(input_file, 'rb') as f:
6
        raw = f.read()
7
        encoding = chardet.detect(raw)['encoding']
8

9
    # 转换为UTF-8
10
    with open(output_file, 'w', encoding='utf-8') as f:
11
        f.write(raw.decode(encoding))
12

13
convert_encoding('script.rpy', 'script_utf8.rpy')

1
# 处理日文特殊字符
2
def clean_japanese_text(text):
3
    # 移除注音标记
4
    import re
5
    text = re.sub(r'《[^》]+》', '', text)
6
    text = re.sub(r'｜([^｜]+)《[^》]+》', r'\1', text)
7
    return text

1
# 日文字体集成
2
init python:
3
    config.font_replacement_map = {
4
        'Meiryo': ('NotoSansJP-Regular.otf', True, True),
5
        'MS Gothic': ('NotoSansJP-Regular.otf', True, True),
6
    }

1
# 查看游戏版本
2
cat game/tl/common.rpyc | strings | grep -E "version|renpy"
3

4
# 检查unrpyc支持的版本
5
python -c "import sys; print(sys.version)"

1
# 使用--no-preserve跳过验证
2
python unrpyc.py --no-preserve game/ -o output/
3

4
# 如果仍失败，尝试指定版本
5
python unrpyc.py --version 8.0 game/ -o output/

1
# 自动检测文件编码
2
import chardet
3

4
def detect_encoding(file_path):
5
    with open(file_path, 'rb') as f:
6
        raw = f.read()
7
        result = chardet.detect(raw)
8
        return result['encoding']
9

10
encoding = detect_encoding('script.rpy')
11
print(f"检测到的编码：{encoding}")

1
# 转换为UTF-8
2
def convert_to_utf8(file_path, target_encoding='utf-8'):
3
    # 读取原始编码
4
    source_encoding = detect_encoding(file_path)
5

6
    with open(file_path, 'r', encoding=source_encoding) as f:
7
        content = f.read()
8

9
    # 写入UTF-8
10
    with open(file_path, 'w', encoding=target_encoding) as f:
11
        f.write(content)

1
# 验证tl文件目录结构
2
tree game/tl/
3

4
# 输出示例：
5
# game/tl/
6
# ├── chinese/
7
# │   ├── common.rpy
8
# │   └── script.rpy

1
# 检查翻译文件语法
2
python -m py_compile game/tl/chinese/script.rpy
3

4
# 或使用Ren'Py启动测试
5
cd game
6
python ../renpy.sh tl chinese