godot · engine · tutorial
如何將 Godot 遊戲翻譯成繁體中文
RuneTranslate 把 Godot 3.x / 4.x 遊戲翻譯過來:開啟 .pck(即便嵌在 .exe 裡)、用 GDRE Tools 反編譯 GDScript 和場景,並列出 UI 與對話。匯出會重新封裝進 .exe 或獨立的 .pck。請驗證建置版本能執行。
RuneTranslate 能翻譯以 Godot 打造的遊戲,這個免費、開源的引擎已悄悄成為發行獨立遊戲最受歡迎的方式之一。Godot 向來是從外部最難翻譯的引擎之一,因為已發行的 Godot 遊戲是一個密封的盒子:一切都住在單一的 .pck 封存檔裡(常常黏在 .exe 本身的尾端),腳本被編譯成 GDScript 位元組碼,場景則存成二進位。RuneTranslate 會打開那個盒子、讀出文字,並把你的譯文封裝回去。
Godot 橫跨許多版本和封裝風格,所以先說在前頭:如果你把 RuneTranslate 指向一款 Godot 遊戲,而它偵測不到、打不開,或匯出的副本無法執行,請告訴我們。文末有更多說明。
Godot 究竟是什麼
Godot 是一個免費、採 MIT 授權的開源遊戲引擎,已成為 2D 和 3D 獨立遊戲的主流選擇,也有越來越多的日本獨立作品發行在它上面。遊戲通常以 GDScript(Godot 自己的類 Python 語言)撰寫,並編排成場景,也就是存成資源的節點樹。當遊戲被匯出時,所有內容(腳本、場景、圖片、音訊)都會被打進一個 .pck 封裝檔裡,它不是放在執行檔旁邊,就是(非常常見地)黏在 .exe 本身的尾端。正是這種封裝方式,讓 Godot 遊戲看起來密不透風。
Godot 遊戲為何一直很難翻譯
和 Ren'Py 這類以腳本為主的引擎不同,已發行的 Godot 遊戲幾乎不會以純文字暴露任何東西:
- 一切都在 `.pck` 裡。 沒有散放的腳本或文字檔可以編輯,而當封裝檔嵌在
.exe裡時,甚至沒有一個看得見的.pck可供工具去指向。 - 腳本是編譯過的。 GDScript 以已編譯的位元組碼(
.gdc)發行,而在現代 Godot 4 中,該位元組碼還被額外壓縮,所以烘焙進程式碼裡的對話,不是你能用 grep 找、或用文字編輯器打開的東西。 - 場景是二進位的。 UI 標籤和選單文字住在以 Godot 二進位資源格式(
.scn)儲存的場景檔裡,而不是你在編輯器裡看到的、人類可讀的.tscn。 - 不是每款遊戲都用翻譯檔。 Godot 有一套一等公民的在地化系統(CSV /
.po→.translation),但很多遊戲,尤其是較小的獨立作品,從不使用它,而只是把文字寫死在腳本和場景裡。RuneTranslate 兩種都讀:寫死的字串(在.gd、.tscn、.tres、.cfg和project.godot裡),以及已編譯的 CSV 翻譯表,匯出時會就地修補。封裝檔裡的.po目錄暫時還不讀取。
RuneTranslate 現在能做什麼
RuneTranslate 把 Godot 當作一等公民的引擎,替你重建可讀的專案。在底層,它隨附了一份 GDRE Tools(開源的 Godot 逆向工程工具包),並用它來:
- 解開 `.pck` 的封裝:獨立的、
data.pck,或黏在.exe尾端的封裝檔(RuneTranslate 會自動偵測嵌入封裝檔的簽章)。 - 反編譯已編譯的 GDScript(
.gdc→.gd),讓程式碼裡的對話和旁白重新變得可讀。 - 轉換二進位場景(
.scn→.tscn),讓上面的標籤和 UI 文字能被擷取出來。
然後它掃描復原出的專案,在編輯器裡依檔案分組,列出每一個可翻譯的字串(腳本對話、場景/UI 文字、翻譯表、Dialogic 和 Dialogue Manager 的對話,以及 JSON 資料檔),引擎標記會被遮蔽在預留位置後面,讓翻譯服務永遠不會弄亂它。匯出時,它把你的譯文拼接回復原出的原始碼,並重新封裝成一份可執行的遊戲副本(具體做法詳見下文)。
你需要準備什麼
- Windows / Linux 版 RuneTranslate:免費,每一種引擎和除了 RuneLingua 以外的每一個翻譯服務都已解鎖。
- 一個 Godot 遊戲資料夾:通常只有遊戲的
.exe(封裝檔嵌在裡面),或一個.exe加上旁邊的.pck/data.pck。Godot 3.x 和 4.x 都支援。 - 一個目標語言:英文、西班牙文、法文、德文、葡萄牙文、俄文、繁體中文、義大利文、土耳其文、越南文,以及 20 多種其他語言。
- 一個翻譯服務。免費的 Google Translate 開箱即用;DeepL 有免費方案;OpenAI、Anthropic、本機模型(Ollama / LM Studio),以及任何相容 OpenAI 的 API 都需要自備金鑰。Godot 遊戲通常對話量大,所以 LLM(OpenAI / Anthropic)或 DeepL 讀起來最適合故事文字。
步驟 1:開啟遊戲資料夾
啟動 RuneTranslate,點擊新增專案,把它指向 Godot 的遊戲目錄,也就是含有遊戲 .exe(以及 .pck,如果它是單獨發行的)的資料夾。引擎偵測會自動執行:它會辨識出執行檔尾端的嵌入封裝簽章、散放的 .pck,或一個 Godot 專案。你的原始檔案永遠不會被修改。
步驟 2:解開封裝並復原專案
RuneTranslate 會執行它隨附的 GDRE Tools 附屬程式,解開封裝、反編譯已編譯的 GDScript,並把二進位場景轉換成可讀的原始碼。然後它掃描復原出的專案,依檔案分組列出每一行可翻譯的內容(腳本裡的對話和旁白、場景裡的標籤和 UI 文字、遊戲的翻譯表、Dialogic 和 Dialogue Manager 的對話,以及 JSON 資料檔)。資源路徑、節點名稱和其他程式碼識別碼會被過濾掉,所以你只會翻譯玩家真正看得到的字串。
步驟 3:翻譯
選一個翻譯服務並執行。對於以故事為主的遊戲,LLM(OpenAI / Anthropic)最適合角色語氣,DeepL 處理旁白又快又乾淨,而免費的 Google Translate 對短 UI 字串已經夠用。Godot 遊戲常常把對話以長長的行陣列存在單一腳本裡(一個「故事資料庫」),所以同一個角色名稱或地名會出現數百次。事先替你的角色陣容和關鍵詞彙建好詞彙表,讓它們處處翻得一模一樣;詳見詞彙表 101。可以用 AI 精修器再多做一輪,修掉機器翻譯常留下的生硬措辭。
步驟 4:匯出翻譯後的版本
點擊匯出。因為原始腳本是已編譯的位元組碼,RuneTranslate 採用原始碼覆蓋的做法:它把你的譯文寫進復原出的 .gd / .tscn 原始碼、捨棄已編譯的 .gdc / 二進位 .scn(讓引擎退回使用散放的翻譯後原始碼)、重新封裝一個全新的 .pck,並把它放回遊戲原本存放的位置:重新嵌進 .exe 的一份副本裡,或寫成旁邊的 .pck。你的原始遊戲不會動;你會得到一份獨立、可執行、已翻譯的副本。
匯出範圍: 無論封裝檔是嵌在 .exe 裡,還是以獨立的 .pck 放在旁邊,Godot 3 和 Godot 4 的遊戲都能匯出。兩種情況下,你得到的都是一份獨立、可玩、已翻譯的副本。
步驟 5:確認副本能執行
匯出的版本依賴 Godot 執行階段在載入時編譯散放的翻譯後腳本原始碼,所以在分享之前,請先啟動一次匯出的遊戲,確認對話和選單顯示的是你的語言。如果某個腳本載入不了,那正是能幫我們加強支援的那種回報(見下文)。
已知的限制
- 在重新發行之前,先確認匯出的遊戲能正確啟動並閱讀。
- `.po` 目錄。 RuneTranslate 讀取腳本、場景、JSON 資料檔、Dialogic 和 Dialogue Manager 檔案裡的來源語言文字,以及已編譯的 CSV 翻譯表,但不讀取封裝檔裡的
.po目錄。 - C# / .NET(Mono)遊戲。 RuneTranslate 專注於 GDScript;編譯進 C# Godot 遊戲邏輯裡的文字,只有當遊戲從它自己的取代檔載入字串時才處理得到。
- 畫進圖片裡的文字。 以美術形式算繪出來的標題或標誌是像素,不是字串,那是圖片文字翻譯要處理的事,不是腳本擷取。
- 非拉丁文字的目標語言,取決於遊戲是否附帶了一套真正能顯示它們的字型。
告訴我們哪裡壞了
Godot 橫跨許多引擎版本和封裝風格,我們並未全部見過。如果某款遊戲偵測不到、解不開封裝,或匯出了無法啟動的東西,請回報。遊戲名稱、它的 Godot 版本,以及它的封裝方式(嵌入封裝檔,還是散放的 .pck),正是最能幫我們最快加強支援的資訊。
下載 RuneTranslate,把它指向你一直想讀的那款 Godot 遊戲,試試看。想看另一個現代引擎,請接著看 Unity 教學。
相關閱讀
準備好試用 RuneTranslate 了嗎?
免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。
下載 Windows、Mac 和 Linux 版
