登入

支援的引擎 · RPG Maker XP / VX / VX Ace

完整支援,已重新封裝並實機執行

RPG Maker XP、VX 與 VX Ace 漢化翻譯器 - Ruby / RGSS 世代

RPG Maker XP、VX 和 VX Ace 是 RPG Maker 的 Ruby 世代(RGSS1、RGSS2 和 RGSS3),它們儲存遊戲資料的格式,和以 JavaScript 為基礎的 MV 與 MZ 完全不同。這裡沒有可讀的 JSON,一切都放在 Data/ 底下的 Ruby Marshal 二進位檔裡:XP 是 Map001.rxdata,VX 是 .rvdata,VX Ace 是 .rvdata2,資料庫檔案和 System 也在其中。已發行的遊戲通常會把這些檔案裝進 RGSSAD 封存檔,也就是 Game.rgssad(XP)、Game.rgss2a(VX)或 Game.rgss3a(VX Ace),就放在執行檔旁邊。RuneTranslate 以純 Rust 自己處理這兩層。它直接讀取封存檔,不需要安裝 Ruby,不需要 RPG Maker 編輯器,也不需要另外的解包工具;裡面的 Marshal 4.8 資料由自行開發的讀寫器解析,它只改寫字串葉節點,浮點數、表格以及其他每一種物件本體,都按位元組原樣重新寫出,所以遊戲載入的檔案,在結構上就是出廠時的那一個。在此之上,它會擷取地圖事件對話(XP 包在事件碼 101 裡,VX 和 VX Ace 在 401 和 405 裡)、Show Choices 選項表、事件名稱和地圖名稱、資料庫(角色、道具、技能、武器、防具、敵人和狀態的名稱、稱號、說明與備註),以及 System 詞彙和屬性名稱。像 \C[1]、\N[2]、\V[3] 這樣的控制碼,在文字送到翻譯服務之前會被遮蔽,對話則在匯出時自動換行,讓它放得進訊息視窗。有一點要直說:VX Ace 跑的是 Ruby 1.9,每個字串都帶編碼標籤,所以從頭到尾都是 Unicode。XP 和 VX 跑的是 Ruby 1.8,存放的文字不帶編碼標籤,所以 RuneTranslate 會依每個遊戲判斷它是 Shift-JIS 還是 UTF-8。存成 UTF-8 的遊戲會保留譯文的每一個字母;在 Shift-JIS 遊戲上,該編碼容納不了的字母(重音符號、泰文、阿拉伯文之類)會被簡化或遺失,所以那裡以英文和羅馬拼音為目標最穩妥。較新的 MV 和 MZ 世代,請見 RPG Maker MV / MZ 頁面。

此引擎的詞彙表提示

Ruby 世代的 RPG Maker 遊戲都很長,同樣的名詞到處重複:寫在某個事件裡的技能名稱,會再次出現在資料庫、戰鬥紀錄和商店選單裡。把隊伍成員名稱、城鎮名稱、關鍵道具和招牌技能加進詞彙表一次,每一個翻譯服務就會在整個 Data/ 裡把它們呈現得完全一致。這在 XP 和 VX 上比在 VX Ace 上更要緊,因為它們的 Shift-JIS 文字,讓你更難注意到某個名字在 40 小時的遊戲中途悄悄變了樣。

詞彙表入門

