Communitygithub.com

程序化3D機甲動畫師

引導AI代理規劃、建構或裁剪「程序化3D機甲動畫師」,產出具體的計畫、簡報或檢查清單。程序涵蓋程序化3D機甲動畫師、使用時機、步驟1:程序化放樣幾何與共形UV映射。適用於新任務需要此工藝時。

程序化3D機甲動畫師 是什麼?

此技能專為在 Three.js 中生成高品質、可投入生產的 3D 硬表面機器人與機甲而設計,無需外部 .glb 資產。它定義了一套完整的程序化工作流程,從幾何建構、紋理生成到動畫驅動。核心優勢在於其完全自包含的特性:所有紋理(磨損、鉚釘、接縫)皆透過 HTML5 Canvas 在記憶體中生成,而腿部動畫則依靠解析式 2 骨逆向運動學(IK)求解器,確保腳步精確鎖定地面,避免穿透或滑動。此技能適用於 Claude Code、Cursor 或 Codex 等 AI 編碼代理,幫助開發者快速搭建具備多階段戰鬥、行走或舞蹈動畫的機甲角色。其文件詳細說明了每個技術步驟,包括共形 UV 映射的數學計算、PBR 紋理繪製的 Canvas 填充模式,以及完整的人體工學運動鏈原則,例如動能鞭梢效應與 hit-stop 震盪,確保動畫兼具視覺衝擊力與物理可信度。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/etofot/Robo-Blender-Academy/tree/HEAD/dreadnought-3d-ik-studio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

程序化 3D 機甲動畫師

在 Three.js 中建構生產級、單一檔案或模組化的 3D 硬表面機器人與機甲,具備共形 UV 映射、程序化記憶體 PBR 紋理、解析式 2 骨逆向運動學(零漂移足部 IK)以及多階段全身動畫。

使用時機

  • 在 Three.js 中製作程序化 3D 機甲、機器人、步行者或硬表面載具,且無需外部 .glb 資產。
  • 實作解析式 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 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。將 D 限制在 maxReach = L1 + L2 - 0.003,使腿部能平滑伸展,避免骨盆拉伸過遠時產生 NaN 錯誤。
  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] 內分解為四個不同的標準化階段:

  • 階段 1:預備與蓄力(0.00 - 0.42):
    • 將前導腳沿弧線向前跨步(stepLift = Math.sin(stepU * Math.PI) * 0.28)並張開著地。
    • 將骨盆重量轉移到後方錨定腳,並向後扭轉臀部與軀幹(-70 度複合偏航角)。
    • 反向旋轉頭部/感測器吊艙(+85 度),使眼睛保持鎖定目標。
    • 將攻擊肩膀與手肘高舉至背後,將另一隻手臂橫過胸前作為平衡配重,旋轉手腕夾頭,並將爪子打開至 100%。
  • 階段 2:爆炸性弓箭步與鞭擊(0.42 - 0.58):
    • 透過 solveLegIK 將雙腳鎖定在地板上,同時將骨盆向前(+0.62 米 Z 軸)並向下(-0.27 米 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.0 秒 週期)上串聯多個戰鬥階段:

  • 階段 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 診斷橫幅,以便任何運行時錯誤能立即在螢幕上顯示。

相關技能