abyssal-garden — WebGPUで生成される96KBの海中探索デモ
Noniv/abyssal-garden
★ 1,086 ・ JavaScript ・ MIT
概要
abyssal-garden は、Webブラウザ上で海中世界を自由に泳ぎ回ることができるオープンソースの3Dグラフィックスデモです。画面上には、揺らめくケルプ(海藻)の森や水面から差し込む光線、沈没船、巨大なクジラの尾の石像、泳ぎ回るマンタや魚の群れなどが描かれます。
最大の特徴は、画像ファイルや3Dモデルデータ、音声ファイルなどの外部アセットを一切読み込まず、すべての要素をコードによる手続き型生成(プロシージャル)で構築している点です。全体がわずか96KBほどの単一HTMLファイルに収められています。ゲームエンジンなどの巨大なフレームワークを使わずに、WebGPUとWeb Audio APIを直接制御してリッチなリアルタイム描画や動的サウンド生成を行う手法に関心がある開発者に適した実装例です。
主な特徴
- 外部アセットなしで構築された単一HTML: 画像、3Dモデル、音声ファイルなどの外部メディアファイルを一切使わず、約96KBのHTMLファイル1つだけで動作します。
- ピュアWebGPUによる描画: Three.jsやBabylon.jsなどの既存3Dライブラリやゲームエンジンを使わず、WebGPU APIとWGSLシェーダーコードを直接操作して描画を行っています。
- Web Audio APIによるサウンドのリアルタイム合成: 海中の環境音、水泡の音、遠くのクジラの鳴き声、金属的なチャイムなどのサウンドスケープを、すべてWeb Audio APIを用いて実行時に動的合成しています。
- プロシージャルなワールド生成: ページを読み込むたびにGPU上で海底地形が彫刻され、数百万枚のケルプの葉、数万個の岩、数千個のサンゴや海綿、魚群が配置されます。
- ハードウェアに応じた自動チューニング: 目標フレームレート(60fps)を維持するため、解像度や描画距離を段階的に自動調整する負荷制御メカニズムが備わっています。
- キーボード・マウスおよびタッチ操作への対応: 移動や視点移動のほか、特定のビューポイントへの即時ジャンプや、描画負荷(Low / Medium / High)の手動切り替えに対応しています。
使い方
最も手軽に動かす方法
ビルド済みのHTMLファイルをそのまま開くだけで動作します。外部への通信を行わないため、オフラインでも利用可能です。
- リポジトリから
index.htmlをダウンロードします(または公開されているGitHub Pagesにアクセスします)。 - デスクトップ環境の Google Chrome または Microsoft Edge で
index.htmlを開きます。 - 数秒間のワールド構築処理を待った後、「Dive in」をクリックすると遊泳が開始されます。
WebGPUが有効でない環境では「This scene needs WebGPU」という警告メッセージが表示されます。その場合はブラウザを最新版に更新するか、WebGPUをサポートするブラウザに切り替える必要があります。
操作方法
PC環境での標準的な操作方法は次のとおりです。
| アクション | 操作 | 説明 |
|---|---|---|
| 視点移動 | マウス移動 | 周囲を見回します |
| 水平移動 | W, A, S, D |
前後左右に泳ぎます |
| 上昇 / 下降 | E / Q |
垂直方向に移動します |
| 加速 | Shift(長押し) |
より速く泳ぎます |
| 視点ジャンプ | 1 〜 6 |
設定された景勝ポイントへ瞬時に移動します |
| メニュー表示 | Esc |
マウスカーソルを解放し、設定メニューを開きます |
| 音声ミュート | M |
サウンドのオン/オフを切り替えます |
| パフォーマンス表示 | H |
統計情報を画面に表示します |
タッチスクリーン端末では、指1本を画面に置いてスライドすることで前進・操舵を行い、2本目の指を置くことで加速が可能です。
ソースコードからのビルド
ソースコードを改変して独自のHTMLファイルをビルドする場合は、Node.js 18以上が必要です。
cd source
npm install
npm run build
このコマンドを実行すると、リポジトリ直下に最適化された index.html が出力されます。デバッグ用に難読化・最小化を行わない状態で出力したい場合は、次のコマンドを利用します。
npm run build:readable
また、開発用の補助コマンドとして以下が用意されています。
npm run build:dev
これにより生成される dev.html では、キーボードの F キーでワールド全体を1分間かけて自動巡航するカメラパスを実行でき、B キーを押すことでその巡航を利用したフレームレートおよびGPU時間のベンチマーク計測が行えます。
技術的なポイント
ソースコードの構成
source/src/ 配下は機能ごとに分割されており、以下のような構成になっています。
world.js: 岩壁、アーチ、トンネル、ケルプの森、沈没船、クジラの尾などの空間配置を定義shaders.js: 水や霧の色、ライティング、水面の波、光線(コースティクス)などを定義するWGSLシェーダーコード群main.js: レンダラー本体、カメラ制御、操作入力、あらかじめ設定された6箇所の視点定義audio.js: Web Audio APIによる環境音のプロシージャル合成処理quality.js: デバイスに応じた詳細度レベルの判定および設定の永続化管理math.js: ノイズ生成、乱数、メッシュ構築のための数学的ヘルパー関数群dev.js: 自動飛行やベンチマークなど開発用の機能(dev.htmlでのみ利用)
描画パイプラインと形状生成
ポリゴンモデルやテクスチャ画像ファイルを外部から読み込む代わりに、すべてのオブジェクトが数式ベースで生成されます。沈没船やマンタ、サンゴ、魚などの立体物は、単純な幾何学形状の組み合わせとプロシージャルなノイズ計算によってモデリングされています。シェーダーにはWGSL(WebGPU Shading Language)が用いられており、水中の散乱光や水面の揺れに伴うコースティクス(集光模様)もシェーダー内でリアルタイムに計算されています。
動的なパフォーマンス調整
WebGPUの描画負荷は端末の性能に大きく左右されます。abyssal-garden では、起動時にデバイスのメモリ量や種類に応じて描画詳細度(High / Medium / Low)が選択されます。さらに、スタートメニューが表示されている待機状態(背景がぼかされている間)から裏側で描画負荷の計測を行い、60fpsを目標として解像度や草木・岩石の描画距離を段階的に落とすアルゴリズムが実装されています。万が一グラフィックスドライバのリセットやクラッシュが発生した場合は、自動的に一段階低い詳細度でリロードされます。
注意点
- ライセンス: MITライセンスで提供されています。商用利用、改変、再配布が許可されています。
- 動作環境: WebGPUのサポートが必須です。WebGPUが標準で利用可能になっている比較的新しいバージョンのデスクトップ向けChromeやEdgeでの利用が前提とされています。環境によってはフラグ設定が必要な場合や、古いGPUで正しく動作しない場合があります。
- モバイル・タッチ操作のサポート状況: スマートフォン等でのタッチ操作も実装されていますが、READMEにおいて「実験的(experimental)」と明記されています。端末のグラフィックス性能によってはフレームレートが低下することが示されています(READMEの記載例では、低価格帯スマートフォンのSamsung Galaxy A16・Low設定において約20fps)。
まとめ
abyssal-garden は、外部アセットを一切使わずにコードだけで豊かな海中環境を生成する、約96KBのWebGPUデモです。アセットレスでの3DモデリングやWGSLによる水・光の表現、Web Audio APIを組み合わせた空間演出など、次世代のWeb標準グラフィックス技術を活用した実践的なサンプルコードとして参考になります。





