支持的引擎 · Ren'Py

完整支持 — 已重打包并实机运行

Ren'Py 翻译器 —— 翻译 Ren'Py 视觉小说(源代码、编译、归档)

Ren'Py 是占主导地位的基于 Python 的视觉小说引擎,用于从独立动力小说到长盛不衰的商业 VN 的一切。RuneTranslate 以三种模式翻译它:源代码驱动的项目(game/**/*.rpy)、只编译的发布版本(.rpyc,通过捆绑的 unrpyc 附属程序反编译),以及只归档的发布版本(.rpa,通过捆绑的 rpatool 附属程序拆包,含改版归档变体)。它提取 say / 旁白 / menu 行和 _() / __() / _p() UI 字符串,外加游戏从自己的代码里显示的文本:按钮和 HUD 标签、通知、保存在数据里的物品和任务名、运行时拼出来的行,以及它自带译文里的行。导出时,对话和菜单在运行时应用:一个生成的 .rpy 把每一条源行内容匹配(config.say_menu_text_filter)到一个 game/rt_translations.json 映射,并强制游戏语言为你的翻译 —— 刻意不用 Ren'Py 原生的基于 id 的 tl/ 块,因为那些 id 无法总是被复现。每条译文还会被写入一个真正的 game/tl/translated/translation.rpy 字符串块,_() UI 字符串就是通过它解析的。对于非拉丁目标语言,RuneTranslate 捆绑一个支持 CJK / 泰语 / 阿拉伯语的字体,并让游戏的字体指向它(包括游戏自己构建的字体组),于是译好的文字会正常显示,而不是方块。什么都不重新打包 —— 额外的 .rpy 文件和 JSON 落进 game/,紧挨原件。与 Supporter 档位的术语表搭配,在长 VN 里锁定角色名和招牌术语。

该引擎的术语表提示

Ren'Py VN 因角色声线而生死攸关 —— 女主角在三幕里被叫成 'Alice' / 'Aris' / 'Arisu' 会很快破坏读者的沉浸感。用术语表锁定每一个角色名、主角昵称的变体、地名,以及任何生造的世界观术语。屏蔽与翻译服务无关,所以无论你在预算跑用 DeepL 还是在对话密集的主要章节用 Claude,你的术语都保持一致。

术语表入门

如何翻译 Ren'Py

  1. 步骤 1

    打开 Ren'Py 游戏文件夹

    把 RuneTranslate 指向含游戏可执行文件的文件夹。引擎检测会自动把项目归类为源代码驱动(有 .rpy)、编译(只有 .rpyc)或归档(只有 .rpa)。捆绑的 unrpyc 和 rpatool 附属程序自动运行 —— 无需安装 Python。

  2. 步骤 2

    选择目标语言和翻译服务

    选择目标语言(30 多种支持之一)和翻译服务。Anthropic Claude 和 OpenAI GPT-4o 在 Ren'Py 对话上最强,因为它们比统计式 MT 更好地保留语气、语域和拟声词。DeepL 是长篇描述性旁白的稳妥第二选择。

  3. 步骤 3

    翻译对话行和选项菜单

    RuneTranslate 提取每一条可翻译的行(对话、选项文本、屏幕标签、UI 字符串)并分批。Ren'Py 特有的标记([[player_name]]、{color=#fff}…{/color}、{b}…{/b})在翻译期间被屏蔽,让 LLM 把它们当作不透明占位符,然后逐字还原。

  4. 步骤 4

    导出译好的构建

    RuneTranslate 把几个小文件丢进 game/:一个 rt_translations.json 映射,和一个生成的 .rpy,它在运行时把每一条源行内容匹配(config.say_menu_text_filter)并强制语言为你的翻译,于是对话和菜单显示译文,而无需重新打包 .rpa。每条译文还会作为字符串表写入 game/tl/translated/translation.rpy(_() UI 字符串通过它解析),当目标需要时捆绑一个 CJK / 非拉丁字体。重跑翻译器会保留你手动编辑过的行。

支持内容

  • 源代码驱动的游戏(game/**/*.rpy)
  • 只编译的游戏(.rpyc)通过捆绑的 unrpyc
  • 归档的游戏(.rpa):RPA-2 / 3 / 3.2 / 4.0 + 供应商 RPA-x.y 变体,通过捆绑的 rpatool
  • Say / 旁白 / menu 行、_() / __() / _p() UI 字符串、说话人名字,以及游戏从代码里显示或运行时拼出来的文本
  • Ren'Py 插值标记([[var]]、{color}、{b}、{i}、{size})得以保留
  • 运行时内容匹配应用 + 强制语言,加上一个游戏字体会回退到的捆绑 CJK / 非拉丁字体(无重打包)

局限

  • 带有真正非标准容器的归档暂不支持
  • Ren'Py 6.x 及更早版本未测试(Ren'Py 7 和 8 的游戏已测试)

延伸阅读

延伸阅读

文档

其他支持的引擎