Communitygithub.com

procedural-3d-mech-animator

에이전트가 '절차적 3D 메크 애니메이터'를 계획, 구축 또는 요약하는 방법을 안내하여 구체적인 산출물로 계획, 브리프 또는 체크리스트를 제공합니다. 절차는 절차적 3D 메크 애니메이터, 사용 시기, 1단계: 절차적 로프트 형상 및 컨포멀 UV 매핑을 거칩니다. 새로운 작업에 이 기술이 필요할 때 사용하세요.

procedural-3d-mech-animator란 무엇인가요?

이 스킬은 Three.js를 사용하여 외부 GLB 파일 없이 생산 수준의 절차적 3D 하드 서페이스 로봇과 메크를 생성하는 방법을 설명합니다. 컨포멀 UV 매핑, 인메모리 PBR 텍스처 생성, 해석적 2-본 역운동학(IK) 기반 제로 드리프트 풋 락, 그리고 다단계 전신 애니메이션을 포함합니다. 이 스킬은 정적 자산을 로드하지 않고 스쿼트, 런지, 전투 동작 및 댄스와 같은 복잡한 운동학적 애니메이션을 구현해야 하는 개발자에게 특히 유용합니다. SKILL.md는 다리 IK가 매 프레임마다 평가되는 계층적 관절 트리, 캔버스 기반 텍스처 생성을 위한 UV 매핑 전략, 그리고 예측과 충격을 갖춘 4단계 전투 패턴과 같이 역동적인 애니메이션을 위한 상세한 구현 단계를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/etofot/Robo-Blender-Academy/tree/HEAD/dreadnought-3d-ik-studio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

절차적 3D 메크 애니메이터

Three.js에서 컨포멀 UV 매핑, 절차적 인메모리 PBR 텍스처, 해석적 2-본 역운동학(제로 드리프트 풋 IK) 및 다단계 전신 애니메이션을 사용하여 프로덕션 등급의 단일 파일 또는 모듈식 3D 하드 서페이스 로봇과 메크를 구축합니다.

사용 시기

  • 외부 .glb 자산 없이 Three.js에서 절차적 3D 메크, 로봇, 워커 또는 하드 서페이스 차량을 생성할 때.
  • 스쿼트, 런지, 걷기, 춤 또는 전투 공격 중 발이 바닥에 고정되도록 해석적 2-본 역운동학(IK)을 구현할 때.
  • 예측, 운동 사슬 지연, 충격 충격파 및 회복을 포함하는 다단계 운동학적 전투 또는 이동 애니메이션을 설계할 때.
  • 외부 이미지 종속성 없이 토폴로지에 맞는 UV 좌표와 인메모리 THREE.CanvasTexture PBR 재질(용접선, 리벳, 가장자리 마모, 범프 맵, 스텐실)을 생성할 때.

1단계: 절차적 로프트 형상 및 컨포멀 UV 매핑

3D 캐릭터나 메크에 월드 공간 평면 UV 프로젝션을 사용하지 마십시오. 월드 공간 프로젝션은 패턴이 평평한 벽지나 관절에 늘어난 트레이닝복처럼 보이게 만듭니다. 항상 로프트 및 튜브 빌더 내부에서 직접 컨포멀 토폴로지 정렬 UV 좌표를 계산하십시오.

  • 단면 둘레 링 주위로 u(0.0 ~ 1.0)를 연속적으로 매개변수화합니다(i / nPts).
  • 하단 챔퍼에서 상단 챔퍼까지 세로 방향 로프트 슬라이스를 따라 v(0.0 ~ 1.0)를 매개변수화합니다(r / (numRings - 1)).
  • 엔드 캡 삼각형을 (0.5, 0.5) 주위에 방사형으로 매핑합니다.
