Project1

标题: [R3EXS] 一款用来提取和翻译RGSS3游戏引擎的字符串的工具 [打印本页]
作者: 四维T_T    时间: 2025-2-14 13:32
标题: [R3EXS] 一款用来提取和翻译RGSS3游戏引擎的字符串的工具
本帖最后由 四维T_T 于 2025-2-14 14:00 编辑

家人们，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 脚本中的字符串和符号的精准提取
功能列表
      
安装方法
使用 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 文件

  4. SYNOPSIS

  6.     R3EXS [global options] decrypt [command options] <Game.rgss3a file path>

  8. COMMAND OPTIONS
  9.     -o, --output_dir=DIRECTORY -  *.rvdata2 文件的输出目录 (默认: ./)
复制代码


示例代码
  1. R3EXS decrypt ./Game.rgss3a
复制代码

序列化 rvdata2 文件为 json 格式
  1. NAME
  2.     rvdata2_json - 将 rvdata2 文件序列化为 json 格式

  4. SYNOPSIS

  6.     R3EXS [global options] rvdata2_json [command options] <the *.rvdata2 dir>

  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

  4. // 完全序列化
  5. R3EXS rvdata2_json -c ./Data
复制代码

反序列化 json 文件为 rvdata2 格式
  1. NAME
  2.     json_rvdata2 - 将 json 文件反序列化为 rvdata2 文件

  4. SYNOPSIS

  6.     R3EXS [global options] json_rvdata2 [command options] <the *.json dir>

  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

  5. // 如果在 rvdata2_json 时开启 --complete 选项
  6. // 则不需要提供 --original_dir 选项
  7. R3EXS json_rvdata2 -c ./JSON
复制代码

提取所有的字符串
  1. NAME
  2.     ex_strings - 提取所有的字符串

  4. SYNOPSIS

  6.     R3EXS [global options] ex_strings [command options] <the *.json dir>

  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

  4. // 提取 Scripts 脚本
  5. R3EXS ex_strings -s ./JSON

  7. // 提取 Scripts 脚本并单独提取到 ManualTransFile_scripts.json 文件
  8. R3EXS ex_strings -s -p ./JSON
复制代码

注入所有的字符串
  1. NAME
  2.     in_strings - 注入所有的字符串

  4. SYNOPSIS

  6.     R3EXS [global options] in_strings [command options] <the *.json dir>

  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

  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 文档
友情链接
​




欢迎光临 Project1 (https://rpg.blue/) Powered by Discuz! X3.1