UE5 プロジェクト多言語化完全ガイド（ローカライズダッシュボード / FText / Culture 切替 / 翻訳ワークフロー）

1UE5 における多言語化の全体像

UE5 で多言語対応を行うときの基本は次の 3 点です。

• 表示するテキストは FText（Text 型）で持つ
• 翻訳データは ローカライズダッシュボードでターゲット単位に管理する
• 実行時に Set Current Culture + Apply Settings で言語を切り替える

String 型（FString）の文字列は翻訳の対象にならないため、UI の文言・台詞・アイテム名はすべて FText で扱う必要があります。

2事前準備：ローカライズの有効化

「編集 → プロジェクト設定 → エディタ → エクスペリメンタル」または「エディタの環境設定」から Localization Dashboard（ローカライゼーション ダッシュボード）を有効にします。プロジェクト設定の「Internationalization」セクションでは、パッケージ時に同梱する言語を選択できます。

3ワークフロー：Gather → Translate → Import → Compile

新しいターゲットは「新しいローカライズターゲット」で作成し、「Game」（プロジェクト全体）や「Engine」「Editor」などを切り分けます。多くのゲームプロジェクトでは Game ターゲット 1 つで十分です。

4テキストの書き方：FText を使う

Blueprint の場合

変数の型に Text を選択するか、「Make Literal Text」「Format Text」ノードでリテラル文字列を作ります。文字列リテラルは自動でキーが振られ、ダッシュボードの Gather 対象になります。

C++ の場合

#include "Internationalization/Text.h"

// NSLOCTEXT(namespace, key, sourceText)
FText Hello = NSLOCTEXT("MyGame", "HelloMessage", "こんにちは、世界");

// LOCTEXT を使うパターン（ファイル冒頭に LOCTEXT_NAMESPACE を定義）
#define LOCTEXT_NAMESPACE "MyGame"
FText Title = LOCTEXT("MainTitle", "メインメニュー");
#undef LOCTEXT_NAMESPACE

// フォーマット
FFormatNamedArguments Args;
Args.Add(TEXT("Score"), FText::AsNumber(1234));
FText Msg = FText::Format(LOCTEXT("ScoreFmt", "スコア: {Score}"), Args);

NSLOCTEXT / LOCTEXT は collator が認識するマクロで、ビルド時にキーごと収集されます。直接 FText::FromString() で作った文字列は翻訳対象になりません。

5言語の切替：Set Current Culture

Blueprint で動的に言語を切り替えるには次のノードを使います。

典型的な言語切替フロー

1. 言語選択 UMG で「日本語」「English」ボタンを表示
2. クリックで Set Current Culture("ja") / Set Current Culture("en-US") を呼ぶ
3. Apply Settings(bCheckForCommandLineOverrides=false) を呼んで GameUserSettings.ini に保存
4. UMG をリビルド（Construct Widget を作り直す or 「Synchronize Properties」）

6ネイティブカルチャとフォールバック

ローカライズターゲットには「ネイティブカルチャ」を 1 つ指定します。これは原文の言語であり、未翻訳キーが見つからない場合のフォールバック先になります。日本のスタジオで日本語原文の場合は ja をネイティブカルチャに設定するのが自然です。

7UMG での注意点

• Text ブロックの「Text」プロパティに直接打ち込んだ文字列は FText として収集されます
• Bind で関数を返り値 FText にすれば動的テキストも翻訳対象
• String を To Text でキャストしても翻訳されない（キーが無いため）
• フォント差し替え（中文・韓文）は Font Family の「Sub Font」設定でカルチャ別に切替可能

8パッケージング時の設定

「プロジェクト設定 → パッケージング → Internationalization Support」で「Conformant Localizations」または「All」を選び、同梱したい言語にチェックを入れます。EFIGS（English/French/Italian/German/Spanish）プリセットも用意されています。

9よくあるトラブル

10関連

• RInterp To — UE5 のノード一覧から
• Blueprintで「Cast To」を使い、複数のクラスに対応する方法
• Event ActorBeginOverlap と On Component Begin Overlap の違い
• ブループリントで現在日時を取得する方法