
Godotゲームを後から日英対応:auto_translateの罠とtr()が要る4場面【実録#37・Godot多言語対応】
日本語で作り込んだGodot 4製のスマホゲームを、後から英語対応しました。
結論から言うと、Godotの「auto_translateをONにすれば.textは勝手に翻訳される」という理解は、半分ウソです。
整形・連結・複数行・ネイティブダイアログでは、まったく効きません。
この4場面を知らないと、EN表示にした瞬間、画面のあちこちに日本語が生き残ります。
そして厄介なのは、その日本語がコードをgrepしても見つからないことです。
「日本語リテラルは全部消したはずなのに、画面には残っている」。
この矛盾に何度も足を取られました。
この記事は、こんな人に向けて書いています。
Godotで日本語ゲームを作ってしまい、後から多言語対応したい人
auto_translateをONにしたのに、画面に日本語が残って困っている人
「翻訳漏れ」をどうやって網羅的に潰すか、手順が知りたい人
読み終わると、後付けi18nで「どこを機械翻訳任せにして、どこをtr()で明示的に翻訳するか」の線引きができる状態になります。
そして、翻訳漏れを「勘」ではなく「手順」で潰せるようになります。
なぜ後から多言語対応したのか

最初から多言語を想定して作れば楽だった、というのは正論です。
でも個人開発だと、まず日本語で全部作り切って「面白いか」を確かめるのが先でした。
面白いと確信できてから、はじめて「英語圏にも出したい」と欲が出ます。
つまり後付けi18nは、個人開発ではむしろ自然な順番なんです。
問題は、Godotの多言語対応の情報が「最初から設計する前提」で書かれていること。
「Controlのauto_translateをONにすればいい」という記事は多い。
でもそれは、UIラベルを静的に置くだけの、いちばん簡単なケースの話でした。
作り込んだゲームには、動的に組み立てる文字列が山ほどあります。
あなたのプロジェクトにも、"[%s] %s"みたいな整形文字列、ありませんか?
正直に言うと、私も最初は「auto_translateをONにすれば終わり」だと思っていました。
ロケールを英語に切り替えて、意気揚々とプレイを始めた瞬間。
UIは英語なのに、カード名も、敵の名前も、ロアも、日本語のまま。
「え、効いてないの?」と、まず自分の設定ミスを疑いました。
でも設定は合っている。効かない場所と効く場所が、混在していたんです。
その境界がどこにあるのか——それを解き明かすのが、この記事のテーマです。
使った仕組み:原文キー方式のCSV運用

まず全体の仕組みを説明します。ここは出し惜しみしません。
Godotの翻訳は、キーと各言語の訳文を対応させる.translationファイルで動きます。
私が採用したのは、CSVで管理して--importで.translationを生成する原文キー方式です。
CSVの構造はシンプルで、3列だけです。
keys(翻訳キー。日本語の原文をそのままキーにする方式)
ja(日本語訳)
en(英語訳)
このCSVをGodotの--importに通すと.translationが生成されます。
あとはproject.godotにその翻訳ファイルを登録すれば、土台は完成です。
コード側ではtr("原文キー")を呼ぶと、現在のロケールに応じた訳文が返ります。
Controlのauto_translateがONなら、.textに入れた文字列は自動でtr()相当が効きます。
ここまでは、多くの記事に書いてあるとおりです。
翻訳の順番:UI → 全データの二段構え

作業は二段構えで進めました。
まずUI・システム文言(ボタン、メニュー、通知など)を先に翻訳。
次に全ゲームデータを翻訳しました。
ゲームデータというのは、カード・武器・防具・道具・ロア(世界観テキスト)・敵・エリア・職業説明などです。
作り込んだゲームほど、この「データの文言」が膨大になります。
UIだけ英語にして満足すると、中身が全部日本語のまま、という悲劇が起きます。
ここまでで「翻訳の材料」は揃いました。
でも、本当の戦いはここからでした。
なぜUIを先に、データを後にしたか

順番には理由があります。
UIは数が少なく、しかも壊れるとすぐ気づけます。
ボタンのラベルが日本語のままなら、起動して1画面目で分かる。
だからUIは「早く回して早く直す」対象として先に潰しました。
一方、ゲームデータは数が膨大で、しかも奥の画面にしか出ません。
カードの説明文やロアは、特定の状況に進まないと表示されない。
つまり「起動しただけでは漏れに気づけない」種類の文言です。
だからデータは、後述するEN一括スクショで網羅的に炙り出す方針にしました。
「気づける文言」と「気づけない文言」で、攻め方を変えたわけです。
あなたのゲームで「奥の画面にしか出ない文言」、どれくらいありますか?
罠その1:整形文字列は翻訳されない

最初にハマったのが、整形文字列です。
たとえば"[%s] %s" % [tag, name]のように、テンプレートに値を埋め込むコード。
この最終結果の文字列は、CSVのどのキーとも一致しません。
だからauto_translateがONでも、翻訳されず日本語のまま画面に出ます。
正解は、テンプレートと、埋め込むデータ名の両方をtr()することでした。
"[%s] %s" % [tr(tag), tr(name)]のように、部品ごとに翻訳してから組み立てる。
「文字列を組み立ててから翻訳」ではなく「翻訳してから組み立てる」。
この順番を逆にすると、一生バグります。
あなたのコードに、% [...]で組み立てている表示文字列、いくつありますか?
罠その2:複数行文字列も翻訳されない

次にハマったのが、"...\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で自分が溶かした「翻訳漏れの潰し方」を、コードと検出コマンドごと全部置いておきます。