Communitygithub.com

プロシージャル3Dメックアニメーター

エージェントが「プロシージャル3Dメックアニメーター」を計画、構築、またはカットする方法を示し、具体的な出力は計画、概要、またはチェックリストです。この手順は、プロシージャル3Dメックアニメーター、使用するタイミング、ステップ1:プロシージャルロフトジオメトリとコンフォーマルUVマッピングを順に進めます。新しいタスクでこの技術が求められる場合に使用します。

プロシージャル3Dメックアニメーター とは?

このスキルは、外部の3Dアセットに依存せず、Three.jsを使用してプロシージャルに3Dメック、ロボット、またはハードサーフェス車両を構築するための完全なガイドです。コンフォーマルUVマッピング、メモリ内のプロシージャルPBRテクスチャ(溶接跡、リベット、エッジの摩耗など)、および解析的2ボーン逆運動学(IK)によるゼロドリフトフットロックを実装する方法を詳細に説明します。さらに、多相の全身アニメーション(戦闘打撃、連続攻撃、歩行、ダンスなど)の原理を、アンチシペーション、キネティックチェーンラグ、インパクトエフェクトを含めて解説します。Claude Code、Cursor、CodexなどのAIエージェントにとって、プロシージャルジオメトリ生成、UVマッピング、マテリアル作成、IKソルバー、アニメーションシステムを1つのファイルまたはモジュール式で統合するための実践的なリファレンスとなります。

対応~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を使用して、プロダクショングレードのシングルファイルまたはモジュール式の3Dハードサーフェスロボットやメックを構築します。コンフォーマルUVマッピング、プロシージャルなインメモリPBRテクスチャ、解析的2ボーン逆運動学(ゼロドリフトフットIK)、および多相の全身アニメーションを備えています。

使用するタイミング

  • 外部の .glb アセットを使用せずに、Three.jsでプロシージャルな3Dメック、ロボット、ウォーカー、またはハードサーフェス車両を作成する場合。
  • 解析的2ボーン逆運動学(IK)を実装し、スクワット、ランジ、歩行、ダンス、または戦闘攻撃中に足を地面に固定したままにする場合。
  • アンチシペーション、キネティックチェーンラグ、衝撃衝撃波、および回復を伴う多相のキネティック戦闘または移動アニメーションを設計する場合。
  • トポロジーに適合するUV座標と、外部画像依存関係なしにインメモリ THREE.CanvasTexture PBRマテリアル(溶接跡、リベット、エッジ摩耗、バンプマップ、ステンシル)を生成する場合。

ステップ1:プロシージャルロフトジオメトリとコンフォーマルUVマッピング

3Dキャラクターやメックにワールド空間の平面UV投影を使用しないでください。ワールド空間投影では、パターンが平らな壁紙や関節に張られたジャージのように見えるからです。ロフトおよびチューブビルダー内で トポロジーに沿ったコンフォーマルUV座標 を直接計算します。

  • 断面の周囲リング(i / nPts)に沿って u(0.0 から 1.0)を連続的にパラメータ化します。
  • 下部面取りから上部面取りまでの縦方向のロフトスライスに沿って 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 Canvasを使用したインメモリプロシージャルPBRテクスチャ

HTMLファイルを肥大化させたり、変数参照を見逃したりするマルチメガバイトのBase64文字列を埋め込まないでください。HTML5 2D Canvasと 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. クォータニオンによる股関節エイミング:
    • 回転していないすねベクトルをX軸周りに kx だけ回転させ、太ももベクトルを加算して _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] にわたって、ヘビーメレーまたは武器アニメーションを4つの正規化された明確なフェーズに分割します。

  • フェーズ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の字の腰の揺れ、2倍速の膝バウンス(Math.abs(Math.sin(beat * 2)))、交互の肩ポップ、および回転するクローフラリッシュを駆動します。

検証チェックリスト

  1. 生成されたスクリプトに対して構文検証を実行し(node -e "new Function(code)")、構文エラーや未宣言変数エラーがゼロであることを確認します。
  2. evaluateAnimation(t, dt) の最後で、すべての骨盤位置/回転の更新後に solveLegIK('L', ...) と solveLegIK('R', ...) が呼び出されていることを確認します。
  3. 実行時エラーが発生した場合にすぐに画面上に表示されるように、HTML にトップレベルの window.onerror 診断バナーを含めます。

関連スキル