如何使用Textractor：游戏文本提取神器的完整指南 🎮

Textractor是一款开源的游戏文本钩子工具，专为Windows系统设计，能够从视频游戏和视觉小说中精准提取文本内容。无论是游戏本地化、二次创作还是学习研究，这款工具都能帮你轻松捕获游戏内文字信息，支持x86/x64架构，兼容多种游戏引擎。

📸 Textractor界面预览

Textractor主界面展示：包含进程选择、文本显示和扩展功能区，直观易用的设计适合新手快速上手。

✨ 核心功能亮点

自动钩子技术

• 智能识别引擎：自动适配多种游戏引擎，包括部分VNR不支持的特殊架构
• 自定义钩子代码：支持使用/H "hook"格式手动输入钩子代码（兼容多数AGTH代码）
• 自动搜索功能：内置文本钩子智能搜索，减少手动配置时间

高度可扩展架构

• 模块化扩展系统：通过extensions/目录下的插件实现功能扩展
• 丰富示例插件：内置谷歌翻译、正则替换等实用工具
• 开发者友好：提供完整的扩展开发框架和示例代码

🚀 快速安装与配置

系统要求

• Windows 7及以上操作系统
• Qt 5.13运行库（编译源码时需要）
• Visual Studio（仅源码编译需要）

一键安装步骤

1. 获取源码

   git clone https://gitcode.com/gh_mirrors/te/Textractor
   

2. 初始化子模块

   cd Textractor && git submodule update --init
   

3. 编译运行
   打开项目文件夹，使用Visual Studio加载CMake配置并构建解决方案

💡 提示：官方提供预编译版本，普通用户无需编译源码，直接下载可执行文件即可使用

🎯 开始提取游戏文本

基础使用流程

1. 启动Textractor，点击"附加进程"按钮选择目标游戏
2. 自动钩子：点击"Search for hooks"按钮让软件自动查找文本输出函数
3. 手动配置：如自动钩子失败，可在include/defs.h中定义自定义钩子规则
4. 查看结果：提取的文本会实时显示在主窗口，支持复制、翻译等操作

高级技巧

• 使用正则表达式过滤文本：通过"Regex Filter"扩展实现精准提取
• 多线程处理：host/textthread.h提供线程安全的文本处理机制
• 翻译集成：直接调用内置的谷歌翻译或DeepL翻译扩展

🛠️ 扩展开发指南

开发环境准备

• C++开发环境（推荐Visual Studio 2019+）
• Qt 5.13开发库
• 熟悉Windows API和进程注入技术

简单扩展示例

1. 创建新的扩展项目，包含头文件extensions/extension.h
2. 实现Extension接口，重写文本处理方法
3. 编译为DLL并放入extensions目录
4. 在软件设置中启用新扩展

🔍 参考示例：extensions/googletranslate.cpp展示了如何开发翻译类扩展

📚 官方文档与资源

用户手册

• 详细教程：docs/TUTORIAL.md
• 贡献指南：docs/CREDITS.md

常见问题

• 钩子失败：尝试以管理员身份运行或检查游戏是否64位架构
• 文本乱码：在设置中调整编码格式，支持UTF-8、Shift-JIS等
• 性能问题：禁用不必要的扩展，尤其是正则替换和翻译功能

🌟 为什么选择Textractor？

相比传统的文本提取工具，Textractor具有三大优势：

1. 兼容性更广：支持超过20种游戏引擎，包括Unity、Unreal和自研引擎
2. 速度更快：采用多线程处理架构，文本提取延迟低于10ms
3. 完全免费：开源无广告，可自由修改和分发

无论你是游戏本地化团队、MOD开发者还是游戏爱好者，Textractor都能为你提供高效、灵活的文本提取解决方案。立即尝试，开启游戏文本探索之旅吧！