Aqua — 3Dアクアリウムを公開しました - 開発ログ
作ったもの

ブラウザを開くだけで、ずっと眺めていられる3Dのアクアリウム。淡水の水草レイアウト水槽と、 海水のサンゴ礁水槽を切り替えられる。泳いでいるのはすべて実在の熱帯魚で、カージナルテトラや ディスカス、カクレクマノミ、ナンヨウハギなど25種。魚・水草・石・サンゴは画像や3Dモデルの 素材を一切使わず、すべてコードで生成している。
主な機能
- 淡水(石組み+流木+水草)と海水(ライブロック+サンゴ)の2つの水槽をフェードで切り替え
- 実在の熱帯魚25種が群れを作って泳ぐ。群れる・大きな魚を避ける・底にとどまる・ イソギンチャクに寄り添うなど、種ごとの習性を再現
- 水面から差し込む光の柱、水底で揺れる光の網目、深いほど青く沈む透明な水
- PCの横長画面とスマホの縦長画面の両方に最適化。UIは操作しないと自動で消える
- 重い端末では起動時に解像度を自動調整
使用技術
- Three.js(WebGL)+ Vite
- 自作シェーダー(泳ぎのうねり、水草の揺れ、コースティクス、水中の光の柱)
- ボイド(群れのシミュレーション)
- Cloudflare Pages + GitHub
- Claude Code と一緒に開発
開発時の工夫
魚は種ごとに体の断面・ヒレの形・模様をパラメータで定義し、体色はキャンバスに描いたテクスチャで 表現した。泳ぐときの体のうねりはシェーダーで計算しているので、150匹以上が同時に泳いでも軽い。
いちばん苦労したのは「水の美しさ」。最初は遠くのものに乳白色の霞をかけていたが、どうしても水が 白く濁って見えた。本物の水は赤い光から順に吸収されることに着目し、色ごとに吸収の強さを変える 方式に置き換えたところ、遠景が白ではなくエメラルドや青に沈むようになり、一気に透き通った。 水底の光の網目も、ぼやけた模様から、細胞状の境界線を波で歪ませた細く明るい線に作り直した。
光の柱は、画面上で放射状にぼかす手法を最初に試したが、全体が霞むだけでうまくいかなかった。 視線に沿って水中を少しずつ進みながら水面からの光を積み上げる方式(レイマーチ)に切り替え、 シーンの奥行き情報も使うことで、手前の岩や魚に光が重ならない自然な柱になった。
公開前には「数秒おきに画面がちらつく」不具合にも遭遇した。原因は、重いときに解像度を自動で 下げる処理そのもので、描画バッファを作り直す瞬間に画面が欠けていた。起動時のフェード中に 一度だけ計測して決める方式に変えて解決した。
今後の改善
- 岩や水草が光を遮って、光の柱に影の筋ができる表現
- 魚をタップすると名前が出るモード(任意でON)
- 水草の量を端末性能に合わせて自動調整