# Gameplay Contact Response

> Gameplay Contact Response

- Skill: `ziyou-lu/gameplay-contact-response` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-contact-response`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-contact-response/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-contact-response

---


# 视觉材质感与接触响应诊断

## 效果预览

同一箱子从同样高度落下：左侧回弹过高、迟迟不停，右侧调整接触响应后小幅回弹并稳定落地。

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

![落地弹得太高？调真实回弹：使用前后对比](assets/before-after.webp)

## 触发条件

- 网格已有凹陷或损伤，但碰撞后状态仍与期望材质感不符。
- 物体接触前运动已符合目标，但落地后回弹、硬度或稳定过程不符，需要单独检查接触阶段。
- 需要判断问题能否仅靠表现解决，还是明确需要改变局部接触行为。

## 输入与前置条件

入射速度/方向、接触对象和所用接触材质、碰撞后状态、当前网格与碰撞体的各自职责，以及是否明确允许改变物理规则。把“外观变形”和“接触响应变化”分别记录；倒伏场景先固定接触前的运动条件。

## 实施步骤

1. 固定接触前速度、角度、姿态和目标，分别记录网格外观与接触后回弹/稳定过程。单纯回弹问题不必增加损伤形变。
2. 若只允许视觉修改，保持碰撞规则，使用独立视觉形变。确需物理变化时复制局部材质/配置，保留原值与切换开关。
3. 回弹分支先检查项目引擎的物理材质及组合规则，单独改变恢复/回弹相关配置；弹得过高应减少而非一律加弹性，摩擦作为另一变量。
4. 视觉金属损伤与接触过硬不一致时，若引擎支持局部受限的接触穿入，可将它作为近似顺应性的候选：限定作用对象和最大穿入量，对照无穿入基线，观察是否减轻过硬接触且未产生穿透或失稳。先确认可隔离与可回退，再做实验；不把局部方案改成全局容差，也不据此宣称真实金属模拟。
5. 分别开关网格方案和接触候选，测薄障碍、高速、擦碰、重复碰撞及无关物体。倒伏测试保持重心和施力点不变，触地前问题另行处理。

## 调参顺序

以回弹峰值、静止所需时间和穿透量作为对照记录。一次只调一个局部材质量，明确其引擎单位和混合规则；从基线小范围变化，不预设材料必须“微回弹”。

## 失败处理

出现穿透、卡住、弹飞或连续抖动立即回退候选。引擎不提供可控局部方案时保持碰撞基线，报告需要专门物理实现，不能靠美术凹陷宣称接触已修好。

## 验收

- [ ] 涉及视觉损伤时，相同初始条件下分别开关视觉与接触方案，能区分外观差异与碰撞后状态差异；材质单项问题不强加视觉损伤。
- [ ] 薄障碍、高速、擦碰和重复碰撞中没有非预期穿透、陷入/卡住或弹飞，无关物体不受影响。
- [ ] 物理变化的范围和预期结果明确可回退，不把局部演示扩成全局容差修改，也不把凹陷/局部穿入视为稳定性验证。
- [ ] 材质实验保持接触前条件一致，落地后的回弹和趋于静止符合目标，无意外连续弹跳或抖动；不把一组倒伏结果当单变量证明。

## 组合与边界

- 首次接触前的倒伏方向/重量感问题使用[重心与施力诊断](../gameplay-prop-toppling-dynamics/SKILL.md)。本页只处理接触发生后的响应，不扩成所有刚体调参的入口。

- 主体碰撞正常但枝条等突出部漏接触时，使用[突出部接触覆盖与响应](../gameplay-prop-appendage-contacts/SKILL.md)，不把局部覆盖问题改成放宽接触容差。

- 需要构建有连接与层间弹簧的可压缩表面时，使用[交互承载面](../gameplay-deformable-support/SKILL.md)，不把接触穿入实验当作承载结构。

只在需要相应机制时读取，沿用其事件与预算约束：

- [保持碰撞不变的视觉形变](../gameplay-motion-deformation/SKILL.md)
- [接触位置与粒子反馈](../gameplay-impact-visuals/SKILL.md)

需要核对案例、参数出处或证据边界时，读取[来源参考](references/sources.md)。

