LunaTranslator 内嵌翻译实战指南如何判断游戏支持、修复乱码并逐项调参【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 的内嵌翻译功能不走翻译器自己的悬浮窗口而是把译文直接写进游戏进程的内存让译文像游戏原生文本一样出现在画面里。本文基于官方文档 docs/zh/embedtranslate.md 与 texthook.py 源码实现一次讲清四件事怎么判断当前游戏支不支持内嵌、乱码到底出在字体还是字符集、为什么翻译慢必然卡游戏以及每个内嵌设置项何时该开、何时该关。快速上手如何判断当前游戏是否支持内嵌翻译先说结论内嵌并不是所有游戏都能用。它依赖引擎的文字输出点能否被安全地暂停—改写—恢复所以第一步永远是判断支持情况。判断支持打开「选择文字」对话框选中某个 Hook即注入到游戏进程的文字输出函数上的拦截点翻译器靠它截获文本到的文字条目后看选项栏——如果找不到「内嵌」这一栏说明该条目不支持内嵌出现「内嵌」栏才可以启用。这个标记来自 Hook 发现机制ThreadEvent_maybeEmbed回调onnewhook(hc, hn, tp, isembedable)会携带isembedable参数src/LunaTranslator/textio/textsource/texthook.py 第 675 行标识该 Hook 点是否可内嵌并同步显示在对话框中。开启内嵌对支持的条目直接在选项里勾选「内嵌」即可无需其他操作。「显示」与「内嵌」是两个独立开关组合方式决定译文出现在哪里勾选组合效果只勾「显示」常规外挂模式译文只显示在翻译器窗口只勾「内嵌」译文只写回游戏画面翻译器窗口无任何内容两者都勾游戏内嵌入译文窗口同时展示更多翻译内容译文、读音、双语对照等 小贴士想在游戏画面看到嵌入译文、同时又要在窗口里核对读音或对照内容时两个开关同时勾上即可二者互不冲突。乱码修复先查字体再查字符集启用内嵌后最常见的异常是译文变成乱码或方块。官方文档给出的排查原则是内嵌乱码大多属于字体问题而非字符集问题。按下面三种情况对号入座英文游戏或新引擎 Unicode 游戏中文变成方块说明游戏本身没有中文字体写进去的中文字符渲染不出来。此时应启用「修改游戏字体」源码对应changefont开关与changefont_font字体名选一款系统已安装、支持中文的字体如宋体、微软雅黑游戏内中文即可正常显示。Unicode 引擎KiriKiri 吉里吉里、RenPy、TyranoScript、RPG Maker MV 等这类游戏使用 UTF-8 / UTF-16 字符集即使出现乱码也几乎都是缺字体所致按上一条换字体方案处理即可。古早日式 Galgame换完字体仍乱码说明是老游戏自带Shift_JIS字符集的问题单纯换字体无效。此时应启用「将汉字转换成繁体日式汉字」trans_kanjisrc/LunaTranslator/textio/textsource/texthook.py 第 585-586 行处理链路是先用zhconv.convert(trans, zh-tw)把译文转成繁体再经过 kanjitrans.py 中的kanjichs2ja简繁→日式汉字映射表共 469 条例如「谈→談」「挂→掛」「绿→緑」转换为日式写法从而减少与 Shift_JIS 的冲突。反过来如果某游戏不开这项也能正常显示简体中文就保持关闭。Unity 引擎有一个特例当引擎为 Unity 且开启了「修改游戏字体」时find_unity_font_dir会遍历当前目录查找包含arialuni_sdf_u字体资源的目录并回传给宿主进程src/LunaTranslator/textio/textsource/texthook.py 第 621-652 行用于正确处理 Unity 的 SDF 动态字体。如果你玩 Unity 游戏且内嵌显示异常优先确认字体设置是否真正生效。为什么翻译慢会卡游戏一条五步阻塞链路外挂模式与内嵌模式的本质区别在于前者只在翻译器窗口展示游戏进程不受影响后者必须在游戏显示文字之前完成一次内存改写。把源码链路拆开看就是五步Hook 拦截LunaHost 在游戏进程的文字输出函数处设置 Hook。newhookinsert检测到当前 Hook 代码位于该游戏的embedablehook可内嵌 Hook列表时调用Luna_UseEmbed(tp, True)将该线程标记为内嵌模式src/LunaTranslator/textio/textsource/texthook.py 第 554-565 行。停线程等待游戏显示文字前先调用嵌入的翻译回调此时游戏线程被停住待显示文字经EmbedCallback回调进入 Python 侧同文件第 261 行。等待译文getembedtext通过waitfortranslation(text)把文本发给翻译器并等待返回第 576-587 行。安全校验译文经__safechecktransresult比对原文与译文中的[...]、{...}占位标记若译文丢失了任何标记则整条丢弃第 567-574 行避免破坏游戏文本结构。写回内存处理后经Luna_EmbedCallback(tp, text, trans)写回游戏内存线程恢复执行画面直接呈现译文。看完链路结论很直白「停游戏 → 等译文 → 写回内存」全程阻塞游戏线程翻译引擎越慢、卡顿越久——这是内嵌的固有特性唯一能做的缓解手段是下面设置表里的「翻译等待时间」给等待设一个上限。内嵌设置全量速查表所有设置项都经set_settings_exsrc/LunaTranslator/textio/textsource/texthook.py 第 615-645 行统一下发到宿主进程。设置项作用默认值适用场景displaymode显示模式译文与原文之间是否插入换行0 为不换行译文直接替换/拼接在原文位置0默认保留原文结构若界面能容纳多行可在「翻译优化 → 翻译结果修正」加一条正则在译文前插换行timeout_translate翻译等待时间限制等待译文返回的最长时间超时放弃本次内嵌2 秒慢速引擎调低、本地快引擎可保持或调高trans_kanji汉字转繁体/日式汉字译文先转繁体再经日式汉字映射表改写关闭古早 Shift_JIS 日文游戏乱码limittextlength_use/limittextlength_length限制每行字数按目标语言单词分隔符把译文切分并重新换行40 字符每行字符数有限、译文溢出文本框右侧的游戏changefont/changefont_font修改游戏字体用系统字体替换游戏字体关闭英文/Unicode 游戏缺中文字体导致方块changefontsize_use/changefontsize字体相对大小等比缩放内嵌译文字号1.0换字体后文字过大溢出或过小难读clearText清除游戏内显示的文字清空原文使原文不渲染关闭伪装内嵌、避免窗口遮挡、纯学习模式翻译等待时间timeout_translate该值以秒为单位配置下发时换算成毫秒int(1000 * self.embedconfig.get(timeout_translate, 2))即默认 2 秒。如果你发现游戏卡得比译文出现的时间还长说明等待上限太宽松应把该值调低让超时后尽早放弃本次内嵌、恢复游戏执行本地高速翻译引擎则相反可适当调高以拿到更完整的内嵌译文。限制每行字数limittextlength某些游戏每行能容纳的字符数有限超出的部分会溢出到文本框右侧之外看不见。开启limittextlength_use后splitembedlines第 593-613 行按目标语言的单词分隔符getlangtgt().space中文逐字、英文按空格把译文拆成单词片段再以limittextlength_length默认 40 字符为上限重新拼装换行保证游戏内每行不超宽。清除游戏内显示的文字clearText启用后原文位置被清空、原文不渲染该参数随每次设置下发第 640 行。典型用法有三种伪装内嵌字符集/字体问题实在修不好时清掉游戏原文把翻译器窗口拖到原文字区域上方覆盖即可模拟出内嵌效果避免遮挡外挂翻译时窗口放文字区会与原文重叠、放别处又挡画面不如直接清掉原文让窗口摆放自由纯学习模式只想借游戏练日语时清掉原文配合窗口里的读音注音、双语对照等内容阅读更干净。风险清单与按游戏单独调参⚠️崩溃风险内嵌涉及对游戏进程内存的暂停与改写部分游戏存在一定概率因此崩溃这是已知风险。某游戏内嵌不稳定时退回外挂模式即可。⚠️译文被意外清空若内嵌译文突然变空检查原文是否含[...]、{...}等特殊标记——__safechecktransresult见上文「五步阻塞链路」第 4 步会丢弃丢失这些标记的译文防止写回结构被破坏。卡顿与崩溃之外还有一个更实用的机制按游戏单独保存内嵌配置。embedconfig属性src/LunaTranslator/textio/textsource/texthook.py 第 113-125 行的规则是embed_follow_default为 True 时读取全局配置globalconfig[embedded]关闭「跟随默认」后改读该游戏私有的embed_setting_private且未单独设置的项自动回退全局默认值。图形入口在游戏管理器的「内嵌翻译」页签setting.py 第 1370-1395 行页签内还提供「已激活的」embedablehook列表可对特定 Hook 点单独禁用内嵌。不同引擎、不同编码的游戏可以各存一套互不干扰的参数。延伸阅读内嵌翻译官方文档本指南的文档骨架Hook 与文字提取设置Hook 选择、特殊码与可内嵌 Hook 判定机制翻译优化与翻译结果修正显示模式下用正则给译文加换行的具体写法文本处理流程译文后处理管线模拟器游戏支持模拟器环境下内嵌翻译的额外注意事项常见问题 FAQ更多内嵌翻译排错经验【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考