# Gameplay Dynamic Carry Alignment

> 实现可变长短、粗细的世界物体携带：按重量分组选择姿态，校准局部长轴、厚度轴和锚点，按实际截面调整手部贴合并在放下时清理绑定；不用于固定工具挥动或物品入库反馈。

- Skill: `ziyou-lu/gameplay-dynamic-carry-alignment` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-dynamic-carry-alignment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-dynamic-carry-alignment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ziyou-lu (https://skillmd.com/u/ziyou-lu)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/ziyou-lu/gameplay-dynamic-carry-alignment

---


# 动态尺寸物体的携带对齐

## 效果预览

同一搬运姿势下更换粗细不同的木头：左侧固定位置导致粗木头穿手，右侧按接触部位的粗细调整持握位置。

左侧为使用前，右侧为使用后；斜视 2.5D 短循环，用途示意（非引擎实测；音频相关预览仅示意触发关系，不含声音）。

![木头粗细不同，握的位置也要变：使用前后对比](assets/before-after.webp)

## 触发与输入

用于树枝、木段等切割或缩放后尺寸变化，固定握持偏移导致悬空、穿手或横向翻转的携带物。保留同一个实际世界物体，不替换成背包图标或仅相机可见的副本。

取得物体身份、当前几何及其版本、缩放与单位、重量数据和允许的携带分组、各组姿态/挂点、局部长轴与厚度方向、局部锚点、手模型接触偏移，以及项目现有的绑定和放下规则。缺少重量定义时不从长度猜质量；缺少允许分组时使用项目已有姿态，不虚构阈值。先确定谁驱动物体、谁驱动手，避免双向约束争抢。

## 实施流程

1. **选择携带组。** 在附着前用当前重量和资格规则选择姿态及挂点，保留超限拒绝路径。组与几何分开：相同重量的细长物和短粗物仍需分别计算位置。
2. **校准局部框架。** 选一件参考物体，显示长轴、厚度方向和锚点。明确锚点是在中心线还是接触表面；将两方向归一化并正交化，拒绝零向量或共线配置。按物体局部坐标保存，不把编辑器世界朝向存成通用轴。统一缩放和单位后再计算接触距离。
3. **从目标姿态反求校准值。** 将参考物体摆到期望握持位置，记录姿态挂点到目标携带框架的旋转、锚点和手模型偏移；先验长轴方向和滚转，再验位置。换一件尺寸不同的物体复测，确认保存的是方向关系而非某一件物体的固定世界位移。需要具体变换候选式时读取[实现校准参考](references/sources.md#工程迁移校准与候选变换)。
4. **按当前截面放置。** 在握持位置沿约定厚度方向测量从锚点到接触面的距离。只有明确是对称直径时才用厚度的一半作为半径；不规则截面使用实际局部表面距离或项目已定义的近似。先旋转到目标长轴/厚度方向，再沿接触法向补偿该距离和允许的手部嵌入量，最后应用单独校准的手模型偏移，避免重复加半径。
5. **绑定并响应变化。** 保存要恢复的父级/驱动状态，附着同一物体。携带期间由单一更新阶段写最终变换；挂点跟随角色，几何或缩放变化才使尺寸缓存失效。切割产生新身份时重新走资格与校准，不把旧对象锚点交给新片段。不可支持的新尺寸/重量按现有规则取消或重新选择姿态，不悄悄缩小物体。
6. **双视角检查。** 同时检查第一人称手部贴合和第三人称全身携带方向，覆盖细/粗、短/长、非对称截面及不同初始朝向。不能仅移动相机来掩盖世界物体穿身；第二只手需要约束时接入已有 rig，不在这里另造 IK 求解器。
7. **放下与中断。** 按项目已有可放置检测选择释放位置；位置无效时保持携带或拒绝放下，不强行穿墙。成功后解除携带更新、手部目标和临时约束，保持释放时世界变换，恢复正常物体驱动/碰撞配置。取消、角色失效和物体销毁走同一幂等清理路径，恢复过程不得重建已销毁的物体。

## 调参和故障定位

按姿态组→方向框架→锚点→截面距离→手模型偏移的顺序调整。恒定悬空先查锚点和模型偏移；随粗细放大的误差先查直径/半径及缩放；随角色转动漂移先查局部/世界空间混用；滚转翻面先查轴符号和退化基。不要用增大嵌入量掩盖错误方向，亦不要靠逐帧重校准累积偏移。

## 验收

- 同一物体在拾起、携带、放下后身份及几何不变；切割结果仅由原玩法产生。
- 两个同重量、不同粗细的样本能使用同组姿态而得到不同接触距离；任意初始朝向不改变校准结果。
- 第一、第三人称均无超出项目容差的悬空、穿手或不可达拉伸；修改几何后不沿用旧尺寸。
- 重复拾放、换组、取消和失效后无残留父级、更新器或手部目标；无效配置保留未携带状态并给出可定位原因。

固定工具挥动和身体参与交给[工具身体协调](../gameplay-tool-body-coordination/SKILL.md)；入账与吸附确认交给[掉落拾取](../gameplay-loot-pickup/SKILL.md)。核对出处和参数边界时读取[来源参考](references/sources.md)。

