Communitygithub.com

プレミアム3Dウェブサイト

カスタムWebGLシェーダー、ポストプロセス、物理ベースのインタラクション、スムーズなアニメーション、プリローダー、デバイス最適化に焦点を当てた、プレミアムな3Dウェブサイト構築のためのガイドラインです。

プレミアム3Dウェブサイト とは?

このスキルは、高品質な3Dウェブサイトを開発するためのアーキテクチャガイドラインとコードパターンを提供します。Three.js、React Three Fiber (R3F)、Splineといったライブラリを使用し、カスタムシェーダー(GLSL)による高度なWebGL視覚効果、ポストプロセスエフェクト(ブルーム、被写界深度、フィルムグレインなど)、物理演算に基づくインタラクション、没入感のあるページトランジションを実装する開発者を主な対象としています。このスキルは、レンダーループの確立、シェーダーとポストプロセスの実装、物理演算とモーションの統合、アセットパイプラインとプリローダーの最適化という4つのステップで構成されています。また、デバイスピクセル比の制限、アンチエイリアスの無効化、モデルの圧縮、インスタンスレンダリングの活用など、パフォーマンスを最大化するためのベストプラクティスも網羅しており、モバイルや高DPIディスプレイでもスムーズな動作を実現します。

対応✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/premium-3d-website

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プレミアム3Dウェブサイト は何をしますか?

概要

このスキルは、プレミアムでハイエンドな3Dウェブサイトを開発するためのアーキテクチャガイドラインとコードパターンを提供します。高度なWebGL視覚効果、カスタムシェーダーパイプライン、物理演算を活用したインタラクティブ要素、没入感のあるページトランジションを、高いパフォーマンスを維持しながら実装しようとする開発者を対象としています。

このスキルを使用すべき場合

  • 3D要素を備えたプレミアムまたは受賞歴のあるクリエイティブウェブサイトをデザインする場合。
  • Three.js、React Three Fiber (R3F)、またはSplineをカスタムシェーダー(GLSL)と組み合わせて統合する場合。
  • ブルーム、被写界深度、カスタムフィルムグレインなどのポストプロセスエフェクトを実装する場合。
  • インタラクティブなプリローダーと高性能なアセット読み込み戦略を設計する場合。
  • 複雑な3Dシーンをモバイル対応とパフォーマンスのために最適化する場合。

仕組み

ステップ1: レンダーループとシーンアーキテクチャの確立

適切なリサイズ処理とパフォーマンスに優れたピクセル比を備えた、堅牢なWebGLコンテキストをセットアップすることが重要です。高DPIスクリーンでピクセルをレンダリングしすぎないよう、ピクセル比は最大2に制限してください。

ステップ2: シェーダーエフェクトとポストプロセスの実装

ポストプロセッシングパイプライン(EffectComposer または @react-three/postprocessing を使用)を組み込み、ブルーム、色収差、被写界深度、フィルムグレインなどを追加します。パス数は低く抑え、カスタムフラグメントシェーダーを組み合わせてドローコールを最小化します。

ステップ3: インタラクティブな物理演算とモーションの統合

物理フレームワーク(Cannon.jsやRapierなど)またはプロシージャルなスプリングアニメーションを利用して、3Dオブジェクトがマウスホバー、ドラッグ、クリック入力に対して有機的なフィードバックで反応するようにします。

ステップ4: アセットパイプラインとプリローダー

3Dモデルを最適化(Draco圧縮を使用)し、カスタムローディングマネージャーを使用して読み込みます。バックグラウンドで重いアセットが取得されている間、ユーザーを楽しませるためのインタラクティブなプリローダーを表示します。

例

例1: React Three Fiber (R3F) でのカスタムポストプロセス

import { Canvas } from '@react-three/fiber';
import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';

