GodotからWeb版を書き出し、ローカルで起動できても、そのまま既存サイトへ載せられるとは限りませんでした。今回、Cloudflare Pagesへゲームを組み込むときに分けて対応したのは、CSPによる実行制限と、WASMの1ファイル当たりの大きさです。
対象は、制作中の玩具風3Dゲーム「TOYBOX OVERDRIVE」です。2026年10月のGodot 4.7.2の書き出しを、anikuma.app内のゲーム用パスへ配布しました。配布先では、JavaScriptの文字列evalやインラインスクリプトを許可しない方針を使っています。
この記事はGodotのWeb書き出し全体の入門ではありません。既に起動する配布物を、既存サイトの制約へ合わせた記録です。ゲーム開始時の準備による停止については、別の記事で扱っています。
起動しない原因を、三つの段階に分ける
最初に区別したいのは、ファイルを置けないのか、置けても読み込めないのか、読み込んだ後の実行で止まるのかです。
| 段階 | 最初に確認するもの |
|---|---|
| アップロード | 各ファイルの容量、配布先の上限 |
| 読み込み | 参照パス、HTTP応答、MIME、欠落ファイル |
| 実行 | コンソールのCSP違反、JavaScript連携、起動処理 |
ローカルの開発サーバーには、本番と同じCSPが付いていない場合があります。また、ローカルのファイル配信では通っても、ホスティング側の単体ファイル上限には引っ掛かります。ゲームの描画処理を直し始める前に、どの段階で止まるかを確認しました。
読み込み画面のJavaScriptとCSSを外へ出した
CSPは、ページがどこから何を読み込み、どの方法で実行できるかを制限する仕組みです。JavaScriptでは、同じドメインの外部ファイルを許可することと、HTML内のインラインコードや文字列evalを許可することは別です。MDNのscript-srcの説明で、それぞれの扱いを確認できます。
今回の配布では、読み込み画面の起動処理を外部JavaScriptへ、表示の指定を外部CSSへ移しました。HTMLは設定値と必要な要素を持ち、起動用ファイルがその設定を読んでゲームを開始します。梱包処理では、今回の出力HTMLに使っていた<script>と<styleの文字列が残っていれば停止します。任意のHTMLに対する網羅的なCSP検査ではなく、対象テンプレートの残存確認です。
設定値はJSONとして置き、JSON.parseで読み取ります。文字列をコードとして実行するためのものにはしません。なお、JSONを載せる非実行のscript要素と、JavaScriptを直接書くscript要素は目的が違うため、実行可能なコードが残っていないかを区別して確認します。
Godot側のevalも、オブジェクト経由の連携に変えた
HTMLを整理しても、ゲームからページへ通知する処理にevalが残っていれば、そこで止まる可能性があります。今回の実装では、保存できない場合の注意表示と、準備完了の通知を見直しました。
GodotのJavaScriptBridge.get_interfaceからdocumentやwindowを取得し、対応するオブジェクトのメソッドを呼ぶ形です。以下は、準備完了イベントを通知する部分を短くした例です。
var page_window: JavaScriptObject = JavaScriptBridge.get_interface("window")
var ready_event: JavaScriptObject = JavaScriptBridge.create_object("Event", "toybox-ready")
page_window.dispatchEvent(ready_event)
ページ側はこのイベントを受け取り、ゲームエンジンの起動も終わっていることを確認してから読み込み画面を外します。イベントだけ、あるいはエンジンの起動完了だけで表示を切り替えないよう、二つの状態を持たせています。
evalとget_interfaceの役割は、GodotのJavaScriptBridge公式リファレンスに記載されています。これは今回使ったWeb版の連携方法であり、あらゆる書き出し設定やプラグインにそのまま適用できるという意味ではありません。
また、JavaScriptのevalを使わないことと、WebAssemblyの実行を許可しないことも別です。今回の配布設定はwasm-unsafe-evalを使ってWASMの実行を許可し、JavaScript用のunsafe-evalは追加していません。この違いを混同してWASMまで拒否すると、ゲーム自体を起動できなくなります。
WASMは配布時に分割し、読み込み時に戻した
もう一つの問題はファイル容量です。2026年10月28日に確認したCloudflare Pagesの上限では、静的アセット1ファイルの最大サイズは25 MiBです。サイト全体の容量やZIPの圧縮後サイズとは区別します。
今回のWASMはそのままの単体配布では上限に収まらないため、梱包時に20 MiBずつへ分割しました。これは画像やゲーム内容を圧縮する処理ではなく、同じバイト列を複数のファイルへ切り分ける処理です。
梱包処理では、次をまとめて生成・検査します。
- 分割ファイルの順序を記録したJSON
- 元のWASMの合計バイト数とSHA-256
- 内容のハッシュの一部を含む分割ファイル名
- 全配布ファイルが単体上限以内であること
- 分割した順に連結すると元のWASMと完全一致すること
内容が変わったらファイル名も変えるのは、以前の分割片をキャッシュから混ぜないためです。順序だけ正しくても、中身の世代が違えば壊れます。
ブラウザ側では、エンジンがWASMを要求したときに分割一覧を読み、順番どおりに取得したデータをReadableStreamへ流して、一つのWASM応答として渡しています。その応答のMIMEはapplication/wasmです。各分割片の取得に失敗したら、ストリームも失敗として止めます。
今回の実装(2026年10月時点)でSHA-256を使うのは梱包時の記録とファイル名です。ブラウザ側で全体のハッシュを再計算して照合する機能までは入れていません。分割一覧をハッシュ付きにしただけで、配信中の完全性検証まで済んだとは扱わないようにしています。
分割しても、ダウンロード量は減らない
この対応で解消するのは、今回の配布先にある単体ファイルの制約です。分割前と同じデータを取得するので、ゲームが小さくなったわけではありません。ロード時間が短くなるとも限らず、通信環境やブラウザのメモリ使用量は別に確認する必要があります。
梱包物にはWASMだけでなく、ゲームデータ、エンジンのJavaScript、音声worklet、起動用JS/CSS、アイコン、フォントライセンスも含めます。HTML一枚をアップロードして成功とせず、実際の参照先がそろっているかを確認しました。
一つの巨大ファイルを置ける別の保管先を使う方法も考えられます。今回は既存サイト内で配布する前提だったので、ゲーム本体と分けた梱包処理とローダーで対応しました。この方法が、別の構成でも最も簡単になるとは限りません。
公開前は、本番に近い条件で起動を確認する
今回の公開では、配布時のファイル制約を検査したうえで、HTTPSの配布先で起動を確認しました。手元で次に確認するなら、次の順が分かりやすくなります。
- 書き出したファイル一覧と単体サイズを確認する。
- 本番と同じヘッダーで、インラインコードとevalの依存を確認する。
- 起動用ファイル、WASM、ゲームデータ、workletの応答を確認する。
- ゲーム開始と、準備完了の通知まで進むことを確認する。
- 画面幅の検査と、実際に遊ぶ端末での性能確認を分けて残す。
Chromeでの起動確認は、iPhoneやAndroid実機で快適に遊べることの証明にはなりません。今回の記事で扱ったのは、配布サイズとCSPへ合わせて起動経路を通すところまでです。
Web版を書き出した後に詰まったら、ゲーム内の処理、ブラウザの実行制限、ホスティングの配布制限を一つの「起動しない」にまとめず、段階ごとに確認してみてください。今回も、その切り分けが修正箇所を絞る手掛かりになりました。