function buildLoftGeometry(slices, capBot = true, capTop = true) {
  const numRings = slices.length;
  const nPts = slices[0].length;
  const positions = [];
  const uvs = [];

  for (let r = 0; r < numRings - 1; r++) {
    const v0 = r / (numRings - 1);
    const v1 = (r + 1) / (numRings - 1);
    for (let i = 0; i < nPts; i++) {
      const u0 = i / nPts;
      const u1 = (i + 1) / nPts;
      const p00 = slices[r][i];
      const p10 = slices[r][(i + 1) % nPts];
      const p01 = slices[r + 1][i];
      const p11 = slices[r + 1][(i + 1) % nPts];

      positions.push(...p00, ...p10, ...p11);
      uvs.push(u0, v0, u1, v0, u1, v1);

      positions.push(...p00, ...p11, ...p01);
      uvs.push(u0, v0, u1, v1, u0, v1);
    }
  }
  // capBot / capTop가 true이면 방사형 캡을 추가한 다음 computeVertexNormals()를 호출합니다.
  const geo = new THREE.BufferGeometry();
  geo.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
  geo.setAttribute('uv', new THREE.Float32BufferAttribute(uvs, 2));
  geo.computeVertexNormals();
  return geo;
}

2단계: HTML5 캔버스를 통한 인메모리 절차적 PBR 텍스처

HTML 파일을 비대하게 만들거나 변수 참조 누락 위험이 있는 멀티 메가바이트 Base64 문자열을 절대 포함하지 마십시오. 시작 시 HTML5 2D 캔버스와 THREE.CanvasTexture를 사용하여 알베도, 범프, 해저드, 데칼 및 실드 텍스처를 메모리에서 생성하십시오.

  • 컨포멀 이음새 정렬: 8면 챔퍼 블록(nPts = 8)의 경우 u = 0.0, 0.25, 0.50, 0.75에 세로 이음새 트렌치와 가장자리 마모 하이라이트를 배치합니다. 수평 챔퍼 이음새, 스캘럽 용접 비드 및 볼트 열을 v = 0.02..0.08(하단 경계) 및 v = 0.92..0.98(상단 경계) 근처에 배치합니다.
  • 3D 범프 릴리프: 범프 캔버스를 중성 #808080(128)으로 채우고 깊은 이음새 트렌치를 #181818으로, 융기된 용접 비드를 #dcdcdc로, 볼트 헤드를 #f5f5f5로 그리고 #1c1c1c 그림자 링과 함께 그립니다. THREE.MeshStandardMaterial에 bumpScale: 0.055 ~ 0.065를 설정합니다.

3단계: 관절형 피벗 보상 계층 구조

글로벌 모델 좌표에서 메시를 빌드할 때 각 신체 부위를 로컬 피벗 그룹으로 변환하여 회전이 해부학적 관절 중심 (px, py, pz) 주위에서 깔끔하게 발생하도록 합니다.

function createLocalPartGroup(name, pivotX, pivotY, pivotZ, parentGroup) {
  const joint = new THREE.Group();
  joint.name = name;
  joint.position.set(pivotX, pivotY, pivotZ);
  parentGroup.add(joint);

  const offsetGroup = new THREE.Group();
  offsetGroup.position.set(-pivotX, -pivotY, -pivotZ);
  joint.add(offsetGroup);
  return { joint, space: offsetGroup };
}

표준 메크 운동학 트리

  • root -> pelvis [0, 0.00, 0]
    • torso [0, 0.10, 0] (골반을 기준으로 회전)
      • sensorPod [0, 1.08, 0.42] (광학 장치가 목표물에 고정되도록 역회전)
      • hatchL / hatchR [±0.42, 1.44, -0.05] -> missilePodL / missilePodR
      • shoulderL [+0.98, 0.92, 0] -> armL -> elbowL [+1.26, 0.36, 0] (레일건 어셈블리)
      • shoulderR [-0.98, 0.92, 0] -> armR -> elbowR [-1.26, 0.36, 0] -> wristChuck -> claw1..3
    • legL [+0.54, -0.12, 0] -> kneeL [+0.62, -0.86, 0.12] -> ankleL [+0.66, -1.72, 0.02]
    • legR [-0.54, -0.12, 0] -> kneeR [-0.62, -0.86, 0.12] -> ankleR [-0.66, -1.72, 0.02]

