3步让LunaTranslator替你翻译视觉小说:翻译器新手完整上手指南
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款免费的视觉小说翻译工具,能把游戏里的对白文本直接翻译成中文。无论你是卡在日文 galgame 文字上的玩家,还是想读英文游戏中文界面的用户,照这篇指南操作,第一次就能让游戏窗口出译文。
把 LunaTranslator 跑起来
LunaTranslator 是 Windows 程序,发布版按仓库内 docs/zh/README.md 的下载入口获取,解压到任意目录后运行LunaTranslator.exe。两个注意事项:
- 别放到
C:\Program Files这类特殊路径,否则可能无法保存配置甚至无法运行。 - 软件靠把 DLL 注入游戏来提取文本,极易被杀毒软件误报。如果启动时报「找不到重要组件 / Missing embedded Python3」或卡在「正在等待DLL注入到游戏中」,把软件目录加入杀软信任列表后重新解压。
如果你要阅读源码或官方文档,可以把仓库克隆到本地:
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator全部官方文档都在 docs/zh/ 目录下。
第一次用 HOOK 模式让游戏出译文
HOOK 模式直接注入正在运行的游戏进程读取文本,是最精确的翻译来源。
- 游戏已经启动时:打开软件,进入 HOOK 模式,在弹出的选择窗口里选中游戏进程并确认。
- 游戏还没启动时:把游戏的 exe 直接拖拽到 LunaTranslator 窗口上松开,软件会自动启动游戏并完成 HOOK,省去手动找进程。
HOOK 成功后会弹出「选择文本」窗口。让游戏说一句对白,从候选文本行中选中与游戏文本一致的那一行,翻译立即开始。如果窗口里出现「内嵌」按钮,说明游戏支持内嵌翻译:激活后译文直接写回游戏对话框里,比外挂窗口更连贯,细节见 docs/zh/embedtranslate.md。
如果候选列表里始终没有正确文本,说明这个游戏读不出内存文本,就切换到下一节的 OCR 模式。
HOOK 读不出文本时改用 OCR 识别
OCR 模式按一定频率截取游戏画面,用图像识别读出文字再翻译。
- 进入 OCR 模式后,点击「选取识别区域」按钮,在游戏文字区框选一块区域,软件随后会持续识别并翻译这块区域。
- 注意旁边有一个默认图标相同的按钮,它只用于临时识别一次,适合偶尔出现的选择肢,别拿来当持续识别用。
- 游戏文字出现在多处(如对话框之外还有字幕)时,到 OCR 设置 → 其他中激活「多重区域模式」,逐个添加区域,再用「切换到上一个/下一个区域」快捷键在不同区域间跳转并立即重新识别。
分支处理:如果同一句话被反复重新翻译,说明 OCR 结果抖动,调高 docs/zh/ocrparam.md 里的「文本相似度阈值」;如果 HOOK 模式每次只提取出一两个字,是游戏文字显示太慢,到 docs/zh/hooksettings.md 中提高「刷新延迟」。
把重复操作交给快捷键
快捷键默认不生效。先在设置中激活「是否使用快捷键」,再逐个启用并指派按键。推荐优先设置这几个:「选取OCR范围」快速换识别区域、「进行一次OCR」临时识别一次选择肢、「绑定窗口」把翻译窗口关联到游戏窗口(OCR 模式下区域可跟随游戏窗口移动)、以及「禁用其他全部快捷键」一键静音所有按键。完整按键清单及各自行为见 docs/zh/fastkeys.md。
常见卡点
Q:启动提示「找不到重要组件 / Missing embedded Python3」怎么办?是杀毒软件删掉了内置组件。把软件目录加入排除项后重新下载解压即可,不要反复在原目录启动。
Q:为什么需要管理员权限版LunaTranslator_admin.exe?部分游戏以管理员级别运行,普通进程无法 HOOK 它。这类游戏用管理员版启动;其余情况普通版即可。
Q:HOOK 后翻译出来得很慢?默认刷新延迟偏保守,用于避免文字逐字跳变。文本稳定的话,适当调低 HOOK 设置里的「刷新延迟」,但别低到又出现逐字刷屏。
Q:需要自己配置翻译引擎吗?内置在线引擎开箱即用。想换大模型翻译、离线翻译等,实现都在 src/LunaTranslator/translator/ 目录,可在设置里切换。
接下来往哪深入
跑通 HOOK/OCR 基本流程后,可以按具体游戏微调 docs/zh/hooksettings.md 的 HOOK 参数与 docs/zh/ocrparam.md 的自动执行策略;OCR 引擎实现位于 src/LunaTranslator/ocrengines/,完整文档索引在 docs/zh/index.md。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考