tyranobuilder · tutorial · engine
如何將 TyranoBuilder / TyranoScript 遊戲翻譯成繁體中文
用 RuneTranslate 翻譯 TyranoBuilder / TyranoScript 視覺小說:擷取 data/scenario/*.ks 腳本、遮蔽 KAG 標記、翻譯角色顯示名稱,並匯出一個可玩的 HTML5 或 Electron 建置版本。
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 版
