godot · engine · tutorial

Godot ゲームを日本語化する方法

RuneTranslate は Godot 3.x / 4.x のゲームを翻訳します — .pck を開き(.exe に埋め込まれていても)、GDRE Tools で GDScript とシーンをデコンパイルし、UI とセリフを一覧します。エクスポートは .exe またはスタンドアロンの .pck に再パックします。ビルドが実行できるか検証してください。

6 分で読めます

RuneTranslate は Godot で作られたゲームの翻訳に対応しています — Godot は、インディーゲームを出荷する最も人気のある方法の 1 つに静かになった、無料のオープンソースエンジンです。Godot は歴史的に外部から翻訳するのが最も難しいエンジンの 1 つでした。リリースされた Godot ゲームは密閉された箱だからです:すべてが 1 つの .pck アーカイブ(しばしば .exe 自体の末尾に接着されている)にあり、スクリプトは GDScript バイトコードにコンパイルされ、シーンはバイナリで保存されています。RuneTranslate はその箱を開け、テキストを読み、あなたの翻訳をパックし直します。

Godot は多くのバージョンとパッケージ化スタイルにまたがるので、まず何よりも:RuneTranslate を Godot のゲームに向けて、検出しない、開かない、あるいはエクスポートしたコピーが実行できない場合は、ぜひ教えてください。詳しくは最後に。

Godot とは実際に何か

Godot は無料の MIT ライセンスのオープンソースゲームエンジンで、2D と 3D のインディーゲームの主流の選択肢となり、日本のインディータイトルでも出荷が増えている一角です。ゲームは通常 GDScript(Godot 独自の Python に似た言語)で書かれ、シーン — リソースとして保存されたノードのツリー — としてレイアウトされます。ゲームがエクスポートされると、そのすべて — スクリプト、シーン、画像、音声 — が 1 つの .pck パックファイルにまとめられ、実行ファイルの隣に置かれるか、非常に一般的には .exe 自体の末尾に付加されます。そのパッケージ化こそが、Godot ゲームを難攻不落に見せているものです。

なぜ Godot ゲームは翻訳が難しかったのか

Ren’Py のようなスクリプト駆動エンジンと違い、出荷された Godot ゲームはほとんど何もプレーンテキストで露出しません:

  • すべてが `.pck` の中にある。 編集するルーズなスクリプトやテキストファイルはなく — パックが .exe に埋め込まれている場合、ツールを向ける可視の .pck すら存在しません。
  • スクリプトはコンパイル済み。 GDScript はコンパイル済みバイトコード(.gdc)として出荷され — 現代の Godot 4 ではそのバイトコードはさらに圧縮されています — なので、コードに焼き込まれたセリフは grep したりテキストエディターで開いたりできるものではありません。
  • シーンはバイナリ。 UI ラベルやメニューテキストは、エディターで見る人間が読める .tscn ではなく、Godot のバイナリリソースフォーマット(.scn)で保存されたシーンファイルにあります。
  • すべてのゲームが翻訳ファイルを使うわけではない。 Godot には一級のローカライズシステム(CSV / .po → .translation)がありますが、多くのゲーム、特に小さなインディータイトルはそれを一切使わず、単にテキストをスクリプトとシーンにハードコードします。RuneTranslate は両方を読みます。ハードコードされた文字列(.gd、.tscn、.tres、.cfg、project.godot 内)と、コンパイル済みの CSV 翻訳テーブルで、後者はエクスポート時にその場で書き換えます。パック内の .po カタログはまだ読みません。

RuneTranslate が今できること

RuneTranslate は Godot を一級のエンジンとして扱い、読めるプロジェクトをあなたのために再構築します。内部では GDRE Tools(オープンソースの Godot リバースエンジニアリングツールキット)のコピーをバンドルし、次のことに使います:

  • `.pck` を展開 — スタンドアロン、data.pck、あるいは .exe の末尾に埋め込まれたパック(RuneTranslate が埋め込みパックの署名を自動検出します)。
  • コンパイル済み GDScript をデコンパイル(.gdc → .gd)して、コード内のセリフとナレーションを再び読める状態にします。
  • バイナリシーンを変換(.scn → .tscn)して、その上のラベルと UI テキストを取り出せるようにします。

その後、復元されたプロジェクトをスキャンし、すべての翻訳可能な文字列(スクリプトのセリフ、シーンの UI テキスト、翻訳テーブル、Dialogic と Dialogue Manager の会話、JSON データファイル)をファイルごとにグループ化してエディターに一覧し、エンジンのマークアップはプレースホルダーの背後にマスクされるので、プロバイダーがそれを壊すことはありません。エクスポート時に、あなたの翻訳を復元したソースにスプライスし、実行可能なゲームのコピーをパックし直します(正確な方法は後述)。

必要なもの

  • Windows / Linux 版 RuneTranslate — 無料。すべてのエンジンと、RuneLingua を除くすべてのプロバイダーが解放されています。
  • Godot のゲームフォルダ — 通常はゲームの .exe(パックが埋め込まれている)だけ、あるいは .exe とその隣の .pck / data.pck。Godot 3.x と 4.x の両方に対応します。
  • ターゲット言語 — 英語、スペイン語、フランス語、ドイツ語、ポルトガル語、ロシア語、中国語、イタリア語、トルコ語、ベトナム語、その他 20 以上。
  • 1 つの翻訳プロバイダー。無料の Google Translate はそのまま使えます。DeepL には無料ティアがあります。OpenAI、Anthropic、ローカルモデル(Ollama / LM Studio)、あらゆる OpenAI 互換 API は自分のキーを用意するタイプです。Godot のゲームはたいていセリフが多いので、ストーリーテキストには LLM(OpenAI / Anthropic)または DeepL が最もよく読めます。

