支援的引擎 · YU-RIS
YU-RIS 引擎翻譯工具 - 從頭到尾翻譯 raiL-soft 日文視覺小說
YU-RIS(由 raiL-soft 開發)是歷史悠久的 Windows 腳本引擎,背後有數百部獨立與商業日文視覺小說。它的資源存放在 .ypf 封包封存檔裡,劇情則編譯成 YSTB 腳本(ysbin.ypf 內的 .ybn 檔,內部路徑如 ysbin/yst00000.ybn)。RuneTranslate 以純 Rust 讀取 .ypf 封包(不需要外部工具),解壓縮項目,再解析編譯後的 YSTB 腳本:它會拆解四個區段(指令、參數描述子、字串值、行號),並自動解碼,不需要任何設定。接著它從字串表擷取日文對話,在編輯器中列出每一行,同時預設排除引擎的指令運算元、變數名稱和資源路徑,所以你絕不會翻到腳本邏輯用來比較的內容。匯出時它會重建字串表(修補每一個位移量,讓較長或較短的翻譯都放得下),以同樣的方式重新編碼,並把翻譯後的 .ybn 以散裝形式寫在它原本的封存檔路徑上。由於 YU-RIS 執行階段會優先讀取磁碟上的散裝檔案,而不是 .ypf 內相同路徑的檔案,遊戲就會直接載入你的翻譯,不需要重新封裝。它已在一款真實遊戲中於遊戲內確認,但 YU-RIS 會因發行版而異,所以在依賴它之前,請先測試匯出的版本。
視覺小說在數千行文字中,依賴固定的角色陣容和反覆出現的術語,而機器翻譯可能在三個章節裡把女主角的名字拼成三種不同的寫法。請預先把你的角色、地名和反覆出現的術語加進詞彙表,這樣每一行對話都會用同樣的方式呈現它們。
如何翻譯 YU-RIS
- 步驟 1
開啟 YU-RIS 遊戲資料夾
把 RuneTranslate 指向遊戲目錄,也就是含有遊戲 yu-ris.exe 及其 .ypf 封包(通常在 pac/ 子資料夾裡,腳本在 ysbin.ypf 中)的資料夾。如果遊戲的腳本已經解包,含有 .ybn 腳本的散裝 ysbin/ 資料夾也會被偵測到。引擎偵測會自動辨認 YU-RIS 的配置;你的原始資料夾絕不會被修改。
- 步驟 2
讀取 .ypf 封包並解碼 YSTB 腳本
RuneTranslate 以純 Rust 開啟 .ypf 封包,解壓縮項目,並解析裡面編譯後的 YSTB 腳本。它不需要任何設定就會自動解碼每個腳本,讀取 Shift-JIS 字串表,並在編輯器中依腳本檔分組,列出每一行日文。引擎指令運算元、變數名稱和資源路徑會顯示出來,但預設排除,所以劇情邏輯會保持完整。
- 步驟 3
用你偏好的供應商翻譯
這類遊戲對話密集又對語氣敏感,所以 LLM(OpenAI GPT-4o / Anthropic Claude)或 DeepL 通常讀起來最順;免費的 Google Translate 或本機模型(Ollama / LM Studio)可涵蓋簡短的選單字串和選項,你也可以把相容 OpenAI 的供應商指向 OpenRouter 或 NanoGPT。選用的 AI 精修第二輪處理,可以修掉生硬的措辭。
- 步驟 4
保持內嵌控制碼完好無損
YU-RIS 的訊息文字會把反斜線控制碼(換行、顏色、ruby)和方括號標籤穿插在對話中。RuneTranslate 在翻譯過程中會把它們全部凍結成數字預留位置,並在輸出時還原,所以翻譯後的行會保有與原文相同的格式和節奏。
- 步驟 5
以散裝檔案覆蓋匯出(不需要重新封裝)
匯出時,RuneTranslate 會複製遊戲,並重建每個翻譯後的 YSTB 腳本(修補字串表位移量,讓任何長度的翻譯都放得下,並以同樣的方式重新編碼),然後把它以散裝形式寫在原本的封存檔路徑上(例如 ysbin/yst00000.ybn)。YU-RIS 執行階段會優先讀取散裝檔案,而不是 .ypf 內相同路徑的檔案,所以遊戲只會讀取你的翻譯,不需要重新封裝。執行匯出的副本,就會以你的語言執行。
支援內容
- 純 Rust 的 .ypf 封包讀取器(含解壓縮),不需要外部工具或附屬程式
- 以純 Rust 解析編譯後的 YSTB .ybn 劇情腳本(指令 / 描述子 / 字串表 / 行號)
- 編譯後的 YSTB 腳本自動解碼,不需要任何設定
- 從字串表擷取日文對話;指令運算元 / 變數名稱 / 資源路徑預設排除
- 重建字串表並完整修補位移量,讓較長或較短的翻譯都放得下
- 散裝檔案覆蓋匯出:翻譯後的 .ybn 放在它的封存檔路徑上,不需要重新封裝
- 透過 DeepL、Google、OpenAI、Anthropic、相容 OpenAI 的服務或本機模型,翻譯成 30 多種語言
限制
- 已在一款真實遊戲中於遊戲內確認,但各發行版不盡相同,所以在依賴它之前,請先測試匯出的副本
- YU-RIS 字串為 Shift-JIS(cp932):英文和其他可用 cp932 表示的目標可以使用;非 cp932 的文字(例如擴充西里爾文、韓文、繁體中文)需要尚未自動化的遊戲字型 / 編碼變通方案
- 烘焙進圖片(標題畫面、選單、按鈕)的文字不屬於腳本;圖片文字 OCR 流程只能處理遊戲以散裝檔案存放的圖片,無法處理封裝在 .ypf 裡的圖片
- 透過 YSCM 指令表逐指令標記訊息,是規劃中的改進;目前腳本中的每一筆日文字串都會提供,非顯示用的字串則以啟發式方式排除

