支援的引擎 · 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
開啟 Ren'Py 遊戲資料夾
把 RuneTranslate 指向含有遊戲執行檔的資料夾。引擎偵測會自動把專案歸類為原始碼驅動(有 .rpy)、編譯檔(只有 .rpyc)或封存檔(只有 .rpa)。隨附的 unrpyc 和 rpatool 附屬程式會自動執行,不需要安裝 Python。
- 步驟 2
選擇目標語言和翻譯服務
選擇目標語言(30 多種支援語言之一)和翻譯服務。Anthropic Claude 和 OpenAI GPT-4o 最適合 Ren'Py 對話,因為它們比統計式 MT 更能保留語氣、語域和擬聲詞。DeepL 則是長篇描述性旁白的穩妥次選。
- 步驟 3
翻譯對話行和選項選單
RuneTranslate 會擷取每一行可翻譯的內容(對話、選項文字、畫面標籤、UI 字串)並分批。Ren'Py 特有的標記([[player_name]]、{color=#fff}…{/color}、{b}…{/b})在翻譯期間會被遮蔽,讓 LLM 把它們當成不透明的預留位置,之後再逐字還原。
- 步驟 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 的遊戲已測試)

