renpy · tutorial · engine
如何將 Ren'Py 遊戲翻譯成繁體中文(完整教學)
用 RuneTranslate 把 Ren'Py 視覺小說翻譯成繁體中文:處理散裝的 .rpy、已編譯的 .rpyc 和已封存的 .rpa 遊戲、遮蔽標記、隨附一個 CJK/非拉丁字型,並匯出一個遊戲啟動時載入的翻譯。
Ren'Py 是支撐大多數西方和日本視覺小說的 Python 引擎,從小小的 itch.io 遊戲 jam 作品到商業 Steam 作品都有。它是最乾淨、最容易翻譯的引擎之一:RuneTranslate 從不覆寫原始腳本,而是把翻譯分層疊在上面,讓遊戲保持完整。本指南會帶你從頭到尾,用 RuneTranslate 把一款 Ren'Py 遊戲翻譯成繁體中文(或任何語言),涵蓋 Ren'Py 遊戲發行的三種形態:散放的 .rpy 原始碼、只有編譯版的 .rpyc,以及封存的 .rpa。
你需要準備什麼
- Windows / Linux 版 RuneTranslate:免費,每一種引擎和除了 RuneLingua 以外的每一個翻譯服務都已解鎖。
- 一個 Ren'Py 遊戲資料夾。也就是包含遊戲
.exe加一個game/子資料夾(內有.rpy、.rpyc和/或.rpa檔案)的目錄。 - 一個目標語言:英文、西班牙文、法文、德文、葡萄牙文、俄文、繁體中文、義大利文、土耳其文、越南文,以及 20 多種其他語言。
- 一個翻譯服務。免費的 Google Translate 開箱即用;DeepL 有免費方案;OpenAI、Anthropic、本機模型(Ollama / LM Studio),以及任何相容 OpenAI 的 API 都需要自備金鑰。視覺小說對話量大、對語氣敏感,所以 LLM(OpenAI / Anthropic)或 DeepL 通常讀起來最好。
步驟 1:開啟遊戲資料夾
啟動 RuneTranslate,點擊新增專案,把它指向 Ren'Py 的遊戲目錄(含 .exe 的資料夾,或內層的 game/ 資料夾)。引擎偵測會自動執行,一看到 game/ 目錄樹就把專案辨識為 Ren'Py。
文字如何被讀取,取決於開發者發行了什麼:
- 原始碼遊戲:
game/下散放的.rpy腳本。RuneTranslate 直接解析它們。這是最理想的情況。 - 只有編譯版的遊戲:只有
.rpyc位元組碼。一個隨附的 unrpyc 附屬程式會先把它們反編譯回可讀的.rpy,然後照常解析。 - 封存的遊戲:腳本打包進一個
.rpa封存檔裡。RuneTranslate 用一個內建、經過改造的 rpatool,把它解開到每個專案專屬的工作區,位於%APPDATA%/RuneTranslate/renpy-workspace/<projectId>/,反編譯,然後解析。我們的 rpatool 分支能辨識廠商自訂的RPA-x.y封存變體,所以它能打開許多上游工具打不開的封存檔。
你的原始遊戲資料夾永遠不會被修改。
步驟 2:Ren'Py 文字如何被擷取
RuneTranslate 從腳本中拉出 say 陳述式(對話)、menu 選項和可翻譯的 UI 文字,並在編輯器裡依檔案分組列出。Ren'Py 的文字標記,包括 {b}、{color=#fff}、{w} 等待、{i} 斜體,以及 [player_name] 這類變數插值,在任何東西送到翻譯服務之前,都會被遮蔽在數字 [[R#]] 預留位置後面,送回來時再還原。機器從不會看到標記,所以它無法弄亂、丟棄或翻譯它們。
步驟 3:翻譯
選一個翻譯服務並執行。對於一部中等長度的視覺小說(約 8,000-15,000 行),在 Supporter 方案上:
- OpenAI / Anthropic:最適合角色語氣、笑話和風格化的台詞;整款遊戲的 API 成本大約幾美元。編輯器會在你投入前顯示 token + USD 的估算。
- DeepL:處理旁白又快又乾淨;免費方案每月涵蓋 50 萬字元。
- 免費的 Google Translate:$0,對選單和短行已經夠用,對對話則較弱。
事先替你的角色陣容和反覆出現的詞彙建好詞彙表,讓每一幕都把名字翻得一模一樣,詳見詞彙表 101。在免費方案上翻譯會被適度限速(在 AI 服務上大約慢 2 倍,在免費服務上則更少,做法是較低的並行數、較小的批次、批次之間短暫停頓),輸出品質完全相同。付費方案以全速執行,並增加翻譯記憶和翻譯服務分流。
步驟 4:在編輯器裡校對
每一行都會落進表格裡,緊挨著它的原文,預設是日文,或你把專案設成的任何語言(中文、韓文、英文等等)。就地編輯機器弄錯的任何內容(失去焦點或按 Ctrl+Enter 時自動儲存)、對你改過名稱的詞彙用尋找取代,或執行可選的 AI 精修器,做一輪感知上下文的二次校對。因為 Ren'Py 的對話篇幅很長,這裡就是打磨發生的地方。
步驟 5:匯出可玩的版本
點擊匯出。RuneTranslate 不依賴 Ren'Py 偏好的 tl/ 裡的散放 .rpy,因為那僅適用於以對話 id 為索引的文字有效,而已編譯的遊戲無法穩定地提供這些 id。取而代之,它把幾個檔案放進 game/,並在執行階段套用翻譯:
rt_translations.json:一份涵蓋每一行對話和選單行的「原文 → 譯文」對應表。zzz_runetranslate_language.rpy:一個小型的執行階段掛鉤,安裝一個config.say_menu_text_filter。它會把遊戲即將顯示的每一行與對應表比對,並換入你的譯文,同時強制遊戲的使用中語言設為翻譯後的那個,讓畫面和 UI 文字隨之改變。tl/translated/translation.rpy:一張承載全部譯文的字串表,_()的 UI / 畫面字串(按鈕、選單、工具提示)就是透過它解析的。- 當目標語言需要時,一套隨附的字型加上
zzz_runetranslate_font.rpy,見下方的非拉丁文字說明。
執行遊戲的 .exe,就能以你的目標語言遊玩,原始腳本和封存檔原封不動。要切換回去,只要移除 RuneTranslate 新增的檔案:rt_translations.json、zzz_runetranslate_language.rpy、隨附的字型及其 .rpy,以及 tl/translated/。
非拉丁文字的語言
大多數 Ren'Py 遊戲只附拉丁字型,所以中文、韓文、日文、泰文或阿拉伯文否則會顯示成空白方塊。當你以其中之一為目標時,RuneTranslate 會隨附一套合適的字型(NanumGothic / Noto Sans),並把遊戲的字型指向它(包括遊戲自己建置的字型組),讓翻譯後的文字正確顯示,而不必編輯遊戲自己的資源。
已知的限制
- 標準的 RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0 和常見的廠商改版封存檔會自動開啟;真正非標準的容器可能解不開。
- 烘焙進圖片裡的文字(標題標誌、手繪 UI、CG 說明)不屬於腳本;請在 Image Studio 裡翻譯它,它會從
game/和.rpa封存檔裡讀取美術圖,並把翻譯後的圖片以散放檔案寫回。 - 遊戲在執行階段拼出來的文字(商店行、屬性行、通知)會透過執行階段掛鉤翻譯;以其他方式拼裝文字的畫面,可能仍需要在編輯器裡快速手動修一遍。
為什麼這比舊辦法更容易
手動路線意味著手工反編譯 .rpyc、對封存檔執行 rpatool,然後要不是就地翻譯原始碼(並在遊戲下次更新時再次弄壞它),就是一行一行地手工撰寫 tl/ 區塊,還要在非拉丁文字的語言上與缺失的字型搏鬥。RuneTranslate 點幾下就完成反編譯 + 解開封裝 + 擷取 + 執行階段掛鉤這整條鏈,同時保持編輯器開啟,讓你掌控措辭。
查看 Ren'Py 引擎頁面瞭解完整功能清單,讀 Kirikiri 視覺小說指南看另一個 VN 引擎,或下載 RuneTranslate在真實遊戲上試試看。
準備好試用 RuneTranslate 了嗎?
免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。
下載 Windows、Mac 和 Linux 版
