將遊戲國際化

前言

雖然獨立或小眾遊戲通常不需要本地化，但如果目標是更大規模的市場，則經常需要翻譯和本地化。Godot 提供了許多工具，讓這個流程更加簡單，因此這份教學更像是匯集了一些實用的小技巧和建議。

當地語系化通常是通過雇傭特定的工作室來完成的，儘管有大量的軟體和檔案格式可供使用，但迄今為止進行當地語系化最常見的方式仍然是使用試算表。建立試算表並匯入試算表的過程已經在 匯入翻譯 教學中介紹過了，所以這個教學更像是對那個教學的後續。

備註

我們將以官方範例專案作為示範，你可以從「資源庫」下載：Asset Library。

配置匯入的譯文

翻譯可以在更改時得到更新和重新匯入，但仍必須新增到專案中。可通過**專案 → 專案設定 → 當地語系化**來完成：

上述對話方塊用於新增或刪除專案範圍內的翻譯。

資源的當地語系化

也可以指示 Godot 使用資產 (資源) 的替代版本，根據目前的語言。這可用於本地化影像，例如遊戲內的看板或本地化語音。

重新對應 分頁可用於此目的：

選擇需要重定向的資源，並指定它在其他語言地區的替代方案。

備註

DynamicFonts 不支援資源重新對應系統。若要根據語言的腳本使用不同的字形，請改用 DynamicFont 後備系統，它允許您定義任意數量的後備字形。

DynamicFont 後備系統的優點是，無論目前語言如何，它都可以工作，這使其非常適合文字語言可能與客戶端語言不配對的多人聊天等情況。

自動設定語言

建議預設為使用者偏好的語言，這可以透過 OS.get_locale_language() 取得。如果您的遊戲不提供該語言版本，它將會回退到 專案設定 > 國際化 > 地區 中的 回退，如果為空則回退到 en。然而，基於各種原因 (例如翻譯品質或玩家偏好)，仍建議允許玩家在遊戲中變更語言。

GDScript

var language = "automatic"
# Load here language from the user settings file
if language == "automatic":
   var preferred_language = OS.get_locale_language()
   TranslationServer.set_locale(preferred_language)
else:
   TranslationServer.set_locale(language)

本地化和語系

一個 語系 通常是語言與地區或國家的組合，但也可以包含像是文字書寫系統或變體等資訊。

範例：

• en: 英文

• en_GB: 英文(英國)

• en_US: 英文（美國

• en_DE: 英文（德國）

獨立遊戲一般只需要關心語言，但請繼續閱讀以獲得更多資訊。

為什麼需要地區設定（locale）？以美國與英國為例，兩者都說英文，但有很多不同：- 拼字不同，如 gray（美）、grey（英）- 用詞不同，如 eggplant（美）、aubergine（英）- 使用的單位或貨幣不同，如 feet/inches（美）、metres/cm（英）

然而，這可能會變得更複雜。假設您在歐洲和中國提供不同的內容 (例如在大型多人線上遊戲中)。您需要將各種不同的內容翻譯為多種語言，並據此進行儲存和載入。

將鍵轉換為文字

一些控制項，例如 Button 和 Label，如果它們的文字與一個翻譯鍵值相配對，將自動獲取翻譯內容。例如，如果一個標籤的文字是“MAIN_SCREEN_GREETING1”並且該鍵值存在於目前的翻譯中，那麼該文字將被自動翻譯。

這種自動翻譯行為在某些情況下可能是不可取的。例如，當使用 Label 來顯示玩家的名字時，如果玩家的名字與翻譯鍵相配對，你很可能不希望進行翻譯。要禁用某個節點的自動翻譯，請在屬性檢視器中禁用**Localization > Auto Translate**（當地語系化 > 自動翻譯）。

在程式碼中, 可以使用 Object.tr() 函式. 這將只是在翻譯中搜尋文字, 如果找到的話就進行轉換:

GDScriptC#

level.text = tr("LEVEL_5_NAME")
status.text = tr("GAME_STATUS_%d" % status_index)

備註

如果更改語言後不顯示任何文字，請嘗試換一個字形。預設專案字形僅支援 Latin-1 字元集的子集，無法用於顯示俄語、漢語等文字。

多語言字形的一個很好的資源是「Noto Fonts <https://www.google.com/get/noto/>」。如果您使用的是不太常見的語言，請確保下載正確的變體。

