Skip to content

About

台词拾光:Windows RPG Maker / SRPG Studio / Unity 游戏文本提取与阅读工具,支持 MTool 译文、场景整理和 TXT / Excel 导出。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

台词拾光

台词拾光

从游戏里提取台词,在一个窗口里阅读、搜索和导出。

下载 Windows 版 · 反馈问题

应用截图

截图中的台词为演示内容。

支持 RPG Maker、SRPG Studio 和部分 Unity 游戏,也能读取 MTool 翻译文件。提取后可按场景浏览,查看原文与译文,导出 TXT 或 Excel。

程序在本地处理文本,不会修改游戏目录。普通提取直接读文件;部分封装游戏会通过隔离组件读取临时副本。

下载和使用

适用于 Windows 10 / 11,64 位。从 Releases 下载便携包,解压后打开 台词拾光.exe,无需安装 Python、Excel 或 MTool。

离线增强版(无需再下载组件) · 普通便携版

  1. 将游戏 EXE 或文件夹拖进窗口,也可以点击“选择游戏文件夹”。
  2. 提取完成后,在左侧选场景,中间搜索台词,右侧阅读正文。“连续阅读”可以查看前后文。
  3. 点击“导出文本”,选择 TXT 或 Excel。可以导出全部内容、筛选结果或选中的条目,也可以按场景拆成多个文件。

默认只显示对白和选项,并优先显示译文。想看物品、技能等文字,可以切换到“所有文本类别”。

使用 Langscore 汉化的游戏会自动加载中文翻译表,优先简体中文。空译文或未匹配的条目保留原文。

游戏目录中有 MTool 翻译文件时,程序会查找可用的 JSON;也可以通过“切换翻译文件”手动选择。单独拖入翻译 JSON 也能打开,但没有游戏数据就无法对应到场景。

遇到支持的 VX Ace EXE 封装时,会自动尝试增强读取。首次使用需要联网下载约 152 MB 的运行组件,之后可以离线使用;游戏和文本不会上传。读取过程中可以取消,临时副本会在结束后清理。请保留完整游戏文件夹及同目录的原始 EXE 备份。

不方便联网时,使用离线增强版。 这个包已经附带组件,完整解压后即可使用,请保留 EXE 旁的“增强读取组件”文件夹。

请下载 Releases 中的便携包。仓库页面的 Code → Download ZIP 是源码。

支持哪些游戏

类型 支持范围
RPG Maker MV / MZ data/ 或 www/data/ 中的标准 JSON 数据
RPG Maker VX Ace 已展开的 Data/*.rvdata2、标准 .rgss3a 数据包及部分 EXE 封装
SRPG Studio 1.140–1.322 的标准 data.dts(含引擎标准加密),暂不读取外部语言包
Unity 标准文本资源、外置文本,以及能够解析结构的对白对象;兼容情况因游戏而异
Langscore MV / MZ 汉化插件的中文 CSV 翻译表
MTool “原文:译文”形式的 JSON 字典;地图缓存可读取已有事件片段

暂不支持 RPG Maker XP / VX 和图片中的文字。EXE 保护封装并非全部兼容;Unity 的自定义封装、加密资源,以及缺少可恢复类型信息的对象也可能读不到。遇到提取不全的情况,可以先查看窗口中的“提取报告”。

只有 MTool 地图缓存、没有完整游戏数据时,工具会标记为“缓存片段”。缓存不包含未加载的地图、公共事件和数据库,无法据此还原完整剧情。

场景按文件中的地图、事件或资源分组,顺序不一定等于实际剧情顺序。变量和角色引用会保留为占位符,运行时才生成的内容无法直接还原。

工具只读取已有文本,不提供机器翻译。仅在运行时替换文字的汉化插件可能读到原文;有原译对照的 MTool 文件会保留两者。

从源码运行

使用 Windows 和 Python 3.12:

git clone https://github.com/Hirokimeji/rpg-text-reader.git
cd rpg-text-reader
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe app.py

打包:

.\.venv\Scripts\python.exe -m PyInstaller --noconfirm textlight.spec
.\.venv\Scripts\python.exe package_release.py

EXE 生成在 dist/,便携包生成在 release/。

运行测试:

.\.venv\Scripts\python.exe -m unittest -v test_engine test_encrypted_json test_langscore test_gui.GuiTests test_rgss test_rgss_archive test_protected_reader test_srpg test_unity

问题反馈

在 Issues 中说明应用版本、游戏引擎、操作步骤和报错信息。日志位于 %LOCALAPPDATA%\台词拾光\error.log。

如果是某个游戏无法提取,附上相关文件的名称和目录结构会更方便排查。

第三方组件

界面使用 PySide6 / Qt,Excel 导出使用 openpyxl,程序通过 PyInstaller 打包。许可证随便携包附带,Qt / PySide6 的许可说明见 third_party。

SRPG Studio 解析基于 SRPG-ToolBox(MIT),组件说明见 vendor/srpg。Unity 解析使用 UnityPy 和 TypeTreeGeneratorAPI。

About

台词拾光:Windows RPG Maker / SRPG Studio / Unity 游戏文本提取与阅读工具,支持 MTool 译文、场景整理和 TXT / Excel 导出。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages