【Godot】HTML5へのエクスポート手順

Godot

この記事では HTML5 (Web版) へのエクスポート手順について説明をします。

HTML5へのエクスポート手順

エクスポート設定の追加

メニューから「プロジェクト > エクスポート」を選びます。

エクスポート設定から「追加 > HTML5」を選びます。

エクスポートテンプレートのダウンロード

※Steam版のGodotをインストールした場合、自動でエクポートテンプレートが追加されるので、以下の手順は不要です。

するとプリセットは追加されるのですが、いくつかエラーが出ています。「エクスポートテンプレートの管理」をクリックします。

エクスポートテンプレート.マネージャーが表示されるので、「ダウンロードしてインストール」をクリックします。

通信環境にもよりますが、ダウンロードにしばらく時間がかかるので待ちます…（※私の場合はタイミングが悪かったのか1時間以上かかりました)

インストールが完了したら「閉じる」ボタンで閉じます。

エクスポート先を設定して出力する

もう一度メニューからエクスポートの設定（プロジェクト > エクスポート) を開きます。そして「エクスポート先のパス」のファイルアイコンをクリックします。

出力フォルダとファイル名を指定します。エクスポートすると複数のファイルが出力されるので、専用のフォルダを新規作成して空のフォルダに出力しておいたほうがよいです。

それとファイル名は「index.html」にしてのがおすすめです。(URLがフォルダ指定で実行可能となるため)

エクスポートパスを設定したら「プロジェクトのエクスポート」をクリックします。

出力ダイアログで「保存」で出力します。

するとHTML5で実行するために必要なファイルが出力されます。

これらを FTPツールなどでサーバーへアップロードすると Webブラウザから実行できるようになります。

補足

HTML5での動作の制限

HTML5での動作にはいくつか制限があるようなので注意が必要です。

 

  • サーバーへアップロードしないと動作確認できない
  • スレッドは動作しない
  • GDNative と C# はHTML5では動作しない
  • エンジンとオペレーティングシステム間のクリップボード同期 はできない
  • class_HTTPClient および class_WebSocketClient 以外のネットワーク処理は利用できない
  • ゲームパッドでの入力は受け付けない
  • print() / print_debug() の出力はブラウザの開発者コンソール上に表示される
  • ローカルファイルへの保存は JavaScript.download_buffer() を使用する必要がある

2025.8.17 追記：HTTPS (SSL対応) したサーバーのみアップロードが可能

v4.2あたりから HTTPサーバー (非セキュア) の実行ができなくなりました。HTTPサーバーにアップロードして実行すると以下のエラーとなります。

そのためサーバー側でSSLの設定をする必要があります。(※以下はさくらインターネットの設定)

2025.8.17 追記：HTML5でのみフォントが正しく表示されない場合の対処法

過去のプロジェクトファイルを最新バージョンに変換したときに Thema の設定がおかしくなってフォントが正常に表示されないことがあります。

その場合は、Themaファイルを開いて Default Fontの設定をやり直すことで解消される可能性があります。

参考