[R3EXS] 一款用来提取和翻译RGSS3游戏引擎的字符串的工具

四维T_T

家人们，R3EXS 时隔5个月终于迎来重大更新了，不仅对项目结构进行大更新，而且将其发布为 gem 方便一键安装，也可以使用打包好的二进制可执行文件，当然也可以作为 gem 库在自己的项目中调用，下方还有 API 文档。本次更新最大卖点就是解决了Scripts脚本文件的提取，可以完全达到Mtool所能提取的字符串的个数

大家在使用过程中遇到什么BUG，欢迎到下方 github 中提 issue，不会用的小伙伴也可以在这里反馈

最后要是觉得好用，欢迎点亮小黄心哦

项目地址：https://github.com/LuoTat/R3EXS（不知道为什么没法插入超链接了）
        
R3EXS
RGSS3_Extract_Strings_Tool

一个用来提取和翻译 RGSS3 游戏引擎的字符串的工具

      
目录

• 简介
• 特点
• 功能列表
• 安装方法
• 使用方法
• 项目构建
• 项目文档
• 友情链接
  

        
简介
R3EXS 是一个基于 Ruby 语言，用来提取和翻译 RGSS3 游戏里字符串的 gem
特点
使用 Prism 实现了对 Ruby 脚本中的字符串和符号的精准提取
功能列表

• 解包 Game.rgss3a 文件
• 序列化 rvdata2 文件为 json 格式
• 反序列化 json 文件为 rvdata2 格式
• 提取所有的字符串
• 注入所有的字符串
  

      
安装方法
使用 RubyGems 安装
1. 安装 Ruby 要附带安装 Devkit 来支持编译 C 扩展)
2. 安装 R3EXS gem

1. gem install R3EXS

复制代码

直接下载 exe 可执行文件
点击下载 R3EXS.exe
使用 Ocran 和 Tebako 两个打包工具
Windows 环境提供 R3EXS-windows-Ocran 和 R3EXS-windows-Tebako
Linux (GLIBC>=2.31) 环境提供 R3EXS-linux-Tebako
在首次运行时会解压 Ruby 环境，所以首次运行会比较慢
使用方法
以下代码均假设在游戏根目录下运行，确保 ./Game.rgss3a 文件存在，或者已经解包到 ./Data 文件夹下
如果你喜欢疯狂输出的控制台或者觉得运行太快，请开启 --verbose 选项
解包 Game.rgss3a 文件

1. NAME
   
2.     decrypt - 解码 Game.rgss3a 文件
   
3. 
   
4. SYNOPSIS
   
5. 
   
6.     R3EXS [global options] decrypt [command options] <Game.rgss3a file path>
   
7. 
   
8. COMMAND OPTIONS
   
9.     -o, --output_dir=DIRECTORY -  *.rvdata2 文件的输出目录 (默认: ./)

复制代码

示例代码

1. R3EXS decrypt ./Game.rgss3a

复制代码

序列化 rvdata2 文件为 json 格式

1. NAME
   
2.     rvdata2_json - 将 rvdata2 文件序列化为 json 格式
   
3. 
   
4. SYNOPSIS
   
5. 
   
6.     R3EXS [global options] rvdata2_json [command options] <the *.rvdata2 dir>
   
7. 
   
8. COMMAND OPTIONS
   
9.     -c, --[no-]complete        - 开启完全序列化
   
10.     -n, --[no-]with_notes      - 开启注释序列化
    
11.     -o, --output_dir=DIRECTORY - *.json 文件的输出目录 (默认: ./JSON)
    
12.     -s, --[no-]with_scripts    - 开启 Scripts 脚本序列化

复制代码

示例代码

1. // 只序列化可翻译部分
   
2. R3EXS rvdata2_json ./Data
   
3. 
   
4. // 完全序列化
   
5. R3EXS rvdata2_json -c ./Data

复制代码

反序列化 json 文件为 rvdata2 格式

1. NAME
   
2.     json_rvdata2 - 将 json 文件反序列化为 rvdata2 文件
   
