登入

troubleshooting · workflow · export · exclusions

翻譯後遊戲打不開?找出那一行

翻譯好的遊戲視窗一開就關,或者永遠卡在載入畫面。你翻譯的某一行根本不是文字:一個 ID、一條路徑、一個遊戲用來比對的標記。先證明問題確實出在翻譯上,再用對半切分的辦法找到那一行:大約十三次匯出,就能把五千行縮到一行。

11 分鐘閱讀

視窗開啟,視窗又關閉。這款遊戲昨天還好好的,你花了一整晚翻譯它,現在它死了。

那些行裡有一行從來就不是文字:可能是場景名稱、檔案路徑,或是遊戲用來比對的標記。引擎一撞上它,什麼都沒畫出來就放棄了。

你不需要為了找它而讀完五千行。你只需要把同一個「是或否」的問題,問大約十三次。

簡短的答案:先證明問題確實出在翻譯上,然後對半切:翻譯一半可疑的行,匯出,執行。失敗的那一半裡就藏著你要找的那一行。對那一半重複同樣的動作,直到只剩一行。

動手找之前:問題真的出在翻譯上嗎

  1. 執行原版遊戲。不是你匯出的那份,而是沒動過的副本。如果它也打不開,問題出在你的電腦、資料夾,或遊戲本身。
  2. 只翻譯一行短而無害的文字,匯出,執行。螢幕上看得到的一個選單用語就夠了。
  3. 做完這些,才開始找那一行。

第 2 步說的是一行,而不是一行都不翻,這是刻意的。有幾個轉接器在沒有內容要寫入時會提早結束,所以一次空的匯出測的只是檔案複製,而不是真正的寫入流程;真正的流程壞掉時,它也可能照樣順利通過。

如果只翻一行的版本一樣打不開,就表示沒有哪一行單獨有問題,對半切也找不到東西。請重新匯出到一個全新的空資料夾,確認你執行的是匯出的副本而不是原版,並看一下匯出時的警告。如果還是不行,請當成交付問題回報。

這一輪排查的成本是兩次執行加一次匯出:小型 RPG Maker 專案只要幾分鐘,大型 Unity 遊戲則更久。換來的是你不必花一整晚去找一個根本不存在的東西。

有兩種情況看起來很像,其實不是。遊戲能跑,但文字變成方塊、問號或亂掉的拉丁字母:那是字型或編碼問題。安裝外掛或覆蓋層之後立刻當機:那是工具的問題,不是你的行出了問題。

用對半切找出那一行

大多數專案都包含很多檔案,而檔案清單正是最容易一刀切成兩半的東西。

  1. 在工具列點重置所有翻譯。
  2. 開啟選擇要翻譯的檔案,它自己就說得很清楚:「選擇要翻譯的檔案。未勾選的檔案不會被更動。」取消勾選一半的檔案,翻譯剩下的一半。
  3. 匯出到一個全新的空資料夾,然後執行遊戲。
  4. 如果能啟動,你要找的行就在你沒碰的那一半裡;如果不能,就在你剛翻譯的那一半裡。不管哪種情況,嫌疑清單都少了一半,另一半可以不用管。
  5. 再次重置所有翻譯,把剩下的清單再對半切,匯出,執行。
  6. 重複到只剩一個檔案,然後在這個檔案裡繼續對半切,直到只剩一行。

按檔案切比按行切粗略,所以輪數取決於檔案數:四十個檔案大約六輪就能鎖定到檔案,接著你在檔案內部從頭再來。

僅有一個檔案的專案,例如一份 NScripter 腳本,或是僅有單一劇本的 Kirikiri 或 Wolf 遊戲,就沒有檔案清單可切。這時就在行上拖曳出一個方框:核取方塊和批次操作列會自己出現,接著交給重新翻譯所選。想一次涵蓋更多行,就先用篩選和搜尋縮小範圍,再用選擇所有可見項目。這個功能要小心:它選取的正是篩選當下顯示的內容,所以忘了清掉的篩選,會悄悄汙染後面的每一輪。把你用過的篩選記下來。

