Ren'Py引擎rpa文件的解包与反编译

发表于 分类于 阅读次数：

.rpa 解包

我使用的是unrpa，具体用法可查看作者文档。

使用pip安装（需要python3）：py -3 -m pip install unrpa

CLI用法如下：

1
2
3
usage: unrpa [-h] [-v] [-s] [-l | -t] [-p PATH] [-m] [--version]
             [--continue-on-error] [-f VERSION] [-o OFFSET] [-k KEY]
             FILENAME [FILENAME ...]

一般我个人比较常用的就是unrpa -mp "PATH\TO\DEST" "PATH\TO\archive.rpa"，其中-m表示若目标路径不存在则创建该路径；当然如果已经cd到目标目录那就执行unrpa "PATH\TO\archive.rpa"即可。

反编译

此时解包出来的文件通常为.rpyc，也就是经过Ren’Py编译.rpy源码之后产生的文件，为了修改内容，此时就需要对其进行反编译。我用的是unrpyc，作者提供了命令行工具以及一个自动化的un.rpyc工具（作者发布的release就是un.rpyc，想要用CLI还需要自己去下源码）。
由于电脑上没安装python2（懒，所以本文使用的是基于python >=3.9的unrpyc v2.0.2。并且v2只支持 Ren’Py 8 以上，若是低版本还需安装v1（当然实际用下来好像没什么问题

对于命令行工具，我一般使用的命令为python unrpyc.py -c *.rpyc，即直接反编译当前目录下所有.rpyc文件，并使用-c选项覆盖已存在的.rpy文件。详细的选项在文档中也有给出，此处便不一一赘述，就贴一下--help罢。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
$ py -3 unrpyc.py --help
usage: unrpyc.py [-h] [-c] [-d] [-p {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15}]
                 [-t TRANSLATION_FILE] [-T WRITE_TRANSLATION_FILE]
                 [-l LANGUAGE] [--sl1-as-python] [--comparable] [--no-pyexpr]
                 [--no-init-offset] [--try-harder]
                 [--register-sl-displayable SL_CUSTOM_NAMES [SL_CUSTOM_NAMES ...]]
                 file [file ...]

Decompile .rpyc/.rpymc files

positional arguments:
  file                  The filenames to decompile. All .rpyc files in any
                        directories passed or their subdirectories will also
                        be decompiled.

optional arguments:
  -h, --help            show this help message and exit
  -c, --clobber         overwrites existing output files
  -d, --dump            instead of decompiling, pretty print the ast to a file
  -p, --processes
                        use the specified number or processes to
                        decompile. Defaults to the amount of hw threads
                        available minus one, disabled when muliprocessing is
                        unavailable.
  -t TRANSLATION_FILE, --translation-file TRANSLATION_FILE
                        use the specified file to translate during
                        decompilation
  -T WRITE_TRANSLATION_FILE, --write-translation-file WRITE_TRANSLATION_FILE
                        store translations in the specified file instead of
                        decompiling
  -l LANGUAGE, --language LANGUAGE
                        if writing a translation file, the language of the
                        translations to write
  --comparable          Only for dumping, remove several false differences
                        when comparing dumps. This suppresses attributes that
                        are different even when the code is identical, such as
                        file modification times.
  --no-pyexpr           Only for dumping, disable special handling of PyExpr
                        objects, instead printing them as strings. This is
                        useful when comparing dumps from different versions of
                        Ren'Py. It should only be used if necessary, since it
                        will cause loss of information such as line numbers.
  --no-init-offset      By default, unrpyc attempt to guess when init offset
                        statements were used and insert them. This is always safe
                        to do for ren'py 8, but as it is based on a heuristic it
                        can be disabled.
                        The generated code is exactly equivalent, only slightly more cluttered.
  --try-harder          Tries some workarounds against common obfuscation
                        methods. This is a lot slower.
  --register-sl-displayable SL_CUSTOM_NAMES [SL_CUSTOM_NAMES ...]
                        Accepts mapping separated by '=', where the first
                        argument is the name of the user-defined displayable
                        object, and the second argument is a string containing
                        the name of the displayable,potentially followed by a
                        '-', and the amount of children the displayable
                        takes(valid options are '0', '1' or 'many', with
                        'many' being the default)