下載字形後，將 TTF 檔案載入到 DynamicFont 資源中，並將其用作控制節點的自訂字形。為了獲得更好的可重複使用性，請將新的主題資源關聯到根控制節點，並將 DynamicFont 定義為主題中的預設字形。

佔位符

若要在您的翻譯字串中使用占位符，請使用 GDScript 格式化字串 或 C# 中的等效功能。這讓翻譯者可以在字串中自由地移動占位符的位置，使得翻譯聽起來更自然。應盡可能使用具名占位符搭配 String.format() 函式，因為它們也讓翻譯者能夠選擇占位符出現的順序：

GDScript

# The placeholder's locations can be changed, but not their order.
# This will probably not suffice for some target languages.
message.text = tr("%s picked up the %s") % ["Ogre", "Sword"]

# The placeholder's locations and order can be changed.
# Additionally, this form gives more context for translators to work with.
message.text = tr("{character} picked up the {weapon}").format({character = "Ogre", weapon = "Sword"})

翻譯語境

如果你使用普通的英文所謂來源字串（而不是類似於 LIKE_THIS 的消息程式碼），那麼就有可能會遇到歧義的情況，同一個英文字串可能需要在某些目的語言中翻譯為不同的字串。你可以通過指定可選的*翻譯本文*來消除歧義，即便原始字串是相同的，也能夠讓目的語言能夠使用不同的字串：

GDScriptC#

# "Close", as in an action (to close something).
button.set_text(tr("Close", "Actions"))

# "Close", as in a distance (opposite of "far").
distance_label.set_text(tr("Close", "Distance"))

複數化

多數語言會根據單數或複數而使用不同的字串。不過，單純以物件數量是否大於 1 來判斷是否為複數，對所有語言都不適用。

有些語言有兩種以上的複數形式，不同的複數需要的物件數量也各不相同。Godot 提供了對*複數*的支援，目標地區可以自動進行處理。

複數應該只用於正整數（或零）的情況。負數和浮點數所代表的物理實體數量是單數還是複數一般無法明確區分。

GDScriptC#

var num_apples = 5
label.text = tr_n("There is %d apple", "There are %d apples", num_apples) % num_apples

如有需要，也可以與語境（context）結合使用：

GDScriptC#

var num_jobs = 1
label.text = tr_n("%d job", "%d jobs", num_jobs, "Task Manager") % num_jobs

備註

僅 使用 gettext 進行在地化 支援提供複數化翻譯，CSV 格式不支援。

讓控制項可調整大小

不同語言的相同文字的長度差異很大。為此，請務必閱讀教學 尺寸與錨點，因為動態調整控制項大小可能有所説明。Container 可能很有用，Label 的文字換行選項應該也能幫上忙。

若要檢查您的 UI 是否可以容納比原始字串更長的翻譯，您可以在進階專案設定中啟用*偽本地化*。這將用更長的版本替換所有可本地化的字串，同時用帶有重音的版本替換原始字串中的一些字元（同時仍然可讀）。佔位符保持原樣，以便在啟用偽本地化時它們繼續工作。

例如，當啟用偽本地化時，字串「Hello world, this is %s!」將變為「[Ĥéłłô ŵôŕłd́, ŧh̀íš íš %s!]」。

雖然第一眼看上去很奇怪，但是偽當地語系化的好處有很多：

• 它可以讓您快速發現不可本地化的字串，這樣您就可以檢查它們並使它們可本地化（如果這樣做有意義的話）。

• 它可以讓您檢查無法容納長字串的 UI 元素。許多語言的翻譯都會比原始文字長得多，因此確保您的 UI 能夠容納比平常更長的字串非常重要。

• 它讓您檢查您的字型是否包含支援各種語言所需的所有字元。然而，由於偽本地化的目標是保持原始字串可讀，因此它不是一個有效的測試，無法檢查字型是否能支援 CJK 或由右至左書寫的語言。

專案設定可讓您調整偽本地化行為，以便您可以根據需要停用其部分內容。

TranslationServer（翻譯伺服器）

Godot 具有一個處理底層翻譯管理的伺服器，稱為 翻譯伺服器。可以在執行期間新增或移除翻譯；目前的語言也可以在執行期間變更。

雙向文字和 UI 鏡像

阿拉伯語和希伯來語是從右到左書寫的（除了混合的數字和拉丁單字），這些語言的使用者介面也應該是鏡像的。在某些語言中，字形的形狀會根據周圍的字元而變化。