如何翻譯 RPG Maker XP / VX / VX Ace

  1. 步驟 1

    先弄清楚你手上是哪一代

    開啟遊戲資料夾,看一眼 Data/。以 .rxdata 結尾的檔案代表 RPG Maker XP,.rvdata 代表 VX,.rvdata2 代表 VX Ace。如果沒有 Data/,就到執行檔旁邊找 Game.rgssad(XP)、Game.rgss2a(VX)或 Game.rgss3a(VX Ace),資料就在那個封存檔裡。如果你看到的是 www/data/*.json 或 data/*.json,那你手上的是 MV 或 MZ;這種情況請看 RPG Maker MV / MZ 頁面。

  2. 步驟 2

    在遊戲資料夾上新增專案

    啟動 RuneTranslate,點擊 New project,把它指向含有遊戲執行檔的資料夾。引擎偵測是自動的,並會回報它找到的是這三個版本中的哪一個,以及資料是散裝的還是封裝在封存檔裡。RGSSAD 封存檔會被直接讀取,其中的 Data 檔案解開到每個專案各自的工作區裡,全程不涉及 Ruby 執行環境,也不涉及外部解包工具。

  3. 步驟 3

    選擇目標語言和翻譯服務

    選好目標語言,再選一個翻譯服務:Google 和免費的 DeepL 選項完全不需要 API 金鑰,DeepL API 提供均衡的品質,而 OpenAI、Anthropic Claude、DeepSeek、任何相容 OpenAI 的端點,或透過 Ollama 或 LM Studio 執行的本機模型,則能結合上下文處理長對話。來源語言預設為日文;任何支援的來源語言都能依專案設定。

  4. 步驟 4

    在編輯器裡翻譯並審校

    RuneTranslate 會把字串分批送給翻譯服務,再把結果寫回專案。地圖對話、選項、資料庫項目和 System 術語都已分組,你可以一次審校一張地圖或一張資料庫表,手動編輯任何一行,並重試失敗的批次。控制碼全程被遮蔽,所以 \C[1]、\N[2] 和 \V[3] 來回一趟之後仍會完好無損。

  5. 步驟 5

    匯出可直接遊玩的翻譯副本

    匯出會寫出一份完整可執行的遊戲副本,翻譯好的 Marshal 資料已經就位。對於封裝成封存檔的遊戲,封存檔會被解開成 Data/ 裡的散裝檔案,封存檔本身則被丟棄,這正是 RGSS 在沒有封存檔時載入遊戲的方式。對話在寫出時自動換行。結果是一份歸你保留、可直接遊玩的翻譯副本,原件毫髮無傷。

支援內容

  • RPG Maker XP(Data/*.rxdata)、VX(.rvdata)和 VX Ace(.rvdata2)
  • RGSSAD 封存檔(.rgssad、.rgss2a 和 .rgss3a)以純 Rust 直接讀取,不需要安裝 Ruby,也不需要另外的解包工具
  • 自行開發的 Ruby Marshal 4.8 讀寫器:只有字串葉節點會改變,其他每一種物件本體都原樣重新寫出
  • 地圖事件對話(XP 上的事件碼 101;VX 和 VX Ace 上的 401 和 405)以及 Show Choices 選項表(碼 102)
  • 資料庫文字:角色、道具、技能、武器、防具、敵人和狀態的名稱、稱號、說明與備註,以及狀態訊息
  • 共通事件、敵群戰鬥事件文字、事件名稱,以及來自 MapInfos 的地圖名稱
  • System 術語與詞彙(VX 和 VX Ace 上的 @terms,XP 上的 @words)和屬性名稱
  • 控制碼 \C[n]、\N[n]、\V[n] 在翻譯期間被遮蔽;對話在匯出時自動換行

限制

  • XP 和 VX 存放的文字不帶編碼標籤(Ruby 1.8),所以 RuneTranslate 會依每個遊戲偵測它是 Shift-JIS 還是 UTF-8。在 Shift-JIS 遊戲上,該編碼容納不了的字母(重音符號、泰文、阿拉伯文之類)會被簡化或遺失,所以那裡以英文和羅馬拼音為目標最穩妥。VX Ace 從頭到尾都是 Unicode。
  • Ruby 腳本(Scripts.rxdata / .rvdata / .rvdata2)不擷取:寫死在遊戲自己腳本裡的 UI 文字會維持來源語言。地圖事件、資料庫和 System 術語都已涵蓋。
  • RGSSAD 封存檔只解開、不重建:匯出的是移除了封存檔的完整散裝可執行副本,而不是重新封裝的封存檔。
  • 遊戲內作弊選單是 MV 和 MZ 的功能,不適用於 XP、VX 或 VX Ace。存檔編輯器可以開啟它們的 .rxdata / .rvdata / .rvdata2 存檔(金幣、變數和開關)。
  • MV 和 MZ 使用完全不同的格式(www/data 或 data 底下的 JSON),請見 RPG Maker MV / MZ 頁面。

延伸閱讀

延伸閱讀

文件

其他支援的引擎