以一批一百行的問題批次為例,完整走一遍:

  • 第 1 輪:100 行有嫌疑,翻譯前 50 行:能跑,表示問題在另外 50 行裡。
  • 第 2 輪:50 行有嫌疑,翻譯前 25 行:當機,表示問題就在這 25 行裡。
  • 第 3 輪:25 行有嫌疑,翻譯前 13 行:能跑,表示問題在另外 12 行裡。
  • 第 4 輪:12 行有嫌疑,翻譯前 6 行:當機,表示問題就在這 6 行裡。
  • 第 5 輪:6 行有嫌疑,翻譯前 3 行:當機,表示問題就在這 3 行裡。
  • 第 6 輪:3 行有嫌疑,翻譯前 2 行:能跑,只剩一行。

從一百行開始,最壞情況是七次匯出;從五千行開始,最壞情況大約是十三次。

一輪要花多少時間

一次匯出、一次啟動,再加上遊戲走到第一句對白所需的時間。小型 RPG Maker 專案是兩三分鐘。大型 Unity 遊戲的匯出要複製整個遊戲,標題畫面又慢吞吞,就會接近十分鐘。

所以十三輪差不多就是一整晚。這仍然是比較划算的選擇,因為另一條路是自己把五千行讀完,還得猜對。

手動操作時,有兩件事容易出錯。每一輪都匯出到全新的空資料夾,因為有些引擎會疊加掛載補丁,第 3 輪疊在第 1、2 輪上面,就等於同時測了三輪。重置就要徹底重置:請用重置所有翻譯,不要手動改回去,因為它還原的是建立專案時擷取的原文,就算你之後覆蓋過來源資料夾也一樣有效。

如果把那一行改回去之後還是打不開

那就代表不只一行有問題。在對解析很敏感的引擎上,第一次「全部翻譯」之後出現這種情況很正常。把找到的那一行保持原文,然後針對仍處於已翻譯狀態的部分,再跑一遍同樣的流程。第二個元兇往往和第一個是同一類字串,而且就在同一個檔案裡。

下次分批翻譯

分批並不會省下匯出的次數;這些匯出你本來就要做,差別在於每次失敗一出現,範圍就已經被圈得很小。壞掉的是最後一批,所以對半切是從一百行開始,而不是五千行。先從 100 行起步,等連續好幾批都乾淨通過,再放大到 500 行或整個檔案。

翻錯一行,哪些引擎會壞?

大家常說有些引擎嚴格、有些寬鬆。真正起決定作用的,是你的譯文落在什麼地方。

有些引擎把譯文當成資料來讀:Ren'Py 使用獨立檔案加上執行階段掛鉤,RPG Maker 使用跳脫過的 JSON,Unreal 則使用金鑰雜湊原樣保留的 .locres 值。遊戲的結構根本看不到你的文字,所以一行譯錯,代價就只是一行譯錯。另一些引擎則是把譯文拼接進遊戲要解析的檔案裡,成為腳本、標記或位元組串流的一部分,你的句子就變成那個檔案結構的一部分。這時一個冒號、一個方括號、多出來的一個位元組,或是同時身兼尋找鍵的字串,就足以讓遊戲停下來。