對雙向書寫系統和 UI 鏡像的支援是透明的，您通常不需要更改任何內容或了解特定書寫系統。

對於 RTL（從右至左）語言，Godot 會自動對 UI 進行以下調整：

• 鏡像左右錨點和邊距。

• 交換文字的左對齊和右對齊。

• 鏡像容器中子控制項的水平順序以及 Tree/ItemList 控制項中專案的水平順序。

• 控制項內部元素使用鏡像順序（例如 OptionButton 的下拉按鈕、單選框的位置、列表方塊列的順序、Tree 專案的圖示和連接線的位置等），某些鏡像的控制項會使用單獨的主題樣式。

• 坐標系不會鏡像，非 UI 節點（精靈等）不受影響。

可以使用下列控制項屬性來覆寫文字和控制項佈局方向：

• text_direction，設定基本文字方向。當設定為“auto”時，方向取決於根據 Unicode 雙向演算法的文字中的第一個強方向字符，

• “語言”，覆蓋目前專案區域設定。

• structured_text_bidi_override 屬性與 _structured_text_parser 回呼，可啟用對結構化文字的特殊處理。

• “layout_direction”，覆蓋控制鏡像。

也參考

您可以使用 BiDI 與字型功能示範專案 來實際查看由右至左排版是如何運作的。

將斷詞資料新增到匯出專案

有些語言的書寫沒有空格，單字和換行需要的不僅僅是字元序列的規則。 Godot 包括 ICU 規則和基於字典的中斷迭代器資料，但預設情況下此資料不包含在匯出的專案中。要包含它，請前往 專案 → 專案設定 → 本地化 → 文字伺服器資料，然後按一下 安裝支援資料...。中斷迭代器資料大約有 4 MB 大。

結構化文字 BiDi 覆寫

Unicode BiDi 演算法設計用於處理自然文字，它無法處理具有更高層級順序的文字，例如檔案名稱、URI、電子郵件地址、正規表示式或原始程式碼。

例如，所顯示的目錄結構的路徑將顯示不正確（頂部「LineEdit」控制項）。 「檔案」型別結構化文字會覆寫將文字分割成段，然後將 BiDi 演算法單獨套用到每個段，以正確顯示任何語言的目錄名稱並保留資料夾的正確順序（底部「LineEdit」控制項）。

自訂回調提供了一種覆蓋其他型別結構化文字的 BiDi 的方法。

數字本地化

專門設計用於數值輸入或輸出的 Control (例如 ProgressBar、SpinBox) 將會自動使用本地化數字系統，對於其他 Control，TextServer.format_number(string, language) 可用於將西方阿拉伯數字 (0..9) 轉換到本地化數字系統，以及 TextServer.parse_number(string, language) 將其轉換回來。

圖示與圖片本地化

帶有左右指向箭頭的圖示可能需要在阿拉伯語和希伯來語語言環境中顛倒過來，以防它們指示移動或方向（例如後退/前進按鈕）。否則，它們可以保持不變。

翻譯測試

你可能會想要在發行前測試專案的翻譯。Godot 為此提供了兩種方法。

首先，在專案設定中，國際化 > 語言區域 下方 (已啟用進階設定)，有一個 測試 屬性。將這個屬性設定為您想測試語言的語言區域代碼。當專案執行時 (無論是從編輯器或匯出後)，Godot 將會以該語言區域執行專案。

請記住，因為這是一個專案設定，設為非空時會在版本控制中顯示。因此，將修改提交到版本控制之前，應該將其設回空值。

翻譯也可以在 從命令列執行 Godot 時 測試。例如，若要測試法文的遊戲，可以提供以下引數：

godot --language fr

專案名稱翻譯

匯出到不同作業系統和平台時，專案名稱會變成應用程式名稱。若要指定多種語言的專案名稱，請前往 「專案 > 專案設定 > 應用程式 > 配置」。從這裡按一下「可本地化字串 (size 0)」按鈕。現在下面應該有一個按鈕，上面寫著 Add Translation。按一下該按鈕，就會轉到一個頁面，您可以在此選擇專案名稱翻譯的語言 (如果需要，也可以選擇國家/地區)。完成後，您就可以輸入本地化的名稱。

如果您不確定要使用的語言代碼，請參閱 語言環境代碼列表。