Skip to content
cccskills
FreePublished on GitHub

unity-webgl-builder

Unity プロジェクトの WebGL ビルドとローカルサーバー起動を一貫して行う。「WebGLビルド」「ブラウザビルド」「WebGL」「ローカルサーバー」「ビルドして」「デプロイ」「Build WebGL」といったリクエスト時に使用。

Editor スクリプト作成 → プラットフォーム切り替え → ビルド実行 → ローカル HTTP サーバー起動までを自動化する。

The English summary is being prepared. Showing the original description.

Works withUnity
See how to install

Files included (2)

  • SKILL.md4.2 KB
  • assets/WebGLBuilder.cs2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Unity WebGL Builder

Unity プロジェクトを WebGL ビルドし、ローカルサーバーで確認するまでの一連のフロー。

ワークフロー

Step 1: WebGL Build Support 確認

MCP ツールでコンソールを確認し、WebGL 関連のエラーがないかチェックする。

BuildTarget.WebGL が未サポートの場合、ユーザーに以下を案内:

WebGL Build Support モジュールが必要です:
1. Unity Hub → Installs → 対象バージョンの歯車 → Add modules
2. 「WebGL Build Support」にチェック → Install
3. Unity エディタを再起動

Step 2: Editor スクリプト作成

Assets/Scripts/Editor/WebGLBuilder.cs を作成する。サンプルは assets/WebGLBuilder.cs を参照。

要点:

  • Editor/ フォルダに配置(ビルドに含まれない)
  • [MenuItem("Tools/Switch to WebGL")] でプラットフォーム切り替え
  • [MenuItem("Tools/Build WebGL")] でビルド実行
  • 圧縮は無効化(WebGLCompressionFormat.Disabled)— ローカルサーバーとの互換性のため
  • シーンパスはプロジェクトに合わせて調整(デフォルト: Assets/Scenes/SampleScene.unity)
  • 出力先: Build/WebGL
// 圧縮無効化(Brotli は Python 簡易サーバーで非対応)
PlayerSettings.WebGL.compressionFormat = WebGLCompressionFormat.Disabled;
PlayerSettings.WebGL.decompressionFallback = false;

Step 3: ビルド前クリーンアップ

ビルド前に Build/WebGL/ 内の StatiCrypt 残留ファイルを確認・削除する。これらが残っていると Unity ビルドが index.html を正しく生成できない場合がある。

# 以下のファイル・フォルダがあれば削除
rm -f Build/WebGL/.staticrypt.json
rm -rf Build/WebGL/encrypted

既に HTTP サーバーが Build/WebGL で起動中の場合、ファイルがロックされて削除できないため、先にサーバーを停止すること。

Step 4: ビルド実行

MCP の execute_menu_item で順に実行:

  1. Tools/Switch to WebGL — プラットフォーム切り替え(初回のみ、数分かかる)
  2. Tools/Build WebGL — ビルド実行(2-5分)

ビルド完了後、コンソールで [WebGLBuilder] Build succeeded! を確認する。 Build target 'WebGL' not supported エラーが出た場合は Step 1 に戻る。

Step 5: ローカルサーバー起動

ビルド出力ディレクトリで HTTP サーバーを起動:

cd Build/WebGL && python -m http.server 8080

バックグラウンドで実行し、ユーザーに http://localhost:8080 を案内する。

Step 6(オプション): GitHub Pages にデプロイ

GitHub Pages への公開を希望する場合は、github-pages-deploy スキルを使用する。

サンプル

assets/WebGLBuilder.cs — 完全な Editor スクリプト。プラットフォーム切り替え・圧縮無効化・ビルド実行・結果レポートを含む。

トラブルシューティング

症状原因対処
Build target 'WebGL' not supportedWebGL モジュール未インストールUnity Hub で追加 + エディタ再起動
.br ファイルがブラウザで読めないBrotli 圧縮有効WebGLCompressionFormat.Disabled に設定して再ビルド
ビルド出力が空ビルド失敗コンソールのエラーログを確認
Build succeeded だが Size が 0 MBシーンパスが間違いscenes 配列のパスを確認
ブラウザでパスワードを求められるStatiCrypt の index.html が残留Build/WebGL を削除してクリーンビルド(HTTP サーバー停止が必要)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Unity カジュアルゲームを仕様駆動開発(Specification-Driven Development)で作成する。仕様を先に確定させ、設計・実装・テストを行うことで手戻りを最小化する。「ゲームを作って」「仕様駆動開発」「SDD」「ゲーム企画書」「機能仕様書」「技術仕様書」「テスト仕様書」「タスクリスト」「Unityゲーム開発」「カジュアルゲーム」といったリクエスト時に使用。Phase 1(企画書)からPhase 8(リリース)まで段階的にドキュメントを作成し、仕様に基づいて実装・テスト・検証を行う。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

ゲーム画面全てのスクリーンショットを撮影し、スクショとコードベースを分析して改善提案を行う。「レビュー」「改善提案」「ゲームレビュー」「スクショして改善」「画面チェック」「ビジュアルレビュー」「UI改善」「UX改善」「フィードバック」といったリクエスト時に使用。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

WebGL ビルド成果物を StatiCrypt で暗号化し、GitHub Pages にデプロイする。「デプロイ」「GitHub Pages」「公開して」「アップロード」といったリクエスト時に使用。パスワードは Build/ 内で管理し、リポジトリ作成からプッシュまでを自動化する。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity プロジェクト向けにプロシージャル音声(SE・BGM)を C# Editor スクリプトで生成する。「音声を生成」「SEを作って」「BGMを作って」「サウンドアセット」「AudioGenerator」「効果音」「プロシージャルオーディオ」といったリクエスト時に使用。WAV ファイル(44100Hz/16bit/Mono)を Assets フォルダに直接出力し、外部ツール不要で完結する。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity MCP を使った実装検証スキル。コンパイルエラー確認(L1)、Play Mode 動作確認(L2)、スクリーンショット目視確認(L3)の3段階で検証する。「検証して」「動作確認」「Play Mode で確認」「スクリーンショットで確認」「エラーチェック」といったリクエスト時、または他スキル(dev-game 等)から参照されて使用。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity MCPのセットアップと接続を行う。Unity EditorとClaude Codeの間でMCP接続を確立するための手順を実行する。「Unity MCP セットアップ」「MCP接続」「Unity MCP設定」「UnityMCP」「MCP For Unity」「MCPが繋がらない」「Unity Editorと接続」といったリクエスト時に使用。新規セットアップとトラブルシューティングの両方に対応。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

See all skills by umezy

Report a problem with this skill