登入

rpg-maker · how-to · engine · control-codes

如何翻譯 RPG Maker 遊戲

RPG Maker 是現存最好翻譯的引擎,文字就擺在一般資料檔裡。本文講清如何辨認你手上的版本、匯出一個能玩的譯好建置版本,並讓控制碼完好無損。

10 分鐘閱讀

在尋找日本獨立遊戲時,你最可能撞上的引擎就是 RPG Maker,它也是最容易翻譯的那一個。遊戲的文字並沒有被編譯進執行檔,而是放在隨遊戲一同發行的普通 JSON 或 Ruby 序列化資料檔裡。這正是 RPG Maker 翻譯得以成立的原因,也是下面這套流程最後能交給你一個真正可玩的建置版本,而不是一個靠猜畫面上有什麼的覆蓋層的原因。

本指南會說明如何辨認你手上是哪一代 RPG Maker、匯出流程、到底有哪些內容會被翻譯、控制碼如何撐過機器翻譯,以及某一行譯文回來不對時該怎麼辦。不論你是否使用 RuneTranslate 來做,它都應該派得上用場。

我手上是哪一代 RPG Maker?

會問這個問題的人,多半不知道自己手上是哪個版本,而答案決定了哪些事做得到、哪些做不到。打開遊戲資料夾,看下面這份清單裡第一個對得上的:

  • 一個 `www/` 資料夾,裡面有 www/data/*.json:RPG Maker MV。遊戲是一個 nw.js 應用程式;執行檔通常是 www/ 旁邊的 Game.exe。
  • 一個單獨的 `data/` 資料夾,裡面裝著 .json 檔案,沒有 www/:RPG Maker MZ。MZ 把一切上移了一層,這是分辨兩者最快的方法。
  • `Data/` 裡裝著 .rxdata、.rvdata 或 .rvdata2:分別是 RPG Maker XP、VX 和 VX Ace。如果 Data/ 看起來是空的,去根目錄找 Game.rgssad、Game.rgss2a 或 Game.rgss3a;那是同一批資料,裝在一個封裝的封存檔裡。
  • 根目錄下的 `RPG_RT.exe`,搭配 .lmt 和 .lmu 檔案:RPG Maker 2000 或 2003。這是完全不同的一代引擎。
  • 一個幾十到上百 MB 的 .exe,旁邊既沒有 www/ 也沒有 data/:很可能是 Enigma Virtual Box 建置版本,資料被封裝在執行檔裡面。見下文。

MV 和 MZ 非常相似,人們經常搞混,而一旦動手編輯,兩者的差異就變得重要。MV 與 MZ 比較逐項說明資料夾配置、外掛格式和訊息框的差別。

RPG Maker 2000 和 2003 的遊戲文字不支援。 RuneTranslate 只會透過存檔編輯器讀取它們的 .lsd 存檔檔案,除此之外別無其他。如果你手上是 RPG_RT.exe 的遊戲,想翻譯它的劇本,該用的工具是 EasyRPG,不是這一個。與其花上一個小時才搞清楚,不如現在就離開本頁。

四步流程

  1. 把新增專案指向遊戲資料夾。 選含有 Game.exe 的那個資料夾。引擎是從裡面的內容偵測出來的:你不必在下拉選單裡選 MV 還是 MZ,而如果偵測結果和你以為的不同,這件事本身就值得當作資訊來讀。
  2. 選一個翻譯服務和一個目標語言。 有十二種翻譯服務可用,其中五種完全不需要 API 金鑰或帳號。
  3. 翻譯。 執行器會把單元分批、失敗時帶退避重試,並顯示一個附有預估剩餘時間的真實進度列。執行中和跑完之後,你都能編輯表格裡的任何一行。
  4. 把可玩的建置版本匯出到你選的資料夾。落在那裡的是一份完整、可執行的遊戲副本,翻譯好的資料檔已經就位。

原始遊戲資料夾永遠不會被修改。每一次寫入都落進你選的輸出資料夾,這表示一次失敗的匯出只會花掉你一點磁碟空間,刪掉再匯出一次即可。這也表示你可以讓日文建置版本維持原樣、隨時能玩,兩邊並存。

RuneTranslate 在 Windows 10 和 11 上執行,也能在 Linux 和 Steam Deck 上原生執行。第一次啟動需要一次免費登入(Patreon、Google 或電子郵件)。免費方案解鎖了每一種引擎和除了 RuneLingua 以外的每一種翻譯服務,它限制的是處理量和同時只保留一個專案,而不是把功能鎖在付費牆後面。

到底有哪些內容會被翻譯

對 MV 和 MZ,擷取器會走訪每一個地圖檔案和每一份事件指令清單,把會產生玩家可見文字的指令拉出來:

  • `401` Show Text:對話行。在任何一款 RPG Maker 遊戲裡,這都是最大宗。
  • `405` Show Scrolling Text:開場、製作人員名單、書信、捲動的背景交代。
  • `102` Show Choices:選項視窗中的項目。When [choice] 分支標籤由同一個陣列繪製,所以翻譯了選項就等於兩邊都翻譯了。
  • `320` / `324` / `325`:Change Actor Name、Nickname 和 Profile,遊戲用它們來做劇情中途的身分揭曉和形態轉變。
  • 資料庫:Actors.json(名稱、暱稱、簡介)、Classes.json、Skills.json(名稱、說明,以及 message1 / message2 戰鬥提示行)、Items.json、Weapons.json、Armors.json、Enemies.json、States.json。
  • `System.json`:遊戲標題、貨幣單位,以及整張術語表:引擎繪製的每一個選單標籤、指令名稱和基礎狀態字串。
  • `MapInfos.json` 的地圖名稱和 CommonEvents.json:在把對話統一導向某個共用處理器的遊戲裡,共用事件承載的劇本多得出人意料。
  • plugins.js 裡的外掛參數,以及 MZ 的外掛指令參數(指令碼 357)。很多新式的 MV/MZ 遊戲,選單文字就放在這裡。

事件註解(108 及其 408 接續行)是開發者的筆記,引擎不會顯示給玩家,所以預設排除。它們不會被刪掉,而是以可勾選的選擇加入行出現,因為確實有少數對話泡泡和彈出訊息外掛會把它們繪製出來。存在於註解裡的 VisuStella 事件標籤和近距離彈出視窗會被辨識出來,並像對話一樣被翻譯。分類器判定為程式識別字或檔案路徑的內容也是同樣的處理方式:排除,但看得見、可還原。

控制碼,以及它們為何會毀掉譯文

RPG Maker 的對話不是純文字。它帶著引擎在繪製時才展開的行內跳脫碼:

  • \C[1]:把文字顏色切換到調色盤索引 1。
  • \N[2]:代入 2 號角色的名稱。
  • \V[3]:代入 3 號變數的值。
  • \G:貨幣單位。
  • \I[123]:在行內繪製 123 號圖示。
  • \. \| \! \{ \}:停頓一拍、停頓一秒、等待輸入、放大字型、縮小字型。

把這些原封不動丟給機器翻譯,回來的一定會被弄亂。Google Translate 會重新排列它們。小型本機模型會漏掉一個括號、把字母變成小寫,或是把 ASCII 方括號換成全形的。LLM 偶爾會認定 \C[1] 是個錯字,然後熱心地把它刪掉。在遊戲裡的結果就是:文字框印出一個字面的反斜線、顏色到一半就消失,或是本該是角色名稱的地方一片空白。

RuneTranslate 會在翻譯服務看到字串之前,把每一個控制碼遮蔽成帶編號的預留位置,也就是 [[T0]]、[[T1]],之後再依對應表還原。還原刻意設計得很寬容:預留位置回來時少了一邊括號、裡面多了空格、字母變成小寫,或括號變成全形,它都認得,因為實務上這四種情況全都會發生。如果某個控制碼整個不見了,那個單元會被標記出來,而不是悄悄地隨匯出一起送出去。

另外兩種比較不顯眼的情況由同一套機制涵蓋。RPG Maker 還用 printf 風格的替換:Terms 和技能戰鬥提示裡的 %1 和 %2,例如 %1の攻撃! 裡的 %1 會變成角色名稱,這些也會被遮蔽,因為較弱的翻譯服務會在原地編出一堆括號亂碼。此外,很多遊戲帶有名稱替換外掛,使用 [名前] 或 [呼名] 這樣單獨的方括號標記,引擎在執行階段把它換成玩家的名字;這些同樣會被遮蔽,而且範圍收得夠窄,一般帶方括號的內文不會受到影響。

外掛自訂的多字母控制碼,例如 \FFF[20] 或 \FH[ON],符合同一個模式,不需要任何逐一外掛的設定就能受到保護。

46 字元自動換行

日文每個字元所承載的意思,比英文多得多。一行在日文裡剛好舒舒服服填滿訊息框的文字,翻過來就會衝出右邊緣,而 RPG Maker 不會替你換行:它就那樣畫到視窗外面,溢出的部分你根本看不見。直到玩家來告訴你半句話不見了,你才會察覺。

匯出時,401 和 405 指令裡的對話會依每行 46 個字元自動換行,這大致就是預設字型大小下,預設訊息視窗所能容納的量。斷行插在詞語邊界上,原文裡已有的換行會被保留,所以作者自己的分頁和刻意的斷句都能留住。使用自訂訊息系統或較小字型的遊戲,也許需要另一個數字;而在較寬視窗裡繪製文字的遊戲,只會比實際需要更早換行,那是觀感問題,不是壞掉。

已封裝的圖片和封存檔

MV 和 MZ 可以把圖片以封裝格式發行,並改名為 .rpgmvp 或 .png_。RuneTranslate 直接從檔案中讀取這些圖片,包括某些外掛產生的變體,並把它改動過的內容以同樣的格式寫回,讓遊戲照樣載入得了。

對 XP、VX 和 VX Ace,.rgssad / .rgss2a / .rgss3a 封存檔是直接讀取的,裡面的 Ruby Marshal 資料以 Rust 解析:不需要安裝 Ruby,也不需要外部的解包工具。XP 和 VX 遊戲儲存文字時不帶編碼標記(Shift-JIS 或 UTF-8,RuneTranslate 會逐一遊戲偵測),所以編碼上的邊角情況比 MZ 更容易出現。

畫進美術素材裡的文字,例如標題畫面、選單按鈕、CG 裡的一塊招牌,不在任何資料檔裡,任何擷取器都碰不到。那是 Image Studio 的工作:辨識文字區域、清理底板、排上替換的文字,再依遊戲自己的圖片格式烘焙回去,包括封裝格式在內。

以 Enigma Virtual Box 封裝的遊戲

相當一部分流傳的 RPG Maker 遊戲根本看不到 www/ 或 data/ 資料夾,因為整個虛擬檔案系統被 Enigma Virtual Box 封裝進執行檔裡。破綻是 exe 裡的 EVB\0 標記,以及一個空得可疑的遊戲資料夾。

這些是能偵測並處理的。封裝的檔案系統會被解開到每個專案專屬的工作區,資料照常擷取和翻譯,而匯出時整個虛擬檔案系統會被寫成一個可執行的資料夾,包含還原出的內層執行檔、它的 DLL 和 www/,翻譯好的資料已經修補進去。你執行那個取出的內層執行檔,它到那時就是一個讀取散裝資料檔的普通未封裝遊戲。

只能這麼做。早先有一種做法是把翻譯好的 www/ 丟在封裝過的執行檔旁邊,結果它悄悄地什麼也沒做:執行中的外殼是從它自己內嵌的虛擬檔案系統裡解析 www/,對磁碟上的檔案視而不見。如果你用別的工具手動做這件事,那就是陷阱:翻譯看起來套用了,遊戲照樣載入原文。

該選哪個翻譯服務

支援十二種翻譯服務,其中五種不需要任何 API 金鑰,也不需要在任何地方註冊:Google、免費的 DeepL 端點、可選擇 Classic 或 Next-gen 模型的 DeepL、Yandex Translate,以及透過 Chrome 在你自己的 PC 上執行的 Gemini Nano。你完全可以不花一毛錢、不註冊任何東西,就翻完一整款 RPG Maker 遊戲。付費選項是 DeepL API、OpenAI、Anthropic Claude、DeepSeek、任何與 OpenAI 相容的端點,以及,如果你希望什麼都不離開自己的機器,透過 Ollama 或 LM Studio 執行的本機模型。付費方案還包含 RuneLingua,我們自己的翻譯服務,不需要任何設定。

針對 RPG Maker 的簡短結論:免費供應商對選單、道具名稱和短句完全夠用,大多數人也應該從它們開始。它們在擬聲詞上比較吃力:如果某個翻譯服務把原文原樣退回來,那個單元會被標為失敗並附上說明,而不是讓日文悄悄混進你的匯出結果裡。LLM 在長對話、語氣,以及任何說話者語體重要的地方明顯更好。翻譯服務比較列出實際的取捨,AI 精修器則說明如何在翻完之後再跑一輪把它整理乾淨。

讓名稱保持一致

對一款機器翻譯的 RPG Maker 遊戲,最常見的抱怨就是主角有四種不同的叫法。詞彙表能解決這個問題:在開跑之前把每個角色、地名、道具和技能的寫法釘死,之後每一批都會照著用。詞彙表入門說明怎麼建立一份。翻譯記憶在同一個方向上幫忙:整個專案裡相同的原文會得到相同的譯文,這在同一段道具說明會出現在商店、選單和寶箱事件裡的引擎中格外重要。

一個 RPG Maker 特有的陷阱:某些外掛會依說話者的名稱字串做完全相等的比對,MZ 的 TRP Skit 系列就是有名的一例。你把 Actors.json 裡的名稱翻了,卻留著外掛資料裡的,比對就會悄悄失敗,立繪或小劇場永遠不會觸發。RuneTranslate 在匯出時會同步兩邊。如果你是手動編輯,請記住:RPG Maker 裡的一個名稱,可以同時是顯示文字,也是查詢鍵。

出問題的時候

有一行還是日文

通常有三個原因。它根本沒被擷取,因為它位於擷取器不會走訪的地方:某個自訂外掛自己的資料檔,或是烘焙進圖片裡的文字。它被擷取了但被排除了,因為分類器把它判讀成識別字;去選擇加入行裡找到它並勾選。再不然就是翻譯服務把原文原樣退了回來,那會顯示為失敗單元,你可以換一個翻譯服務重跑。如果你是在更新應用程式之前翻譯這款遊戲的,請使用編輯器 ⋯ 選單裡的重新掃描原文:重新掃描只會新增單元,絕不會刪掉你已有的譯文。

文字溢出訊息框

預設的換行是照預設視窗設計的。使用自訂訊息系統、較大字型,或是有立繪吃掉半個框的遊戲,需要更短的行。直接編輯出問題的那個單元、插入你自己的換行,手動斷行會原樣通過匯出。譯文單純太冗長時,這也是解法:把它改寫得更短,而不是去和自動換行較勁。

匯出之後遊戲啟動不了

幾乎總是某個資料檔壞了,而不是文字有問題。確認你啟動的是輸出資料夾裡的執行檔,而不是原本那個。在 EVB 建置版本上,確認你執行的是取出的內層執行檔。如果是某個特定事件當機,嫌疑犯就是一個沒能撐過來的控制碼:打開那個單元,把它的控制碼和原文對一遍。讓原始遊戲資料夾保持不動,你就永遠有一個可用的基準可以對照。

有一條外掛字串絕不能翻譯

外掛參數會把顯示文字和開關名稱、檔案路徑、按鍵綁定、模式旗標混在同一個區塊裡。任何讀起來像程式識別字或路徑的內容都會被自動排除,但一個拿日文詞當內部鍵的外掛會漏過去。把那些單元標為排除,匯出時它們就會維持原文語言。當某個外掛的參數共用某種命名模式時,正規表示式過濾器能成批地做這件事。

誠實的邊界

  • RPG Maker 2000 / 2003 的遊戲文字不在支援範圍內。 只有存檔檔案,透過存檔編輯器。劇本請用 EasyRPG。
  • XP、VX 和 VX Ace 比 MV/MZ 更粗糙。 封存檔讀取器和 Ruby Marshal 解析器是純 Rust 寫的,也確實能用,但 XP 和 VX 的文字不帶編碼標記(Shift-JIS 或 UTF-8,逐遊戲偵測),所以使用帶重音或非拉丁字母的目標語言時,請在遊戲裡檢查。
  • 自訂外掛 JavaScript 裡的文字,在遊戲會顯示它時會被列出來。 遊戲自帶外掛裡的繪製呼叫、標籤和其他畫面上的字串都會成為行;程式碼用來比較或查詢的字串則維持不動,個別特殊的外掛可能仍需手動修改。
  • 以受保護形式發行資料的 MZ 遊戲同樣受支援;在投入一次長時間執行之前,先驗證匯出結果。
  • 沒有任何東西能取代真正去玩一遍建置版本。 擷取數量和一條綠色進度列都不是證據。啟動匯出的遊戲,把開頭十分鐘讀完。

兩件相鄰的、值得知道的事

作弊模式會讀取 RPG Maker 遊戲自己的開關、變數和道具,並讓你隨手修改,這是抵達某個你需要檢查譯文的後期事件最快的辦法,大多數人也是這樣驗證一次匯出,而不必重玩二十個小時。存檔編輯器可以直接開啟 MV/MZ、XP/VX/VX Ace 以及 2000/2003 的 .lsd 存檔,所以一次卡關的流程或一件遺失的關鍵道具,不會讓整個周目就此終結。

如果你想先看看全貌,引擎清單涵蓋了全部十八種支援的格式,RPG Maker 引擎頁面有格式細節,而通用教學則是本指南不限引擎的版本。準備好了就到下載頁面取得安裝程式。

準備好試用 RuneTranslate 了嗎?

免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。

下載 Windows、Mac 和 Linux 版