登入

tyranobuilder · tutorial · engine

如何將 TyranoBuilder / TyranoScript 遊戲翻譯成繁體中文

用 RuneTranslate 翻譯 TyranoBuilder / TyranoScript 視覺小說:擷取 data/scenario/*.ks 腳本、遮蔽 KAG 標記、翻譯角色顯示名稱,並匯出一個可玩的 HTML5 或 Electron 建置版本。

5 分鐘閱讀

TyranoBuilder 和底層的 TyranoScript 引擎支撐著一大批日文獨立視覺小說。它是 Kirikiri 和 Ren'Py 的網頁技術(HTML5 / JavaScript)替代方案,發行形式不是獨立的 HTML5 資料夾,就是以 Electron 封裝的可執行檔。它的劇本使用與 Kirikiri 相同的 KAG 風格 .ks 語法,所以只要知道文字放在哪裡,就很容易處理。本指南帶你從頭到尾用 RuneTranslate 翻譯一個 TyranoBuilder 遊戲,也包含大多數工具漏掉的部分:角色顯示名稱。

你需要準備什麼

  • Windows / Linux 版 RuneTranslate:免費,每一種引擎和除了 RuneLingua 以外的每一個翻譯服務都已解鎖。
  • 一個 TyranoBuilder 遊戲:獨立的 HTML5 資料夾(散裝的 data/ 和 tyrano/ 目錄),或 Electron 建置版本(一個內含 tyrano/tyrano.js 和 data/scenario/*.ks 的 resources/app.asar)。RuneTranslate 兩種都能偵測。
  • 一個目標語言:英文、西班牙文、法文、德文、繁體中文,以及 30 多種其他語言。
  • 一個翻譯服務。視覺小說的對話量很大,所以 LLM(OpenAI / Anthropic)或 DeepL 讀起來最順;免費的 Google Translate 開箱即用。

第 1 步:開啟遊戲資料夾

啟動 RuneTranslate,點擊 新增專案,指向遊戲目錄(Electron 建置版本則指向含有 .exe 的資料夾)。偵測功能會從 tyrano/ 執行階段加上 data/scenario/ 腳本辨識出 TyranoBuilder;Electron 建置版本則直接讀取 app.asar,所以你完全不必拆開任何東西。你的原始遊戲永遠不會被修改。

第 2 步:字串如何被擷取

RuneTranslate 會從 TyranoBuilder 存放文字的每個地方擷取可翻譯的文字:

  • 劇本腳本:每一個 data/scenario/**/*.ks 檔案,包括 _preview.ks,以及部分建置版本所依賴的 system/_*.ks 鏡像檔。
  • UI 與設定:tyrano/lang.js 和 data/system/Config.tjs。
  • 角色顯示名稱:對話上方顯示的說話者標籤(見下一節)。

KAG 行內標記,例如 [r] 換行、[p] 等待點擊、[改ページ] 換頁、[font color=...],以及以日文命名的標記,會在送到翻譯服務之前,先以數字 [[U#]] 預留位置遮蔽起來,匯出時再還原,所以格式會原封不動地保留。二進位的 .ks 檔案會透過一次 UTF-8 探測被偵測出來,而且絕不會被覆寫。

第 3 步:角色名稱,Tyrano 特有的部分

劇本常用行內簡寫來稱呼說話者,例如 [yuki],這是角色 ID,不是顯示文字。RuneTranslate 絕不會改寫這些引用(那會破壞引擎的角色查詢,讓場景當機)。它改為翻譯顯示名稱,並在匯出時把正規的 [chara_new name=... jname=...] 項目注入 data/system/chara_define.ks。螢幕上顯示的名稱會被翻譯,腳本使用的 ID 則維持不變。

第 4 步:翻譯並審校

選一個翻譯服務並執行。LLM(OpenAI / Anthropic)對角色語氣的呈現最好;DeepL 處理旁白又快又乾淨;免費的 Google Translate 負責選單。先替你的角色陣容和反覆出現的術語建立詞彙表,讓名稱在每條路線上都翻得一模一樣,請參見詞彙表入門。每一行都會出現在編輯器中,緊鄰它的原文;你可以直接就地編輯(離開欄位或按 Ctrl+Enter 時儲存)、使用尋找取代,或執行選用的 AI 精修器,做一輪考慮上下文的二次處理。免費方案在速度上會適度減慢,AI 服務上大約是付費方案處理量的一半,輸出品質完全相同。

第 5 步:匯出可玩的版本

點擊 匯出。對於獨立的 HTML5 遊戲,RuneTranslate 會把翻譯好的 .ks 腳本、lang.js、設定檔和注入的 chara_define.ks 寫進遊戲的一份副本。對於 Electron 建置版本,則會重新封裝一個修改過的 app.asar。不論哪種方式,你都會在自己選擇的位置得到一份完整、可執行的副本:啟動它,就能用你的目標語言遊玩。

已知限制

  • 二進位 .ks 檔案(被偵測為非 UTF-8)會維持原樣,所以這類建置版本裡的劇本不會被翻譯。
  • 散裝 HTML5 建置版本中的圖片文字(標誌、手繪 UI、CG 說明)可以在 Image Studio 裡翻譯;封裝在 app.asar 或 .exe 內部的圖片,目前還不會被列出來。
  • 在執行階段組出對話的自訂外掛,可能需要在編輯器裡快速手動修正。

為什麼這比舊方法更輕鬆

手動做法代表要拆開 app.asar、找出每一個 .ks 檔案(包括容易漏掉的系統鏡像檔)、手動避開 KAG 標記來翻譯、搞懂角色名稱如何注入,然後在不弄壞 asar 的情況下重新封裝。RuneTranslate 把整條流程縮成幾次點擊,同時保持編輯器開啟,讓你掌控措辭。

查看 TyranoBuilder 引擎頁面瞭解完整功能清單,閱讀 Kirikiri 指南瞭解相關的 KAG 引擎,或下載 RuneTranslate在真實遊戲上試試看。

準備好試用 RuneTranslate 了嗎?

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

下載 Windows、Mac 和 Linux 版