LunaTranslator 完整指南:免费把视觉小说日语文本实时翻译出来,直接嵌进游戏画面
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
玩日文视觉小说,最大的门槛就是满屏汉字对白:想看剧情,就得在游戏窗口和翻译网站之间来回切。LunaTranslator 是一款免费的视觉小说实时翻译工具,它把抓文本、翻译、显示三步全包了——台词自动抓取、实时送翻,中文结果要么悬浮在游戏旁边,要么直接嵌进游戏画面里,全程不用离开游戏。
安装与启动,先把软件跑起来
Windows 用户不需要自己编译:下载官方预编译包,解压就能用。有个坑要避开——别把目录放进C:\Program Files这类系统路径,否则即使给管理员权限,也可能存不了配置和缓存。
日常使用双击LunaTranslator.exe普通模式启动即可;只有当游戏本身要求管理员权限运行时,才换LunaTranslator_admin.exe启动。想从源码跑起来的话,克隆仓库后在src目录里双击run.bat:
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator下载与启动细节见 docs/zh/README.md。
先用 HOOK 模式跑通:直接读游戏内存里的台词
LunaTranslator 的主线路是 HOOK 模式。HOOK 说白了就是挂进游戏进程里,直接把内存中的文本读出来,不需要截图,延迟是几种方式里最低的,实时翻译首选它。
从选进程到选文本行
顺序很重要:先启动游戏,再切到 HOOK 模式。选进程有两种办法——在进程列表里手动挑游戏,或者把游戏快捷方式直接拖进软件窗口,它会自动拉起游戏并完成挂钩。
注入成功后会弹出「选择文本窗口」。让游戏跑一会儿、显示几句对白,窗口里就会列出若干候选文本行,挑出和游戏里台词吻合的那一行,翻译流程就开始了。
内嵌翻译:直接替换游戏里的原文
如果游戏支持内嵌,候选行旁边会出现「内嵌」按钮。开启后,译文会替换游戏里的原对白,眼睛都不用挪到翻译窗口。
它的原理是在游戏显示文本的瞬间停住游戏,把文本送去翻译,再改回内存继续运行,所以有两点要注意:并非所有游戏都支持内嵌(没有内嵌按钮就说明不行);翻译慢的时候游戏会明显卡一下,可以在设置里限制等待时间。内嵌后出现乱码,通常是字体或字符集问题,设置里的「修改游戏字体」和「将汉字转换成繁体/日式汉字」就是用来处理它的。
- HOOK 实现源码:src/NativeImpl/LunaHook/
- 内嵌翻译文档:docs/zh/embedtranslate.md
HOOK 不进去的老游戏,改走 OCR 截图识别
有些老游戏 HOOK 注入不了,这时切到 OCR 模式。原理很直白:你在游戏上框一个台词区域,软件按一定频率截图、识别文字、送翻译。识别引擎可以选开源的 Tesseract、系统自带的 Windows OCR,也有百度等在线服务。
调节识别频率和灵敏度
拿不准怎么配就选「周期执行」这个截图策略,最省心。之后觉得识别太频繁(每帧都翻、浪费资源)或太迟钝(台词换了好几轮才翻),就调「图像一致性阈值」:调大只在画面变化明显时重新识别,调小则反应更灵敏。遇到动态背景、立绘动图干扰的场景,还有「分析图像更新」等进阶策略,文档里有逐项说明。
- OCR 引擎目录:src/LunaTranslator/ocrengines/
- OCR 参数详解:docs/zh/ocrparam.md
接翻译引擎:从在线接口到本地大模型
抓到文本之后,翻译交给引擎。在线接口(各家翻译 API、大模型通用接口)填好密钥就能用,多个密钥还会自动轮询。不想依赖网络的话,有本地方案可用。
本地大模型翻译,断网译文也不出机器
选内置的 LLaMA.cpp 引擎(一个在本地跑大模型的运行时),指向一个 GGUF 模型文件,翻译就全在本机完成,一个字都不发出去 📴。仓库里自带了模型拉取脚本 src/scripts/gethfmodels.py,需要时跑一下即可。
顺带学习:查词、朗读与生词卡
游戏之外它也能当外语学习工具:
复制外文到剪贴板,自动触发翻译;
选中文案可查 JPDB、有道等词典;
译文一键朗读,生词能同步进 Anki 做成记忆卡;
日语还能分词、给汉字标假名注音。
词典引擎:src/LunaTranslator/cishu/
日语分词假名注音:docs/zh/qa1.md
常见卡点:现象与处理办法
| 现象 | 处理办法 |
|---|---|
| HOOK 模式选不到文本行 | 在「选择文本窗口」换一条候选行;仍不行就切 OCR 模式 |
| 注入失败或提示「找不到重要组件」 | 挂钩用的 DLL 容易被杀软清理,把目录加进信任/排除项后重新下载解压;游戏需要提权时改用LunaTranslator_admin.exe |
| OCR 识别太频繁或太迟钝 | 相应调大或调小「图像一致性阈值」 |
| 抓到的文字有乱码、字符或整行重复 | 启用文本处理:去除重复字符、去除重复行、过滤无关字符 |
| 内嵌后游戏里显示乱码 | 开「修改游戏字体」选支持中文的字体;古早日文游戏试试转繁体/日式汉字 |
文本处理的组合用法详见 docs/zh/textprocess.md。
延伸文档:
- 基本用法:docs/zh/basicuse.md
- 内嵌翻译:docs/zh/embedtranslate.md
- 文本处理:docs/zh/textprocess.md
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考