規則就這麼多。找到你的引擎,讀那一條,然後繼續往下看。

  • RPG Maker MV/MZ:結構性風險很小,JSON 和 CSV 都會跳脫。事件文字、外掛設定和遊戲內建外掛裡的文字,只有在遊戲會顯示它們的地方才會提供,而儲存程式碼、數值或固定選項的設定則保持原樣。唯一實際的風險是某些外掛用完全相等的方式比對說話者姓名,而匯出會連那個外掛的設定鍵一起改寫。
  • Ren'Py:幾乎沒有。原始碼從不被改寫,所以同時身兼邏輯鍵的字串也很安全。
  • Unreal Engine:.locres 字串的風險很小,它們設計上就是顯示文字。沒有可用 .locres 的遊戲,其文字改從已烹調的資源讀取,這時遊戲會回頭讀取的場景名稱或選單名稱若被翻譯,可能讓它停在空白畫面;RuneTranslate 現在會把這些名稱排除在外。
  • Unity:嚴重而且無聲:場景名稱、變數鍵和回呼函式,存放方式和對白一模一樣。等著你的是無限載入、按了沒反應的按鈕,或一片漆黑。
  • Godot:嚴重。節點路徑、StringName 和 res:// 參照就是引擎用來尋找的位址;寫回時會直接拒絕它們。
  • Wolf RPG:這裡最脆弱的格式。偏移一個位元組,整條串流就會失去同步,程式在視窗出現之前就中止了。
  • Kirikiri / KAG:嚴重:方括號是語法,儲存名稱就是檔案名稱。翻譯標籤名稱、轉換括號、翻譯圖片檔案名稱,每一樣都會讓遊戲當場停住。
  • Electron VN:嚴重。把範本預留位置寫進 app.asar 裡執行中的 JavaScript,那是語法錯誤,而不是一句翻得不好的話。
  • TyranoBuilder / TyranoScript:和 Kirikiri 同一路:KAG 標籤屬於標記,所以翻譯標籤就等於改語法。行內的角色引用永遠不會被改寫。
  • NScripter:嚴重,而且獨一無二:?、% 和 $ 是變數前綴,落單一個就是語法錯誤。
  • YU-RIS:嚴重,因為這個格式所謂的字串裡,有很大一部分其實是運算子。把兩者分開之後,某款遊戲的有效行數從 40,678 降到 8,914,而且沒有遺漏任何對白。

其他引擎在引擎頁面中各有自己的頁面和指南。

殺死一款遊戲的三行字

RuneTranslate 裡的每一條排除規則,都是用一款再也打不開的遊戲換來的。這三條都已經修好了。每一次,出問題的那一行看起來都完全正常,匯出也是一路綠燈。

Godot:遊戲憑空造出一個角色。有一行寫著 Warning: the door is locked。完美的英文。Dialogic 會跳脫儲存文字裡的每一個冒號,因為沒跳脫的冒號,正是它切出說話者姓名的方式。原樣寫回之後,這句話被重新解析成一個名叫 Warning 的角色在說 the door is locked,外掛也就老老實實地把這個角色建了出來。

Kirikiri:遊戲跑去找一個叫 `End` 的檔案。一個按鈕的標籤裡同時帶有圖片檔案名稱和跳轉標籤,而遮罩處理跨不過本身含有括號的標籤,於是兩者都暴露出來,被拿去翻譯了。現在的掃描器看得懂括號:它會在配對的括號處收尾,巢狀的運算式留在標籤內部,而一般標籤仍然在它的第一個 ] 處結束。

RPG Maker:一張立繪悄悄消失。某個立繪外掛是靠把說話者姓名逐字比對它自己設定裡的表格,來挑選角色圖片。翻譯姓名是對的;不去動那份設定也是對的,因為裡面全是資源鍵。兩件對的事湊在一起,等號就不成立了,這個角色的立繪因此消失,紀錄裡什麼都沒留下。

三次匯出都回報成功。乾淨的匯出不能證明遊戲能執行,任何引擎都一樣。唯一的證據,就是把它啟動起來。

當問題根本不在你的行上

對半切找不到這些情況,因為沒有哪一半能跑起來:問題在於匯出的檔案落在什麼地方。Wolf RPG 遊戲會先讀自己的 .wolf 封存檔,再看旁邊的散裝檔案,於是有一款遊戲照常顯示標題畫面,而翻譯好的資料就躺在硬碟上沒人讀。Unity 的 Addressables 會拒絕位元組與校驗和對不上的套件,然後給你一片漆黑,任何紀錄裡都沒有記載。已封裝的 RPG Maker 遊戲會無視放在執行檔旁邊的資料檔案。這三種現在都已處理,所以交付層面的失敗值得回報,而不值得自己去追查。

有沒有什麼標記能看出哪些行是對白?

沒有。誰說有,你都該留個心眼。

曾經有位使用者告訴我們,他發現某款 Godot 遊戲把每一句對白都用 || 包起來,他只翻譯了這些,遊戲跑得好好的。對那款遊戲來說確實管用。但那是某一位開發者的習慣,不是 Godot 的慣例,下一款遊戲會換成別的做法。

反例來自 YU-RIS。在某款遊戲裡,反引號那一路存放著整張介面字串表,692 行裡有 687 行是顯示文字,可是反引號在那裡依然什麼都不代表。三種引號編譯出來是同一種東西,所以建立在分隔符號上的規則,會把真正的正文也標成紅色。值放在哪裡,什麼都告訴你了;它被什麼引號包著,卻什麼也沒告訴你。