export default function PremiumComposer() {
  return (
    <Canvas dpr={[1, 2]} gl={{ powerPreference: "high-performance", antialias: false }}>
      <ambientLight intensity={0.5} />
      <mesh>
        <boxGeometry />
        <meshStandardMaterial emissive="orange" emissiveIntensity={2.0} />
      </mesh>
      
      <EffectComposer disableNormalPass>
        <DepthOfField focusDistance={0} focalLength={0.02} bokehScale={2} height={480} />
        <Bloom luminanceThreshold={0.3} luminanceSmoothing={0.9} height={300} />
        <Vignette eskil={false} offset={0.1} darkness={1.1} />
      </EffectComposer>
    </Canvas>
  );
}

例2: 液体/波状エフェクトのためのカスタムGLSLシェーダーマテリアル

import * as THREE from 'three';

const CustomWavyMaterial = new THREE.ShaderMaterial({
  vertexShader: `
    varying vec2 vUv;
    uniform float uTime;
    void main() {
      vUv = uv;
      vec3 pos = position;
      pos.z += sin(pos.x * 5.0 + uTime) * 0.1;
      pos.z += cos(pos.y * 5.0 + uTime) * 0.1;
      gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
    }
  `,
  fragmentShader: `
    varying vec2 vUv;
    uniform float uTime;
    uniform vec3 uColor;
    void main() {
      float pulse = 0.5 + 0.5 * sin(uTime + vUv.x * 10.0);
      gl_FragColor = vec4(uColor * pulse, 1.0);
    }
  `,
  uniforms: {
    uTime: { value: 0.0 },
    uColor: { value: new THREE.Color('#3b82f6') }
  }
});

ベストプラクティス

  • ✅ dpr={[1, 2]} を設定して、デバイスピクセル比を最大2に制限する。
  • ✅ ポストプロセスがアクティブな場合は、WebGLRendererのアンチエイリアスを無効にして、二重アンチエイリアスによるパフォーマンス低下を防ぐ。
  • ✅ 動的なライトやリアルタイムシャドウを使用する代わりに、Blenderやその他の3Dソフトウェアを使用して、アンビエントオクルージョン、ライティング、シャドウをテクスチャにベイクする。
  • ✅ 複数の同一メッシュを含むシーンでは、インスタンスレンダリング(THREE.InstancedMesh またはR3Fの <Instances>)を使用する。
  • ❌ 圧縮されていないGLTF/OBJモデルの使用は避ける。DracoまたはMeshoptを使用してモデルを常に圧縮する。
  • ❌ モバイルまたはローエンドデバイスでは、パフォーマンスオーバーヘッドが大きいため、リアルタイムシャドウマップ(THREE.DirectionalLightShadow など)の使用を避ける。

制限事項

  • このスキルは、環境固有の検証、テスト、専門家によるレビューに代わるものではありません。
  • 必要な入力、権限、または安全上の境界が欠落している場合は、立ち止まって明確化を求めてください。
  • 複雑なシェーダー数学や高度な物理シミュレーションの境界は、異なるデバイスチップセット間での手動テストが必要です。

セキュリティと安全性に関する注意事項

  • 外部の3DモデルURL(GLTFLoader を介して読み込まれるもの)が、信頼できる安全なCDN(HTTPS)でホストされていることを確認してください。
  • アセットを最適化するために、任意の未検証のシェルスクリプトを実行したり、固定されていないNPMパッケージを使用したりしないでください。

よくある落とし穴

  • 問題: モバイルまたは高DPI(Retina)スクリーンでの深刻なラグ/フレームレート低下。 解決策: ピクセル比を2に制限し(renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2)))、未使用のポストプロセスパスを無効にします。
  • 問題: 初期化中の長い読み込み時間と白い画面。 解決策: ローディングマネージャー(THREE.LoadingManager)を使用し、ユーザーの関心を維持するために、レスポンシブでインタラクティブなプリローダーを表示します。

関連スキル

  • @3d-web-experience - コアとなるWebGL、Three.js、Splineの概念。
  • @scroll-experience - 3Dアニメーションとスクロールコントローラーの統合。
  • @performance-optimizer - 一般的なコード実行パフォーマンスのチューニング。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル