Tataru Helper：FF14 实时翻译悬浮窗

项目简介

Tataru Helper 是一款面向《最终幻想14》（Final Fantasy XIV）的实时翻译悬浮窗。它直接从游戏中读取正在显示的文字，包括主线剧情（MSQ）、过场动画字幕、任务文本、NPC 台词和聊天频道，并即时翻译成你选择的语言，无需手动复制粘贴。

项目当前由 xDarkOne 维护，最初由 NightlyRevenger 创建，基于 Sharlayan 读取游戏内存中的文本。

主要功能

• 随游戏文本出现即时翻译：主线剧情、过场字幕、任务、NPC 台词和聊天。
• 文本由程序自动从游戏读取，不需要复制粘贴。
• 支持多种翻译引擎，包含免费引擎；某个引擎请求失败时自动切换到下一个已启用的引擎。
• 可开多个独立聊天窗口，每个窗口单独设置引擎、语言、字体、颜色和快捷键。
• 可勾选需要翻译的聊天频道，并分别设置各频道颜色。
• 存在人工制作的 XIV Rus 俄语翻译时，优先显示人工译文而非机器翻译。
• 悬浮窗支持点击穿透、置顶、自动隐藏，并可用快捷键开关。
• 界面提供 12 种语言，更新可自行安装。

翻译引擎

类型	引擎
免费、无需密钥或账号	DeepL（通过内置本地中转）、Google Translate、Yandex、Bing、Translate.com、ModernMT、Papago；可开启腾讯 TranSmart、火山引擎、阿里
使用自己的密钥	DeepL API、Google Cloud、Azure Translator、Yandex Cloud、OpenAI、Claude、Gemini、DeepSeek、YandexGPT、OpenRouter
本机或自建服务器	Ollama、LM Studio、LibreTranslate

各引擎的配置方法见官方 Guide。

安装与使用

Windows

1. 从最新 Release 下载 Setup.exe。
2. 运行安装程序；若出现 SmartScreen 提示，选择“更多信息”，再选择“仍要运行”。
3. 先启动游戏，然后从开始菜单或桌面快捷方式启动 Tataru Helper（不要再次运行 Setup.exe）。之后更新会自动安装。
4. 在设置中选择游戏语言和想要阅读的语言，再把悬浮窗拖到合适位置。
5. 在游戏聊天设置中，于任意标签页开启对应的消息类型。

每个 Release 还附带便携版 Portable.zip。

Linux

游戏在 Wine 下运行时可以使用安装脚本：

curl -LO https://raw.githubusercontent.com/NightlyRevenger/TataruHelper/master/scripts/linux/tataru-linux.sh
chmod +x tataru-linux.sh
./tataru-linux.sh install

脚本会找到游戏所用的 Wine，并在其旁边启动 Tataru Helper。具体可用范围与排错方法见 Documents/Linux.md。

注意事项

• 需要 DirectX 11 的 64 位《最终幻想14》客户端。
• Windows 10 或 11（64 位）；程序启动时会请求管理员权限，因为它需要从游戏内存中读取文本。发布包自带运行时，无需另装 .NET。
• Linux 支持通过在 Wine 下运行游戏实现，属于实验性功能。
• 这是一个悬浮窗翻译工具，与游戏内直接翻译的 Dalamud 插件 Echoglossian 是两种不同方案。
• 游戏补丁可能影响文本读取，届时可参考仓库中的 Documents/AfterAPatch.md 处理。

---

本作品整理自 GitHub 开源项目 NightlyRevenger/TataruHelper，原作者 @NightlyRevenger，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。