artemis · engine
如何將 Artemis 引擎視覺小說翻譯成繁體中文
RuneTranslate 把 Artemis 引擎(iMel/Mikage)視覺小說翻譯成繁體中文和 30 多種語言:讀取 .pfs 封存檔(PF8、PF6、PF2)、擷取對話和選項,並匯出遊戲載入的 root.pfs 覆蓋補丁。已在遊戲裡確認。
為了翻譯 Artemis 引擎遊戲,RuneTranslate 讀取了一個長期以來讓粉絲譯者幾乎無從下手的框架:Artemis 引擎,一個以 Lua 為基礎的視覺小說框架,支撐著數百款日文作品。開啟一個 Artemis 遊戲資料夾,你會發現一堆 .pfs 封存檔,裡面沒有任何可讀的內容。RuneTranslate 會偵測這個引擎、用純 Rust 開啟那些封存檔、從它的腳本中讀出對話、角色名稱和選項,並匯出遊戲自己就能載入的已翻譯副本。
Artemis 有多年累積、每個工作室各異的變體,所以如果你把 RuneTranslate 指向一款 Artemis 遊戲,而它偵測不到、打不開,或匯出了遊戲無法載入的東西,請告訴我們,文末有具體做法。
Artemis 引擎究竟是什麼
Artemis 是由 iMel Inc.(也以 Mikage 之名為人所知的工作室)開發的商業日文視覺小說引擎。像 Kirikiri 或 NScripter 這類較老的引擎,提供的是一套自訂的特定領域腳本語言,而 Artemis 則是圍繞 Lua 建構,它的劇本腳本本質上就是 Lua 資料表,這讓開發者用起來很靈活,但對任何想從外部翻譯成品遊戲的人來說,實際上是一堵牆。VNDB 上約有 730 款作品建立在它之上,所以它絕非小眾玩物,而是一整個機器翻譯工具歷來略過的舊作庫。
在磁碟上,一款 Artemis 遊戲是一個 Windows .exe 加上一個或多個 .pfs 資源封存檔,承載腳本、美術和音訊。裡面的腳本大多是 .ast 檔案(Lua 表劇本腳本)和 .txt 檔案(一種較簡單、以行為單位的格式)。RuneTranslate 直接從那些封存檔和腳本著手,所以不論工作室是以 .ast 還是 .txt 發行劇本,它都涵蓋得到這款遊戲。
Artemis 遊戲為何一直這麼難翻譯
和 Ren'Py 這類以原始碼為基礎的引擎相比,Artemis 把文字藏在好幾層之後。有幾個具體的層次,讓它對手工譯者和天真的工具都無從下手:
- 一切都在 `.pfs` 封存檔裡。 腳本不是散放在磁碟上的,而是被打進 Artemis 自己的
.pfs容器格式裡(你會看到PF8、PF6以及舊式的PF2變體)。沒有該格式的讀取器,一開始就沒有東西可以編輯。 - 腳本是 Lua 資料,不是純文字。 一個
.ast劇本是一個 Lua 表,對話、說話者名稱和選項是結構化表裡的巢狀欄位,與引擎指令混在一起。實務上有兩種表格版面(較舊的 v1 和較新的 v2),譯者必須兩種都懂,才能在不弄亂周圍結構的情況下,把真正的台詞挑出來。 - 行內的引擎指令穿插在對話之間。 注音/振假名標註、名牌、顏色變化和點擊等待,都直接寫在文字裡。不認得它們的尋找取代,會把指令標記也一起翻掉,遊戲就壞了。
最終結果是:即使是能流利閱讀日文的譯者,也必須先拆開一個專有的容器,再手工解析 Lua 表,再小心繞過行內標記,然後才有一行被翻譯。這正是 RuneTranslate 現在替你做的工作。
RuneTranslate 現在能做什麼
RuneTranslate 把 Artemis 當作一等公民的引擎,用純 Rust 處理整條流程,沒有外部工具、沒有 Python 附屬程式、不需要安裝任何東西:
- 直接讀取 `.pfs` 封存檔。 它自行開啟
PF8、PF6和舊式的PF2封存格式,讓腳本內容以可讀的形式出來。 - 擷取對話、名稱和選項。 它解析可讀的
.ast(Lua 表)劇本腳本(較舊的 v1 和較新的 v2 版面)和.txt(以行為單位)腳本,以及許多遊戲實際發行的已編譯二進位 `ASB` 劇本(依簽章偵測,即使被改名成像.iet這樣的自訂副檔名),並在編輯器裡列出每一行可翻譯的內容:說出口的對話、名牌上的角色名稱,以及分支選項。 - 保留引擎指令。 行內標記(注音/振假名、名牌、顏色、點擊等待)和換行,在任何東西送到翻譯服務之前,都會被遮蔽成數字預留位置,送回來時再精確還原。文字會被翻譯;引擎指令不會。
- 匯出一個覆蓋補丁。 Artemis 從掛載的
.pfs封存檔中讀取腳本,所以匯出時 RuneTranslate 會在遊戲的副本裡寫出翻譯後的覆蓋補丁封存檔,也就是每個來源.pfs對應一個root.pfs.NNN檔案。Artemis 最後掛載編號最高的封存檔並從中讀取,於是補丁會遮住封裝內的原件,而不必重建遊戲自己的封存檔。(翻譯後的腳本也會散放寫出,作為無害的額外檔案。)這與我們的 Kirikiri 補丁流程是同一個覆蓋補丁的思路。
日文譯英文是最佳情境,但你可以選擇 30 多種語言中的任何一種作為目標,包括西班牙文、法文、德文、葡萄牙文、俄文、繁體中文、義大利文、土耳其文、越南文等等。
你需要準備什麼
- Windows / Linux 版 RuneTranslate:免費;每一種引擎和除了 RuneLingua 以外的每一個翻譯服務都已解鎖(免費方案是速度受限,而不是功能受限)。
- 一個 Artemis 遊戲資料夾。也就是包含遊戲
.exe及其.pfs封存檔的目錄(腳本和資源都封裝在那些檔案裡)。 - 一個目標語言:英文、西班牙文、法文、德文、葡萄牙文、俄文、繁體中文、義大利文、土耳其文、越南文,以及 20 多種其他語言。
- 一個翻譯服務。免費的 Google Translate 開箱即用;DeepL 有免費方案;OpenAI、Anthropic、本機模型(Ollama / LM Studio),以及任何相容 OpenAI 的 API 都需要自備金鑰。Artemis 遊戲對話量大、對語氣敏感,所以 LLM(OpenAI / Anthropic)或 DeepL 通常讀起來最好。
步驟 1:開啟遊戲資料夾
啟動 RuneTranslate,點擊新增專案,把它指向 Artemis 的遊戲目錄。引擎偵測會自動執行,當它看到引擎的 .pfs 封存檔時,就把專案辨識為 Artemis。你的原始遊戲資料夾永遠不會被修改。
步驟 2:腳本是如何被讀取的
RuneTranslate 會開啟 .pfs 封存檔,替你把腳本取出來,一邊走一邊解開封裝並解析:
- `PF8` 封存檔:在應用程式內解開封裝,所以你不必另外執行拆包器。
- `PF6` / 舊式 `PF2` 封存檔:直接讀取。
- `.ast` 和 `.txt` 腳本:解析出對話、名稱和選項,並在編輯器裡依檔案分組列出。
行內的引擎指令和換行,在任何東西送到翻譯服務之前,都會被遮蔽成數字預留位置,送回來時再還原,於是注音標註、名牌和顏色標記能原封不動地撐過整個往返過程。
步驟 3:翻譯
選一個翻譯服務並執行。對於視覺小說,LLM(OpenAI / Anthropic)最適合角色語氣和語調,DeepL 處理旁白又快又乾淨,而免費的 Google Translate 對短選單字串和選項已經夠用。事先替你的角色陣容和反覆出現的詞彙建好詞彙表,讓名字在整款遊戲裡翻得一模一樣,詳見詞彙表 101。完成後,可以用 AI 精修器再多做一輪,它會在上下文中重讀每一行,修掉機器翻譯常留下的生硬、直譯的措辭。
步驟 4:匯出隨時可執行的副本
點擊匯出。RuneTranslate 會寫出一份遊戲的已翻譯副本,附上 root.pfs.NNN 覆蓋補丁封存檔(每個來源 .pfs 對應一個),Artemis 會最後掛載它,並優先於封裝內的原件讀取。(翻譯後的腳本也會散放出來,作為無害的額外檔案。)執行它,遊戲就能以你的目標語言遊玩。
已知的限制
- 已編譯的 `.asb` 劇本會被讀取。 許多 Artemis 遊戲是以已編譯的二進位 AST(以
ASB標記開頭的形式)而非可讀的.ast/.txt發行劇本,還有一些改了副檔名(我們測過的一款遊戲用.iet)。RuneTranslate 依簽章而非副檔名偵測它,並就地翻譯。當遊戲把說話者名稱存在圖形裡,或當作指令名稱而非腳本內的文字時,那些名稱不在腳本裡,所以會維持原樣繪製,除非遊戲把那些圖片以散放檔案存放,讓你可以在 Image Studio 裡開啟。如果某個名稱仍是日文,通常就是這個原因。 - 覆蓋補丁是載入路徑。 翻譯後的
root.pfs.NNN封存檔才是遊戲實際讀取的東西。在少數以不同方式掛載封存檔的作品上,匯出可能需要調整,這正是我們隨著回報陸續到來而持續加強的真實遊戲行為。 - 烘焙進圖片美術裡的文字(一個以點陣圖繪製的標題畫面或選單按鈕)是像素,不是腳本文字。只有當遊戲把那些圖片以散放檔案存放,而不是放在
.pfs裡時,圖片文字翻譯才處理得到。 - 確切的封存檔和腳本變體在不同版本之間可能不同。請務必在你手上的那份副本上驗證。
遇到問題了?告訴我們
.pfs 讀取器和 .ast / .txt / .asb 解析器都已在真實遊戲上測試,並在遊戲裡確認過,但 Artemis 有多年累積、每個工作室各異的變體。如果某款遊戲偵測不到、打不開封存檔、什麼也擷取不出,或匯出了它無法載入的東西,請到我們的 Discord 回報。遊戲名稱和它的封裝方式(哪種 .pfs 變體,.ast、.txt 還是 .asb),正是最能幫我們最快加強支援的資訊。
下載 RuneTranslate,把它指向你一直想讀的那款 Artemis VN,試試看。想看看我們如何處理另一個以封存檔為基礎的 VN 引擎,請接著讀 Kirikiri 教學。
準備好試用 RuneTranslate 了嗎?
免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。
下載 Windows、Mac 和 Linux 版