4단계: 해석적 2-본 다리 IK 솔버 (제로 드리프트 풋 락)

골반 높이나 회전만을 정방향 운동학(FK)으로 애니메이션하면 발이 바닥을 뚫거나 부자연스럽게 미끄러집니다. 해석적 2-본 역운동학 솔버(solveLegIK)를 사용하여 다리를 항상 구동하십시오. 이 솔버는 골반 변환을 설정한 후 매 프레임 평가되어야 합니다.

  1. 강체 본 잠금: ankleJoint.position을 정강이 뼈의 정확한 끝 부분에 고정하여 발이 다리에서 분리되지 않도록 합니다.
  2. 월드-투-펠비스 타겟 변환: 원하는 월드 공간 발목 위치 targetWorldVec을 worldToLocal()을 사용하여 pelvis.children[0] 로컬 공간으로 변환합니다.
  3. 도달 거리 클램핑: 엉덩이 피벗 [sx * 0.54, -0.12, 0]에서 로컬 타겟까지의 거리 D를 측정합니다. 골반이 멀리 늘어날 때 다리가 NaN 오류 없이 부드럽게 확장되도록 D를 maxReach = L1 + L2 - 0.003으로 클램핑합니다.
  4. 무릎 굽힘을 위한 코사인 법칙:
    • 내부 무릎 각도 계산: cosB = clamp((L1*L1 + L2*L2 - D*D) / (2 * L1 * L2), -1, 1)
    • 무릎 X 회전 설정: kx = (Math.PI - Math.acos(cosB)) - REST_KNEE_OFFSET
  5. 쿼터니언 엉덩이 조준:
    • 회전하지 않은 정강이 벡터를 kx만큼 X축을 중심으로 회전하고, 허벅지 벡터를 더하여 _vHipToAnkleUnrot을 얻은 다음, _qAim.setFromUnitVectors(_vHipToAnkleUnrot.normalize(), _vTargetLocal.normalize())를 통해 로컬 타겟 방향 [dx, dy, dz]과 정렬합니다.
  6. 월드 공간 발 방향:
    • 상위 무릎 월드 쿼터니언 _qParentWorld를 계산하고, (footPitch, footYaw, footRoll)에서 원하는 월드 발 쿼터니언 _qDesiredFoot을 빌드한 다음, ankleJoint.quaternion.copy(_qParentWorld).invert().multiply(_qDesiredFoot)으로 설정하여 엉덩이/무릎 각도와 관계없이 발바닥이 바닥에 평평하게 유지되도록 합니다.

5단계: 전신 절차적 애니메이션 원리

단일 사지를 독립적으로 애니메이션하지 마십시오(로봇처럼 보이고 무게감이 없습니다). 모든 애니메이션은 전체 운동 사슬을 관여시켜야 합니다.

1. 4단계 전투 공격 패턴 (예: 발톱 강타 및 콤보 공격)

