メインコンテンツへスキップ
見出し画像

Godotゲームを後から日英対応:auto_translateの罠とtr()が要る4場面【実録#37・Godot多言語対応】

    日本語で作り込んだGodot 4製のスマホゲームを、後から英語対応しました。

    結論から言うと、Godotの「auto_translateをONにすれば.textは勝手に翻訳される」という理解は、半分ウソです。

    整形・連結・複数行・ネイティブダイアログでは、まったく効きません。

    この4場面を知らないと、EN表示にした瞬間、画面のあちこちに日本語が生き残ります。

    そして厄介なのは、その日本語がコードをgrepしても見つからないことです。

    「日本語リテラルは全部消したはずなのに、画面には残っている」。

    この矛盾に何度も足を取られました。

    この記事は、こんな人に向けて書いています。

    • Godotで日本語ゲームを作ってしまい、後から多言語対応したい人

    • auto_translateをONにしたのに、画面に日本語が残って困っている人

    • 「翻訳漏れ」をどうやって網羅的に潰すか、手順が知りたい人

    読み終わると、後付けi18nで「どこを機械翻訳任せにして、どこをtr()で明示的に翻訳するか」の線引きができる状態になります。

    そして、翻訳漏れを「勘」ではなく「手順」で潰せるようになります。

    なぜ後から多言語対応したのか

    章扉カード01

    最初から多言語を想定して作れば楽だった、というのは正論です。

    でも個人開発だと、まず日本語で全部作り切って「面白いか」を確かめるのが先でした。

    面白いと確信できてから、はじめて「英語圏にも出したい」と欲が出ます。

    つまり後付けi18nは、個人開発ではむしろ自然な順番なんです。

    問題は、Godotの多言語対応の情報が「最初から設計する前提」で書かれていること。

    「Controlのauto_translateをONにすればいい」という記事は多い。

    でもそれは、UIラベルを静的に置くだけの、いちばん簡単なケースの話でした。

    作り込んだゲームには、動的に組み立てる文字列が山ほどあります。

    あなたのプロジェクトにも、"[%s] %s"みたいな整形文字列、ありませんか?

    正直に言うと、私も最初は「auto_translateをONにすれば終わり」だと思っていました。

    ロケールを英語に切り替えて、意気揚々とプレイを始めた瞬間。

    UIは英語なのに、カード名も、敵の名前も、ロアも、日本語のまま。

    「え、効いてないの?」と、まず自分の設定ミスを疑いました。

    でも設定は合っている。効かない場所と効く場所が、混在していたんです。

    その境界がどこにあるのか——それを解き明かすのが、この記事のテーマです。

    使った仕組み:原文キー方式のCSV運用

    章扉カード02

    まず全体の仕組みを説明します。ここは出し惜しみしません。

    Godotの翻訳は、キーと各言語の訳文を対応させる.translationファイルで動きます。

    私が採用したのは、CSVで管理して--importで.translationを生成する原文キー方式です。

    CSVの構造はシンプルで、3列だけです。

    • keys(翻訳キー。日本語の原文をそのままキーにする方式)

    • ja(日本語訳)

    • en(英語訳)

    このCSVをGodotの--importに通すと.translationが生成されます。

    あとはproject.godotにその翻訳ファイルを登録すれば、土台は完成です。

    コード側ではtr("原文キー")を呼ぶと、現在のロケールに応じた訳文が返ります。

    Controlのauto_translateがONなら、.textに入れた文字列は自動でtr()相当が効きます。

    ここまでは、多くの記事に書いてあるとおりです。

    翻訳の順番:UI → 全データの二段構え

    章扉カード03

    作業は二段構えで進めました。

    まずUI・システム文言(ボタン、メニュー、通知など)を先に翻訳。

    次に全ゲームデータを翻訳しました。

    ゲームデータというのは、カード・武器・防具・道具・ロア(世界観テキスト)・敵・エリア・職業説明などです。

    作り込んだゲームほど、この「データの文言」が膨大になります。

    UIだけ英語にして満足すると、中身が全部日本語のまま、という悲劇が起きます。

    ここまでで「翻訳の材料」は揃いました。

    でも、本当の戦いはここからでした。

    なぜUIを先に、データを後にしたか

    章扉カード04

    順番には理由があります。

    UIは数が少なく、しかも壊れるとすぐ気づけます。

    ボタンのラベルが日本語のままなら、起動して1画面目で分かる。

    だからUIは「早く回して早く直す」対象として先に潰しました。

    一方、ゲームデータは数が膨大で、しかも奥の画面にしか出ません。

    カードの説明文やロアは、特定の状況に進まないと表示されない。

    つまり「起動しただけでは漏れに気づけない」種類の文言です。

    だからデータは、後述するEN一括スクショで網羅的に炙り出す方針にしました。

    「気づける文言」と「気づけない文言」で、攻め方を変えたわけです。

    あなたのゲームで「奥の画面にしか出ない文言」、どれくらいありますか?

    罠その1:整形文字列は翻訳されない

    章扉カード05

    最初にハマったのが、整形文字列です。

    たとえば"[%s] %s" % [tag, name]のように、テンプレートに値を埋め込むコード。

    この最終結果の文字列は、CSVのどのキーとも一致しません。

    だからauto_translateがONでも、翻訳されず日本語のまま画面に出ます。

    正解は、テンプレートと、埋め込むデータ名の両方をtr()することでした。

    "[%s] %s" % [tr(tag), tr(name)]のように、部品ごとに翻訳してから組み立てる。

    「文字列を組み立ててから翻訳」ではなく「翻訳してから組み立てる」。

    この順番を逆にすると、一生バグります。

    あなたのコードに、% [...]で組み立てている表示文字列、いくつありますか?

    罠その2:複数行文字列も翻訳されない

    章扉カード06

    次にハマったのが、"...\n..."のような複数行文字列です。

    auto_translateは、1行=1キーを前提に動いているようでした。

    だから改行を含む文字列は、丸ごとキー不一致になって翻訳されません。

    これは_trml()という自作ヘルパーで解決しました。

    やっていることは単純で、文字列を改行で分割し、行ごとにtr()して、また\nで結合するだけ。

    つまり複数行を「単行の集まり」に分解してから翻訳するわけです。

    ロアや職業説明のような長文は、ほぼ全部この_trml()を通しました。

    コードの中身は有料部に置いておきます。

    罠その3:ネイティブダイアログは翻訳しづらい

    3つめは、Godot標準のConfirmationDialogです。

    これはOS風のグレーの見た目で、そもそも世界観と合いませんでした。

    さらに、ボタンのラベルなどが翻訳しづらく、英語化の穴になりやすい。

    そこで、自作のCanvasLayerオーバーレイに丸ごと置き換えました。

    暗幕を敷いて、金枠の箱を出して、ボタンを2つ並べるだけの構成です。

    見た目が世界観に合うようになり、しかも文言を自分のtr()で完全に制御できます。

    「標準UIを捨てて自作する」判断は勇気が要ります。

    でも翻訳のしやすさと世界観、両方が手に入るなら安いものでした。

    補足すると、ネイティブダイアログはOSやプラットフォームで挙動が変わります。

    多言語対応でいちばん読めない部分を、標準UIに握らせておくのは怖い。

    自作オーバーレイなら、表示も文言も全部こちらのtr()で決まります。

    「翻訳しづらいUIは、翻訳しやすいUIに置き換える」——これも一つの手でした。

    罠その4:判断はgrepではなくEN表示のスクショでしかできない

    ここがこの記事でいちばん伝えたいところです。

    翻訳漏れを探すとき、多くの人は「コードに生の日本語があるか」をgrepすると思います。

    でも、これは無駄でした。

    CSVにキーさえあれば、コードに日本語リテラルがあっても翻訳されます。

    逆に、CSVにキーが無ければ、コードがどれだけ綺麗でも日本語のまま残ります。

    つまり「コードの見た目」と「画面の見た目」は一致しないんです。

    だから、翻訳漏れの判断はEN表示にした実際のスクリーンショットでしかできません。

    私は全画面をEN表示でレンダリングして、「実際に画面に残った日本語」を目視で総点検しました。

    この作業のために、使い捨ての一括スクショツールを作りました。

    この記事で手に入るもの(有料部の目次)

    ここまでで「なぜ効かないのか」「どう考えるか」は全部説明しました。

    理解は無料。ここから先は「そのまま再現できる手順とコード」です。

    有料部には、以下を全部置いています。

    • 設計判断の理由:原文キー方式を選んだ理由と、捨てた選択肢

    • _trml()ヘルパーの実コード:複数行を行ごとにtr()する関数

    • tr()適用パターン集:整形・連結・複数行それぞれの書き換え例

    • EN一括検証スクショツールの実コード:set_locale("en")→SubViewport→PNG保存の流れ

    • --headlessが使えなかった理由と、その回避

    • CSV運用チェックリスト:列崩壊・スペース・空行混入の検出コマンド

    Godotの後付けi18nは、情報が散らばっていて、自力だと画面点検だけで何時間も溶かします。

    この記事は、その試行錯誤を¥500で省略するものです。

    特に「EN表示の全画面スクショを自動で吐く」部分は、作れば一瞬、知らなければ延々と手動スクショ地獄です。

    ◀ 前回: Godot 4の.tresが「Cannot get class」で全滅する原因と一括修正法【実録#36・.tresの罠】

    📚 シリーズ全話はまとめマガジンへ

    https://note.com/lazy_engineer/m/m03a726b1673c

    💡 ここから先は有料です(¥500)
    Godotの後付けi18nで自分が溶かした「翻訳漏れの潰し方」を、コードと検出コマンドごと全部置いておきます。

     
     
    ITエンジニア9年目 / AI自動化 / note副業実録 AIを使えば、もっと楽できると気づいた。 noteで月10万円を目指す過程を、売上スクショ付きで全部公開します。 うまくいかない月も、ちゃんと出します。 「重い副業はしたくない」エンジニア・IT系の人に届けたい。

    あなたへのおすすめ