ステップ 1: ゲームフォルダを開く

RuneTranslate を起動し、新規プロジェクト をクリックして、Godot のゲームディレクトリ — ゲームの .exe(別途出荷されるなら .pck も)があるフォルダ — に向けます。エンジン検出は自動的に実行されます:実行ファイル末尾の埋め込みパック署名、ルーズな .pck、あるいは Godot プロジェクトを認識します。元のファイルは決して変更されません。

ステップ 2: 展開してプロジェクトを復元

RuneTranslate はバンドルの GDRE Tools サイドカーを実行し、パックを展開し、コンパイル済み GDScript をデコンパイルし、バイナリシーンを読めるソースに変換します。その後、復元したプロジェクトをスキャンし、すべての翻訳可能な行(スクリプトのセリフとナレーション、シーンのラベルと UI テキスト、ゲームの翻訳テーブル、Dialogic と Dialogue Manager の会話、JSON データファイル)をファイルごとにグループ化して一覧します。アセットパス、ノード名、その他のコード識別子はフィルターされるので、プレイヤーが実際に目にする文字列だけを翻訳できます。

ステップ 3: 翻訳

プロバイダーを選んで実行します。ストーリー主導のゲームには、LLM(OpenAI / Anthropic) がキャラクターの声に最適で、DeepL はナレーションを高速かつクリーンに、無料の Google Translate は短い UI 文字列に十分です。Godot のゲームは、セリフを 1 つのスクリプト内の長い行の配列 — 「ストーリーデータベース」 — として保持することが多いので、同じキャラクターや地名が何百回も現れます。どこでも同一に表示されるよう、キャストとキーワードを事前に用語集化しましょう。用語集 101 を参照。AI リファイナー で任意のパスを実行すると、機械翻訳が残しがちな堅い言い回しを引き締めます。

ステップ 4: 翻訳済みビルドをエクスポート

エクスポート をクリックします。元のスクリプトがコンパイル済みバイトコードなので、RuneTranslate は ソースオーバーライド アプローチを使います:あなたの翻訳を復元した .gd / .tscn ソースに書き込み、コンパイル済み .gdc / バイナリ .scn を捨ててエンジンがルーズな翻訳済みソースにフォールバックするようにし、新しい .pck をパックし直し、ゲームがそれを置いている場所へ戻します:.exe のコピーに再埋め込みするか、隣に .pck として書き出します。元のゲームは手を加えられないままで、別の実行可能な翻訳済みコピーが手に入ります。

エクスポート範囲: エクスポートは、パックが .exe に埋め込まれているか、隣にスタンドアロンの .pck として出荷されているかを問わず、Godot 3 と Godot 4 のどちらのゲームでも機能します。どちらの場合も、別の、プレイ可能な翻訳済みコピーが手に入ります。

ステップ 5: コピーが実行できることを検証

エクスポートしたビルドは、Godot ランタイムが読み込み時にルーズな翻訳済みスクリプトソースをコンパイルすることに依存しているので、エクスポートしたゲームを一度起動し、共有する前にセリフとメニューがあなたの言語で表示されることを確認してください。スクリプトが読み込まれない場合、それこそが私たちの堅牢化に役立つ報告です(後述)。

既知の制限

  • 再配布する前に、エクスポートしたゲームが起動して正しく読めることを検証してください。
  • `.po` カタログ。 RuneTranslate はスクリプト、シーン、JSON データファイル、Dialogic と Dialogue Manager のファイル、コンパイル済みの CSV 翻訳テーブルにある原文言語のテキストを読みますが、パック内の .po カタログは読みません。
  • C# / .NET(Mono)ゲーム。 RuneTranslate は GDScript に注力します。C# の Godot ゲームのロジックにコンパイルされたテキストは、ゲームが自前の置き換え用ファイルから文字列を読み込む場合にのみ届きます。
  • 画像に描かれたテキスト。 アートワークとしてレンダリングされたタイトルやロゴはピクセルであって文字列ではありません — それは 画像テキスト翻訳 の仕事で、スクリプト抽出ではありません。
  • 非ラテンのターゲット言語は、ゲームが実際にそれをレンダリングできるフォントを出荷しているかどうかに依存します。

壊れたら教えてください

Godot は多くのエンジンバージョンとパッケージ化スタイルにまたがり、私たちがすべて見たわけではありません。ゲームが検出しない、展開しない、あるいは起動しないものをエクスポートした場合は、報告してください — ゲーム名、その Godot バージョン、パッケージ方法(埋め込みパックかルーズな .pck か)こそが、私たちが最速で堅牢化するのに役立ちます。

RuneTranslate をダウンロードし、ずっと読もうと思っていたあの Godot ゲームに向けて、試してみてください。別の現代的なエンジンについては、次に Unity ウォークスルー を参照してください。

RuneTranslate を試してみませんか?

無料プランですべてのエンジンとRuneLingua を除くすべての翻訳プロバイダーが使えます。Supporter(月額 $3.99)ならフルスピードで翻訳できます。

Windows / Mac / Linux 版をダウンロード