Communitygithub.com

Premium-3D-Website

Richtlinien für die Erstellung hochwertiger 3D-Websites mit Fokus auf benutzerdefinierte WebGL-Shader, Post-Processing, physikbasierte Interaktionen, flüssige Animationen, Preloader und Geräteoptimierung.

Was ist Premium-3D-Website?

Diese Fertigkeit bietet Richtlinien und Code-Muster für die Entwicklung von Premium-3D-Websites mit hohem Qualitätsanspruch. Sie richtet sich an Entwickler, die fortschrittliche WebGL-Visualeffekte, benutzerdefinierte Shader-Pipelines, interaktive Physikelemente und immersive Seitenübergänge implementieren möchten, während eine hohe Leistung erhalten bleibt. Die Fertigkeit unterstützt Frameworks wie Three.js, React Three Fiber (R3F) und Spline und deckt die Integration von Post-Processing-Effekten (Bloom, Depth-of-Field, Filmkorn), die Nutzung von Physik-Engines (Cannon.js, Rapier) sowie die Optimierung von 3D-Assets mit Draco-Kompression ab. Sie enthält detaillierte Implementierungsschritte, Codebeispiele für R3F und benutzerdefinierte GLSL-Shader sowie Best Practices zur Leistungsoptimierung auf mobilen und hochauflösenden Bildschirmen. Einschränkungen umfassen die Notwendigkeit manueller Tests auf verschiedenen Geräten und die Abhängigkeit von vertrauenswürdigen CDNs für externe Modelle.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Premium-3D-Website?

Überblick

Diese Fertigkeit bietet architektonische Richtlinien und Code-Muster für die Entwicklung hochwertiger 3D-Websites. Sie richtet sich an Entwickler, die fortschrittliche WebGL-Visualeffekte, benutzerdefinierte Shader-Pipelines, interaktive Physikelemente und immersive Seitenübergänge implementieren möchten, während eine hohe Leistung erhalten bleibt.

Wann diese Fertigkeit verwenden

  • Verwenden Sie diese Fertigkeit beim Entwerfen von Premium- oder preisgekrönten kreativen Websites mit 3D-Elementen.
  • Verwenden Sie sie bei der Integration von Three.js, React Three Fiber (R3F) oder Spline mit benutzerdefinierten Shadern (GLSL).
  • Verwenden Sie sie bei der Implementierung von Post-Processing-Effekten wie Bloom, Tiefenschärfe oder benutzerdefiniertem Filmkorn.
  • Verwenden Sie sie beim Entwerfen interaktiver Preloader und leistungsstarker Asset-Ladestrategien.
  • Verwenden Sie sie bei der Optimierung komplexer 3D-Szenen für mobile Reaktionsfähigkeit und Leistung.

Funktionsweise

Schritt 1: Render-Loop und Szenenarchitektur einrichten

Die Einrichtung eines robusten WebGL-Kontexts mit korrekter Größenänderungsbehandlung und leistungsfreundlichen Pixelverhältnissen ist entscheidend. Begrenzen Sie das Pixelverhältnis auf maximal 2, um auf hochauflösenden Bildschirmen nicht zu viele Pixel zu rendern.

Schritt 2: Shader-Effekte und Post-Processing implementieren

Integrieren Sie Post-Processing-Pipelines (mit EffectComposer oder @react-three/postprocessing), um Bloom, chromatische Aberration, Tiefenschärfe oder Filmkorn hinzuzufügen. Halten Sie die Pass-Anzahl niedrig und kombinieren Sie benutzerdefinierte Fragment-Shader, um Draw-Aufrufe zu minimieren.

Schritt 3: Interaktive Physik und Bewegung integrieren

Nutzen Sie Physik-Frameworks (wie Cannon.js oder Rapier) oder prozedurale Federanimationen, um 3D-Objekte mit organischem Feedback auf Maus-Hover, Drag- und Klick-Eingaben reagieren zu lassen.

Schritt 4: Asset-Pipeline und Preloader

Optimieren Sie 3D-Modelle (mit Draco-Kompression) und laden Sie diese mit benutzerdefinierten Loading-Managern. Zeigen Sie interaktive Preloader an, um Benutzer zu unterhalten, während schwere Assets im Hintergrund geladen werden.

Beispiele

Beispiel 1: Benutzerdefiniertes Post-Processing in 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>
  );
}

Beispiel 2: Benutzerdefiniertes GLSL-Shader-Material für flüssige/wellige Effekte

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') }
  }
});

Best Practices

  • ✅ Setzen Sie dpr={[1, 2]} um das Geräte-Pixelverhältnis auf maximal 2 zu begrenzen.
  • ✅ Deaktivieren Sie Antialiasing im WebGLRenderer, wenn Post-Processing aktiv ist, um Doppel-Antialiasing-Leistungseinbußen zu vermeiden.
  • ✅ Backen Sie Umgebungsverdeckung, Beleuchtung und Schatten mit Blender oder anderer 3D-Software in Texturen, anstatt dynamische Lichter und Echtzeitschatten zu verwenden.
  • ✅ Verwenden Sie Instanz-Rendering (THREE.InstancedMesh oder R3F <Instances>) für Szenen mit mehreren identischen Meshes.
  • ❌ Vermeiden Sie unkomprimierte GLTF/OBJ-Modelle. Komprimieren Sie Modelle immer mit Draco oder Meshopt.
  • ❌ Vermeiden Sie Echtzeit-Schattenkarten (wie THREE.DirectionalLightShadow) auf mobilen oder leistungsschwachen Geräten aufgrund des hohen Leistungsaufwands.

Einschränkungen

  • Diese Fertigkeit ersetzt keine umgebungsspezifische Validierung, Tests oder Expertenprüfung.
  • Stoppen Sie und fragen Sie nach, wenn erforderliche Eingaben, Berechtigungen oder Sicherheitsgrenzen fehlen.
  • Komplexe Shader-Mathematik und erweiterte Physiksimulationsgrenzen erfordern manuelle Tests auf verschiedenen Geräte-Chipsätzen.

Sicherheitshinweise

  • Überprüfen Sie, ob externe 3D-Modell-URLs (geladen über GLTFLoader) auf vertrauenswürdigen, sicheren CDNs (HTTPS) gehostet werden.
  • Führen Sie keine willkürlichen, nicht validierten Shell-Skripte aus und verwenden Sie keine nicht fixierten NPM-Pakete zur Optimierung von Assets.

Häufige Fallstricke

  • Problem: Starke Verzögerung / niedrige Bildrate auf mobilen oder hochauflösenden (Retina) Bildschirmen. Lösung: Stellen Sie sicher, dass das Pixelverhältnis auf 2 begrenzt ist (renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))) und deaktivieren Sie nicht verwendete Post-Processing-Pässe.
  • Problem: Lange Ladezeiten und weiße Bildschirme während der Initialisierung. Lösung: Verwenden Sie einen Loading-Manager (THREE.LoadingManager) und zeigen Sie einen reaktionsschnellen, interaktiven Preloader an, um den Benutzer bei der Stange zu halten.

Verwandte Fertigkeiten

  • @3d-web-experience - Grundlegende WebGL-, Three.js- und Spline-Konzepte.
  • @scroll-experience - Integration von 3D-Animation mit Scroll-Controllern.
  • @performance-optimizer - Allgemeine Leistungsoptimierung von Codeausführung.

Individual skills in this repo

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

Verwandte Skills