yu-ris · engine
如何將 YU-RIS 視覺小說翻譯成繁體中文
RuneTranslate 把 YU-RIS(raiL-soft)視覺小說翻譯成繁體中文和 30 多種語言:用純 Rust 讀取 .ypf 套件和編譯過的 YSTB 腳本,並把譯好的腳本以散裝檔案匯出。已在遊戲裡確認。
RuneTranslate 能讀取又一個長期讓粉絲譯者碰壁的引擎:YU-RIS,由 raiL-soft 打造的 Windows 腳本引擎,支撐著數百款獨立及商業日文視覺小說。如果你曾開啟過 YU-RIS 的遊戲資料夾,發現一個塞滿 .ypf 封存檔的 pac/ 目錄,和一個裡面沒有任何可讀內容的 ysbin.ypf,然後就放棄了,那就是這個引擎。RuneTranslate 會偵測它、用純 Rust 開啟那些封裝檔、從已編譯的腳本中讀出對話,並匯出遊戲自己就能載入的已翻譯副本。
YU-RIS 支援已在一款真實作品上於遊戲裡確認過,但各個版本並不相同。所以如果你把 RuneTranslate 指向一款 YU-RIS 遊戲,而它偵測不到、打不開,或匯出了遊戲無法載入的東西,請告訴我們(文末有更多說明)。
YU-RIS 引擎究竟是什麼
YU-RIS(有時寫作 ゆーりす)是由 raiL-soft 打造的日文視覺小說腳本引擎。一款成品遊戲是一個 Windows .exe 加上一組 .ypf 封裝封存檔(通常放在 pac/ 資料夾裡),承載美術、音訊和腳本。劇本被編譯成一種叫 YSTB 的二進位格式,以 .ybn 檔案的形式存放在 ysbin.ypf 內部(內部路徑類似 ysbin/yst00000.ybn)。正是「封裝封存檔裡的已編譯劇本」這種組合,讓這個引擎龐大的舊作庫一直無法被一般機器翻譯工具觸及。
YU-RIS 遊戲為何一直這麼難翻譯
和 Ren'Py 這類以原始碼為基礎的引擎相比,YU-RIS 把文字藏在好幾層之後:
- 一切都在 `.ypf` 封裝檔裡。 腳本不是散放的,而是被打進 YU-RIS 自己的壓縮容器裡。沒有該格式的讀取器,就沒有東西可以編輯。
- 劇本是編譯過的,不是文字。 一個
.ybn是一個二進位YSTB容器,分為四個區段(指令流、參數描述表、字串表、行號)。日文住在字串表裡,由描述項引用。 - 並非每個字串都是對話。 字串表裡還有變數名稱、資源路徑,以及腳本用來比較的運算式運算元,翻譯了其中一個,流程就會在不知不覺中壞掉。
最終結果是:即使是流利的讀者,也必須先拆開一個專有的封存檔、解析一個已編譯的二進位檔,再把對話從引擎內部字串中區分出來,然後才有一行被翻譯。這正是 RuneTranslate 替你做的工作。
RuneTranslate 現在能做什麼
RuneTranslate 用純 Rust 處理整條流程,沒有外部工具、沒有 Python 附屬程式、不需要安裝任何東西:
- 直接讀取 `.ypf` 封裝檔。 它自行開啟封存檔、解壓縮條目,並讀取檔案名稱,不需要再安裝任何別的東西。已經自己拆好了遊戲?散放
.ybn腳本的ysbin/資料夾也會被偵測到。 - 解析已編譯的 `YSTB` 腳本。 它會自動解碼每個腳本、讀取 Shift-JIS 字串表,並依腳本檔分組,列出每一行日文。
- 能區分對話與機器邏輯。 變數名稱、資源路徑和運算式運算元會被列出來,但預設排除,標成紅色的選擇加入行,所以你絕不會翻譯到故事邏輯用來比較的字串。
- 保留行內控制碼。 反斜線碼(換行、顏色、注音)和方括號標記,會在翻譯服務看到之前被遮蔽成數字預留位置,再精確還原。
- 匯出時不重新封裝。 它會重建每個翻譯後的腳本(修補字串表偏移量,讓較長或較短的譯文都放得下,並以同樣的方式重新編碼),然後把
.ybn散放在它原本的封存檔路徑上。YU-RIS 會優先使用散放檔案而非封裝內的副本,於是遊戲直接讀取你的譯文。這和我們的 Kirikiri 與 Artemis 流程是同一種散放檔案覆蓋。
日文譯英文是最佳情境,但你可以選擇 30 多種語言作為目標。
你需要準備什麼
- Windows / Linux 版 RuneTranslate:免費;每一種引擎和除了 RuneLingua 以外的每一個翻譯服務都已解鎖(免費方案是速度受限,而不是功能受限)。
- 一個 YU-RIS 遊戲資料夾:含有遊戲
yu-ris.exe及其.ypf封裝檔的目錄(通常在pac/裡,腳本在ysbin.ypf中)。 - 一個目標語言:英文、西班牙文、法文、德文、繁體中文,以及 30 多種其他語言。
- 一個翻譯服務。免費的 Google Translate 開箱即用;DeepL 有免費方案;OpenAI、Anthropic、本機模型,以及任何相容 OpenAI 的 API 都需要自備金鑰。YU-RIS 遊戲對話量很大,所以 LLM 或 DeepL 讀起來最好。
步驟 1:開啟遊戲資料夾
啟動 RuneTranslate,點擊新增專案,把它指向 YU-RIS 的遊戲目錄。偵測會自動執行,當它看到 .ypf 封裝檔(或散放 .ybn 腳本的 ysbin/ 資料夾)時,就把專案辨識為 YU-RIS。你的原始遊戲資料夾永遠不會被修改。
步驟 2:腳本是如何被讀取的
RuneTranslate 會開啟 .ypf 封裝檔,從 ysbin.ypf 裡取出已編譯的 YSTB 腳本,自動解碼每個腳本,並讀取 Shift-JIS 字串表,在編輯器裡依檔案分組,列出每一行日文。引擎的內部字串(變數名稱、資源路徑、運算式運算元)會顯示但預設排除,而行內控制碼會被遮蔽成數字預留位置,讓翻譯服務永遠不會弄亂它們。
步驟 3:翻譯
選一個翻譯服務並執行。LLM(OpenAI / Anthropic)最適合角色語氣和語調,DeepL 處理旁白又快又乾淨,而免費的 Google Translate 對短選單字串和選項已經夠用。事先替你的角色陣容建好詞彙表,讓名字翻得一模一樣,詳見詞彙表 101。完成後,可以用 AI 精修器再多做一輪,它會在上下文中重讀每一行,修掉機器翻譯常留下的生硬、直譯的措辭。
步驟 4:匯出隨時可執行的副本
點擊匯出。RuneTranslate 會寫出一份遊戲的已翻譯副本,把每個重建的 .ybn 散放在它原本的封存檔路徑上,與未改動的 .ypf 封裝檔並排。不重新封裝:YU-RIS 會優先載入散放的腳本而非封裝內的原件,於是遊戲直接讀取你的譯文。執行它,就能用你的目標語言遊玩。
已知的限制
- YU-RIS 的字串是 Shift-JIS(cp932)。 英文和其他能以 cp932 表示的目標語言可以乾淨地匯出。cp932 以外的目標語言(擴充西里爾文、韓文、繁體中文)需要一個尚未自動化的遊戲字型/編碼技巧。
- 散放檔案覆蓋是預期的載入路徑,在大多數 YU-RIS 遊戲上都能用,因為引擎偏好散放腳本而非封裝內的副本。在少數不遵守這一點的作品上,匯出可能需要調整;如果你遇到了,請告訴我們。
- 烘焙進圖片美術裡的文字(一個以點陣圖繪製的標題畫面或選單按鈕)是像素,不是腳本文字。只有當遊戲把那些圖片以散放檔案存放,而不是放在
.ypf裡時,圖片文字翻譯才處理得到。 - 確切的封存檔和腳本變體在不同版本之間可能不同。請務必在你手上的那份副本上驗證。
告訴我們哪裡壞了
YU-RIS 支援已在一款真實作品上於遊戲裡確認過,.ypf 讀取器、YSTB 解析器和腳本解碼器都經過單元測試,但這個引擎有多年累積、每個工作室各異、我們並未全部見過的變體。所以如果你把 RuneTranslate 指向一款 YU-RIS 遊戲,而它偵測不到、打不開封存檔、什麼也擷取不出,或匯出了遊戲無法載入的東西,請到我們的 Discord 回報。遊戲名稱和它的封裝方式能幫我們最快地加強支援。
下載 RuneTranslate,把它指向你一直想讀的那款 YU-RIS VN,試試看。想看另一個以封存檔為基礎的 VN 引擎,請接著讀 Artemis 教學。
準備好試用 RuneTranslate 了嗎?
免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。
下載 Windows、Mac 和 Linux 版
