支援的引擎 · GameMaker
GameMaker 翻譯工具 - 從頭到尾翻譯 GameMaker 和 GameMaker Studio 遊戲
GameMaker 遊戲(較早的版本以 GameMaker Studio 之名發售)把編譯後的資料放在一個檔案裡:Windows 上是 data.win,Linux 上是 game.unx,macOS 上是 game.ios。RuneTranslate 自己讀寫這個檔案,不依賴任何第三方工具或附屬程式。它會沿著遊戲的位元組碼追蹤每個字串,判斷它是否會傳到繪製或訊息函式,所以玩家看得到的文字會被擷取出來供翻譯,而查詢用的索引鍵、檔案名稱,以及遊戲拿來做比較的字串則原樣不動。遊戲隨附的語言檔(JSON、CSV、INI / 索引鍵=值、Yarn 和 Chatterbox 對話),以及 gettext 的 .po / .mo 語言檔也會一併讀取,標記和控制碼會遮蔽在預留位置後面,翻譯服務無法把它們弄壞。你可以使用任何供應商翻譯:DeepL、LLM(OpenAI / Anthropic)、免費的 Google 翻譯,或本機模型。匯出時,如果譯文需要遊戲字型裡沒有的字元(西里爾文、越南文、中文、日文、韓文、泰文、帶重音的拉丁字母),RuneTranslate 會以相符的風格把這些字形補進遊戲自己的字型;對日文、中文和泰文,只會在能從遊戲中確認文字方塊寬度的位置換行。每次匯出在取代任何東西之前,都會被重新讀取並逐位元組驗證。GameMaker 是新加入的引擎,已在以 GameMaker Studio 1.4、GameMaker Studio 2.3,以及 GameMaker 2022 LTS、2023 和 2024 版本製作的真實遊戲上完成端到端驗證。以 YYC(原生程式碼)編譯的遊戲是例外:它們的語言檔和字型可以翻譯,但程式碼裡的文字無法處理。來源語言預設為日文,可依專案單獨設定。
如何翻譯 GameMaker
- 步驟 1
開啟 GameMaker 遊戲資料夾
把 RuneTranslate 指向遊戲目錄:Windows 上是含有 data.win 的資料夾,Linux 上是含有 game.unx 的資料夾,macOS 版本則是含有 game.ios 的資料夾。偵測會自動辨認資料檔,開啟遊戲不會改動任何內容。如果遊戲是以安裝程式的形式提供,請先安裝。封裝成單一執行檔的 GameMaker Studio 1.4 遊戲,會在匯出時被解開成一般的遊戲資料夾。
- 步驟 2
擷取遊戲繪製的文字
RuneTranslate 自己讀取資料檔,不依賴第三方工具或附屬程式,並沿著遊戲的位元組碼追蹤每個字串,判斷它是否會傳到繪製或訊息函式。玩家看得到的文字會成為翻譯單元;查詢用的索引鍵、檔案名稱,以及遊戲拿來做比較的字串則原樣不動。遊戲隨附的語言檔(JSON、CSV、INI / 索引鍵=值、Yarn 和 Chatterbox 對話),以及 gettext 的 .po / .mo 語言檔也會列出來。
- 步驟 3
用你偏好的供應商翻譯
使用 DeepL、LLM(OpenAI / Anthropic)、免費的 Google 翻譯或本機模型翻譯。標記和控制碼會遮蔽在預留位置後面,翻譯服務無法重新排列、丟棄或翻譯它們,翻譯記憶會重複使用重複出現的行。
- 步驟 4
匯出翻譯後的版本
把翻譯後的副本匯出到另一個資料夾,或是就地匯出(部分 Steam 遊戲需要這樣)。如果譯文用到遊戲字型裡沒有的字元,匯出時會以相符的風格把這些字形補進遊戲自己的字型。對日文、中文和泰文,只會在能從遊戲中確認文字方塊寬度的位置換行,並遵守禁則規則。對於 macOS 或 Linux 版本,只會寫出被改動的檔案,由你複製覆蓋到安裝目錄上。
- 步驟 5
驗證翻譯後的副本能執行
每次匯出在取代任何東西之前,都會被重新讀取並逐位元組驗證。啟動翻譯後的遊戲,在分享之前先在遊戲裡檢查對話、選單和字型。
支援內容
- data.win(Windows)、game.unx(Linux)和 game.ios(macOS),由 RuneTranslate 自己讀寫,不依賴第三方工具
- 已在真實遊戲上端到端驗證:GameMaker Studio 1.4、GameMaker Studio 2.3、GameMaker 2022 LTS、2023 和 2024
- 遊戲繪製的文字:每個字串都沿位元組碼追蹤到繪製或訊息函式,所以查詢用的索引鍵、檔案名稱和被比較的字串原樣不動
- 遊戲旁邊的語言檔(JSON、CSV、INI / 索引鍵=值、Yarn 和 Chatterbox 對話),以及 gettext 的 .po / .mo 語言檔
- 標記和控制碼遮蔽在預留位置後面,翻譯服務無法把它們弄壞
- 缺少的字形(西里爾文、越南文、中文、日文、韓文、泰文、帶重音的拉丁字母)以相符的風格補進遊戲自己的字型,小尺寸像素字型使用內建的像素字型;精靈圖條帶字型也會被擴充
- 泰文不依賴排版引擎,透過預先組合的字形繪製;日文、中文和泰文的行只在能從遊戲中確認文字方塊寬度的位置換行,並遵守禁則規則
- 封裝成單一執行檔的 GameMaker Studio 1.4 遊戲,會在匯出時解開成一般的遊戲資料夾
- 每次匯出在取代任何東西之前,都會被重新讀取並逐位元組驗證
限制
- 以 YYC(原生程式碼)編譯的遊戲:只能翻譯它們的語言檔和字型,遊戲程式碼裡的文字無法處理
- 其他版本,例如 GameMaker Studio 2.2,或位元組碼為 13 / 14 的 GameMaker Studio 1.1 到 1.4,開啟時會出現「尚未驗證」的警告:請在遊戲裡檢查翻譯後的版本
- 不支援:GameMaker 8.x、GameMaker Studio 1.0 和早期的 1.1 建置版本、新的 GMRT 執行環境,以及 HTML5 或行動裝置封裝
- 不支援阿拉伯文等由右向左書寫的目標語言
- macOS 和 Linux 版本:匯出只會寫出被改動的檔案,需要你自己複製覆蓋到安裝目錄上
- 安裝程式不會被直接開啟:請先安裝遊戲