사이클 u in [0, 1]에 걸쳐 무거운 근접 또는 무기 애니메이션을 네 가지 개별 정규화된 단계로 나눕니다.

  • 1단계: 예측 및 코일 (0.00 - 0.42) :
    • 앞발을 호를 따라 내딛고(stepLift = Math.sin(stepU * Math.PI) * 0.28) 넓게 착지합니다.
    • 골반 무게를 후방 앵커 다리로 이동시키고 엉덩이와 몸통을 뒤로 감습니다(-70 deg 결합 요).
    • 머리/센서 포드를 역회전(+85 deg)시켜 눈이 목표물에 고정되도록 합니다.
    • 공격하는 어깨와 팔꿈치를 등 뒤로 높이 올리고, 반대쪽 팔을 균형추로 가슴을 가로질러 휘두르며, 손목 척을 회전시키고 발톱을 100% 벌립니다.
  • 2단계: 폭발적인 런지 및 채찍 (0.42 - 0.58) :
    • solveLegIK를 통해 두 발을 바닥에 고정하면서 골반을 앞으로(+0.62m Z) 그리고 아래로(-0.27m Y) 구동합니다.
    • 채찍 지연을 사용하여 운동 사슬을 순차적으로 진행합니다. 엉덩이가 먼저 앞으로 튀어 나가고(smoothstep(0.0, 0.85, u)), 몸통이 따라오며, 공격하는 팔은 넓은 바깥쪽 원호(Math.sin(armWhip * Math.PI))를 따라 비선형적으로(Math.pow(smoothstep(0.08, 1.0, u), 1.35)) 가속됩니다.
  • 3단계: 충격, 조임 및 히트스톱 (0.58 - 0.72) :
    • 충격 순간에 발톱을 닫습니다(clawVal = 0.05).
    • 절차적 카메라 흔들림, 방사형 충격파 링, 고주파 구조적 떨림(Math.sin(u * Math.PI * 10) * Math.exp(-u * 5)), 합성된 충격 오디오를 트리거합니다.
  • 4단계: 유압 회복 (0.72 - 1.00) :
    • 1.0 - smoothstep(0.0, 1.0, u)를 사용하여 앞발과 골반을 중립 자세로 부드럽게 되돌립니다.

2. 다중 동작 콤보 시퀀싱 (all_out_attack)

더 긴 타임라인(예: 10.0s 주기)에 걸쳐 여러 전투 단계를 연결합니다.

  • A단계 (0.00 - 0.24): 전방 런지와 스파크 버스트를 동반한 무거운 발톱 강타.
  • B단계 (0.24 - 0.50): 몸통 스냅 조준, 트윈 레일건 반동(armL이 총열 축을 따라 뒤로 밀리며 몸통이 반동 충격으로 비틀림), 고속 발사체 볼트 생성.
  • C단계 (0.50 - 0.78): 버팀 자세, 지붕 미사일 해치 열기(setHatchState(1)), 발사대 포드 상승, 연기 흔적을 남기는 아치형 탄도 미사일의 엇갈린 일제 사격.
  • D단계 (0.78 - 1.00): 시스템 냉각 중 육각형 플라즈마 돔 실드 활성화(rig.shieldDome.visible = true) 및 맥동 충격파.

3. 로코모션 및 댄스 역학

  • 무거운 걷기 / 달리기: 반대 위상 오프셋 사용(phaseL = cycle * 2 * Math.PI, phaseR = phaseL + Math.PI). Math.sin(phase) > 0일 때만 흔드는 발을 들어 올리고, 골반 측면 흔들림(cos(phase))을 지지하는 다리 위로 이동시키고, 팔을 반대로 흔듭니다(armL은 legR과 함께 움직임).
  • 댄스 그루브: solveLegIK를 통해 두 발을 바닥에 고정하면서 리드미컬한 8자 엉덩이 흔들기, 두 배 빠른 무릎 바운스(Math.abs(Math.sin(beat * 2))), 번갈아 가며 어깨를 튕기기, 회전하는 발톱 묘기를 구동합니다.

검증 체크리스트

  1. 생성된 스크립트에서 구문 유효성 검사를 실행합니다(node -e "new Function(code)"). 구문 오류나 선언되지 않은 변수 오류가 없는지 확인합니다.
  2. evaluateAnimation(t, dt) 끝에서 solveLegIK('L', ...) 및 solveLegIK('R', ...)가 모든 골반 위치/회전 업데이트 후에 호출되는지 확인합니다.
  3. HTML에 최상위 window.onerror 진단 배너를 포함하여 런타임 오류가 발생하면 즉시 화면에 표시되도록 합니다.

관련 스킬