支援的引擎 · TyranoBuilder / TyranoScript
TyranoBuilder 翻譯工具 - 翻譯 TyranoBuilder 和 TyranoScript 視覺小說
TyranoBuilder(以及它底層的 TyranoScript)是日系視覺小說引擎,在 itch.io 和 Steam 的獨立作品中很受歡迎。RuneTranslate 會偵測 Electron 封裝版(resources/app.asar 內含 tyrano/tyrano.js + data/scenario/*.ks,或結構相同的已解包目錄)、HTML5 獨立版(根目錄下的散裝檔案),以及封裝進遊戲 .exe 的 NW.js 版本。它會翻譯每一個 .ks 腳本檔(包括部分版本使用的 _preview.ks 和 system/_*.ks 鏡像)、用於 UI 字串的 tyrano/lang.js、用於設定字串的 data/system/Config.tjs,還會把角色顯示名稱注入 chara_define.ks 區塊,內嵌的 [<JP-id>] 說話者簡寫會自動變成標準的 [chara_new name=... jname=...] 項目。搭配 Supporter 方案的詞彙表功能,可以在第一批翻譯開始前,就把角色名單裡每個角色的名稱鎖定成指定的寫法。來源語言預設為日文,但可依專案設定,中文、韓文、英文等都行,所以非日文的 Tyrano 作品也能用同樣的方式擷取。
TyranoBuilder 的角色名稱注入已經替你整理出一份乾淨的說話者清單,但腳本裡的其他一切(地名、組織名稱、招牌忍術 / 法術名稱)預設仍會前後不一。請把它們加進詞彙表。內嵌的 KAG 標籤([r]、[p]、[font color=...])會被標籤遮罩,所以詞彙表替換絕不會不小心破壞內嵌指令,而這正是手動編輯 tyrano 翻譯時常見的失敗原因。
如何翻譯 TyranoBuilder / TyranoScript
- 步驟 1
開啟 TyranoBuilder 遊戲資料夾
把 RuneTranslate 指向遊戲根目錄。引擎偵測能處理每一種常見的配置:Electron 封裝版(resources/app.asar 內含 tyrano/,或結構相同的已解包目錄)、HTML5 獨立版(根目錄下的 data/scenario/),以及封裝進遊戲 .exe 的 NW.js 版本。遇到已封裝的版本,RuneTranslate 會自行讀取並重新封裝該封存檔,不需要任何外部工具。
- 步驟 2
擷取腳本、UI 字串和角色名稱
RuneTranslate 會掃描 data/scenario/**/*.ks(包括部分版本使用的 _preview.ks 和 system/_*.ks 鏡像)、引擎 UI 用的 tyrano/lang.js,以及設定層級字串用的 data/system/Config.tjs。內嵌的 KAG 標籤([r]、[p]、[改ページ]、[font color])和以日文命名的標籤,會透過支援 Unicode 的正規表示式加以遮罩,讓 LLM 無法弄壞它們。
- 步驟 3
注入角色顯示名稱
當腳本使用內嵌的 [<JP-id>] 說話者簡寫,卻沒有對應的 chara_define.ks 項目時,RuneTranslate 會產生一個含有 [chara_new name="<EN>" jname="<JP>"] 項目的 chara_define.ks 區塊,保留引擎的角色查詢。內嵌的引用維持不動,所以存檔和 CG 圖庫仍能對得上。
- 步驟 4
匯出翻譯好的版本
對 HTML5 版本,RuneTranslate 會就地寫入修改後的 .ks 檔。對 Electron 版本,則重新封裝修改後的 app.asar。二進位的 .ks 檔(透過 UTF-8 偵測判斷)絕不會被覆寫。翻譯好的版本執行起來和原版完全一樣。
支援內容
- TyranoBuilder Electron 封裝版(resources/app.asar)
- TyranoBuilder HTML5 獨立版
- TyranoScript 專案(根目錄下的散裝 data/scenario/)
- 所有 .ks 腳本,包括 _preview.ks 和 system/_*.ks 鏡像
- tyrano/lang.js UI 字串
- data/system/Config.tjs 設定字串
- 把角色顯示名稱注入 chara_define.ks
- KAG 內嵌標籤([r]、[p]、[改ページ]、[font])完整保留
限制
- 二進位的 .ks 檔(非 UTF-8)會被偵測出來並跳過,不予翻譯
- 使用非標準字串格式的自訂外掛,可能需要手動修正

