Communitygithub.com

프리미엄 3D 웹사이트

커스텀 WebGL 셰이더, 후처리, 물리 기반 상호작용, 부드러운 애니메이션, 프리로더 및 기기 최적화에 중점을 둔 프리미엄 3D 웹사이트 구축 가이드라인입니다.

프리미엄 3D 웹사이트란 무엇인가요?

이 스킬은 프리미엄 고급 3D 웹사이트 개발을 위한 아키텍처 가이드라인과 코드 패턴을 제공합니다. Three.js, React Three Fiber (R3F), Spline을 사용하여 커스텀 셰이더(GLSL)와 블룸, 피사계 심도, 필름 그레인 같은 후처리 효과를 통합하는 개발자를 대상으로 합니다. 물리 기반 상호작용(Cannon.js 또는 Rapier)과 절차적 스프링 애니메이션을 통해 마우스 호버, 드래그, 클릭에 반응하는 유기적인 3D 객체를 구현합니다. 또한 Draco 압축을 통한 3D 모델 최적화, 로딩 관리자와 인터랙티브 프리로더를 활용한 에셋 로딩 전략, 모바일 기기와 고해상도 디스플레이에서의 성능 최적화 방법을 상세히 다룹니다. 이 스킬은 최신 브라우저를 지원하는 모든 WebGL 기반 플랫폼에서 활용 가능합니다.

지원 대상✓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 컨텍스트를 설정하는 것이 중요합니다. 픽셀 비율은 최대 2로 제한하여 고DPI 화면에서 너무 많은 픽셀을 렌더링하지 않도록 합니다.

2단계: 셰이더 효과 및 후처리 구현

EffectComposer 또는 @react-three/postprocessing을 사용하여 블룸, 색수차, 피사계 심도, 필름 그레인을 추가하는 후처리 파이프라인을 통합합니다. 패스 수를 낮게 유지하고 커스텀 프래그먼트 셰이더를 결합하여 드로우 콜을 최소화합니다.

3단계: 인터랙티브 물리 및 모션 통합

Cannon.js 또는 Rapier 같은 물리 프레임워크나 절차적 스프링 애니메이션을 활용하여 3D 객체가 마우스 호버, 드래그, 클릭 입력에 유기적인 피드백으로 반응하게 만듭니다.

4단계: 에셋 파이프라인 및 프리로더

Draco 압축을 사용하여 3D 모델을 최적화하고 커스텀 로딩 관리자로 로드합니다. 무거운 에셋이 백그라운드에서 가져오는 동안 사용자를 즐겁게 하기 위해 인터랙티브 프리로더를 렌더링합니다.

예제

예제 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(레티나) 화면에서 심각한 지연/프레임률 저하. 해결 방법: 픽셀 비율을 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.

관련 스킬