3. 
   
4. SYNOPSIS
   
5. 
   
6.     R3EXS [global options] json_rvdata2 [command options] <the *.json dir>
   
7. 
   
8. COMMAND OPTIONS
   
9.     -c, --[no-]complete          - 开启完全反序列化
   
10.     -o, --output_dir=DIRECTORY   - 新的 *.rvdata2 文件的输出路径 (默认: ./Data_NEW)
    
11.     -r, --original_dir=DIRECTORY - 原始的 *.rvdata2 文件路径 (默认: ./Data)
    
12.     -s, --[no-]with_scripts      - 开启 Scripts 脚本反序列化

复制代码

示例代码

1. // 如果在 rvdata2_json 时没有开启 --complete 选项
   
2. // 则必须提供 --original_dir 或是当前目录下存在 ./Data 文件夹
   
3. R3EXS json_rvdata2 ./JSON
   
4. 
   
5. // 如果在 rvdata2_json 时开启 --complete 选项
   
6. // 则不需要提供 --original_dir 选项
   
7. R3EXS json_rvdata2 -c ./JSON

复制代码

提取所有的字符串

1. NAME
   
2.     ex_strings - 提取所有的字符串
   
3. 
   
4. SYNOPSIS
   
5. 
   
6.     R3EXS [global options] ex_strings [command options] <the *.json dir>
   
7. 
   
8. COMMAND OPTIONS
   
9.     -o, --output_dir=DIRECTORY       - ManualTransFile.json 或 ManualTransFile_scripts.json 文件的输出目录 (默认: ./)
   
10.     -p, --[no-]with_scripts_separate - 开启 Scripts 脚本单独提取到 ManualTransFile_scripts.json 文件
    
11.     -s, --[no-]with_scripts          - 开启 Scripts 脚本提取
    
12.     -y, --[no-]with_symbol           - 开启 Scripts 脚本中的 Symbol 提取

复制代码

示例代码

1. // 不提取 Scripts 脚本
   
2. R3EXS ex_strings ./JSON
   
3. 
   
4. // 提取 Scripts 脚本
   
5. R3EXS ex_strings -s ./JSON
   
6. 
   
7. // 提取 Scripts 脚本并单独提取到 ManualTransFile_scripts.json 文件
   
8. R3EXS ex_strings -s -p ./JSON

复制代码

注入所有的字符串

1. NAME
   
2.     in_strings - 注入所有的字符串
   
3. 
   
4. SYNOPSIS
   
5. 
   
6.     R3EXS [global options] in_strings [command options] <the *.json dir>
   
7. 
   
8. COMMAND OPTIONS
   
9.     -m, --manualtransfile_path=FILE - ManualTransFile.json 文件路径 (默认: ./ManualTransFile.json)
   
10.     -o, --output_dir=DIRECTORY      - 新的 *.json 文件的输出目录 (默认: ./JSON_NEW)
    
11.     -s, --[no-]with_scripts         - 开启 Scripts 脚本注入

复制代码

示例代码

1. // 不注入到 Scripts 脚本
   
2. R3EXS in_strings ./JSON
   
3. 
   
4. // 注入到 Scripts 脚本
   
5. R3EXS in_strings -s ./JSON

复制代码

想要获取更多帮助，使用

1. R3EXS help

复制代码

项目构建
如果想要构建项目并运行，首先克隆整个项目

1. git clone [email protected]:LuoTat/R3EXS.git

复制代码

然后使用 `bundle` 安装依赖

1. bundle install

复制代码

最后编译 C 扩展即可

1. rake compile

复制代码

构建本地文档

1. yardoc

复制代码

构建 `R3EXS_Ocran.exe` 可执行文件

1. rake ocran

复制代码

查看所有 rake 任务

1. rake -T

复制代码

项目文档
R3EXS Api 文档
友情链接

• oj
• gli
• Prism
• Ocran
• Tebako
• RGSS3
• rvdata2json
• VX-Ace-Translator
• RPGMakerDecrypter
• RPGMaker VX Ace F1-Manual
  

​