Communitygithub.com

程序化3D机甲动画生成器

指导智能体规划、构建或裁剪“程序化3D机甲动画生成器”,最终输出为计划、简报或检查清单。流程涵盖程序化3D机甲动画生成器、适用场景、步骤1:程序化放样几何与共形UV映射。当新任务需要此类技艺时使用。

程序化3D机甲动画生成器 是什么?

该技能(SKILL.md)为AI智能体(如Claude Code、Cursor等)提供一个完整的工作流程,用于在Three.js中构建生产级、单文件或模块化的3D硬表面机器人和机甲。其核心价值在于无需外部资产即可创建复杂的程序化动画:包括使用数学放样生成共形UV坐标以消除纹理拉伸,在内存中通过HTML5 Canvas生成PBR纹理(如焊缝、铆钉、磨损),以及实现解析2骨逆运动学(IK)求解器以实现零漂移足部锁定。技能详细阐述了完整的关键帧动画原理,包括分阶段战斗打击模式(包含预备、爆发、冲击、恢复)和全身动力链联动(如甩鞭效应),使生成的动作具有重量感和机械感。该技能适用于任何能够执行Node.js脚本和HTML渲染的AI编程环境,通过提供经过验证的代码片段和数学定义,极大提升了创建复杂3D动画的可靠性和效率。

兼容平台~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在内存中生成Albedo、Bump、Hazard、Decal和Shield纹理:

  • 共形接缝对齐:对于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. 世界到骨盆目标变换:使用worldToLocal()将期望的世界空间踝关节位置targetWorldVec转换为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. 四阶段战斗打击模式(例如:爪击与连击攻击)

将重型近战或武器动画分解为四个不同的归一化阶段,周期u in [0, 1]:

  • 第一阶段:预备与蓄力(0.00 - 0.42):
    • 使领先脚沿弧线向前迈步(stepLift = Math.sin(stepU * Math.PI) * 0.28)并宽幅落地。
    • 将骨盆重量转移到后方支撑腿,并将髋部和躯干向后扭转(组合偏航-70度)。
    • 反向旋转头部/传感器舱(+85度),使眼睛保持锁定目标。
    • 将打击侧的肩膀和肘部向后上方抬起,将另一只手臂摆过胸前作为配重,旋转腕部卡盘,并将爪子张开至100%。
  • 第二阶段:爆发性冲刺与甩鞭(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))。
  • 第三阶段:冲击、收拢与打击停止(0.58 - 0.72):
    • 在冲击瞬间将爪子合拢(clawVal = 0.05)。
    • 触发程序化摄像机震动、径向冲击波环、高频结构抖动(Math.sin(u * Math.PI * 10) * Math.exp(-u * 5))和合成的冲击音效。
  • 第四阶段:液压恢复(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. 验证solveLegIK('L', ...)和solveLegIK('R', ...)在evaluateAnimation(t, dt)的最后(所有骨盆位置/旋转更新之后)被调用。
  3. 在HTML中包含一个顶级的window.onerror诊断横幅,以便任何运行时错误能立即显示在屏幕上。

相关技能