請依靠位置和形態,而這兩樣都讓遊戲自己來教你。啟動它,讀螢幕上出現的第一句對白,然後在編輯器裡找到那一行:它所在的檔案、所屬的群組、前後相鄰的行,就是這款遊戲裡對白該有的樣子。凡是待在別處的,都有可能不是對白。

應用程式能標出什麼,又無從得知什麼

RuneTranslate 會把它認為是程式碼、資源路徑或識別碼的行標記為已排除。這些行預設是隱藏的,數量顯示在顯示已排除核取方塊旁邊;開啟它,這些行就會以橘色顯示,讓你看清它的判斷,你也可以用仍然翻譯強制處理任何一行。你還可以新增自己的規則。

如果你選取了已排除的行再開始一次執行,它會停下來詢問:「你選取的 340 行中有 12 行被排除,這些行是被你的過濾規則標記,或被 RuneTranslate 判定為程式碼、素材路徑或 ID。翻譯它們可能會導致遊戲出錯。略過會讓它們保持排除狀態;翻譯則會讓它們在之後的執行中也一併加入。」

點下去沒關係。只要記得你點過,因為一旦匯出的版本打不開,那裡就是第一個該回頭檢查的地方。

一個誠實的限制:排除只是對某個字串的猜測,所以它無從得知你遊戲裡的某句話,同時也是隨遊戲附帶的某個外掛的尋找鍵。如果遊戲的來源語言本來就是英文,保護會更少,因為最有力的那批篩選,靠的正是「這個字串裡有沒有來源語言的文字」。

常見問題

為什麼翻譯之後遊戲就打不開了?

幾乎都是因為你翻譯的某一行其實是識別碼、路徑、場景名稱,或是遊戲用完全相等比對的標記。改動它會破壞解析,或是破壞尋找。

怎麼找出是哪一行翻譯弄壞了遊戲?

對半切。重置所有翻譯,翻譯一半,匯出到空資料夾,執行。失敗的那一半裡就有那一行;把它再切一半,如此重複。一百行需要六到七輪,五千行大約十三輪。

翻譯後的遊戲一開就關,這代表什麼?

啟動過程中出現了致命錯誤。在 Kirikiri、Electron 視覺小說和 NScripter 上,通常是語法錯誤:某個括號、引號或預留位置被翻譯或弄丟了。在 Wolf RPG 和 YU-RIS 上,則是資料串流失去同步。

為什麼翻譯後的遊戲打開是一片黑畫面?

多半是某次載入在會吞掉例外的程式碼裡失敗了;在 Unity 上,則是某個套件的校驗和不再符合目錄裡的記錄。試著做一個只翻譯了一行無害文字的版本:如果它也是黑畫面,問題出在交付上,而不在任何一行。

翻譯後的遊戲卡在載入畫面,是翻譯的問題嗎?

在 Unity 上很可能是。無限載入正是場景名稱或變數鍵被翻譯後的典型症狀:遊戲在等一個已經對不上的名稱,而且不會拋出任何錯誤。

哪些行絕對不該翻譯?

凡是遊戲靠完全相等的字串來解析的東西:路徑、場景名稱和節點名稱、變數名稱和事件名稱、語言代碼,以及任何長得像 snake_case 或 res:// 的東西。如果你想不出玩家會在螢幕上讀到它,就別動它。

遊戲能跑,但文字是方塊或問號,這是同一個問題嗎?

不是。整齊的方塊代表字型裡沒有這些字元的字形;真正的問號代表它們在寫入檔案時就已經遺失。兩者都屬於字型或編碼問題,但解法各不相同。

接下來看什麼

你是要開始一次翻譯,而不是修一次翻譯?如何製作翻譯補丁把整個流程都講完了。

找到那一行之後:讓它保持原文,把它周圍的內容都翻譯好,匯出到一個全新的空資料夾,然後執行。一個沒翻譯的識別碼,對玩家來說不會有任何損失。

準備好試用 RuneTranslate 了嗎?

免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。

下載 Windows、Mac 和 Linux 版