# Gameplay Hurtbox Tolerance

> 当攻击或危险障碍擦过角色边缘却命中、项目希望增加空间容差时，设计较小或贴合轮廓的受伤区域并验证命中边界；不把受伤区域等同于世界移动碰撞体，也不提供时间无敌。

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

---


# 贴合轮廓的受伤区域与擦边容差

## 效果预览

同一边缘弹道掠过可见轮廓外空白；左大伤害框相交，右复合贴身伤害区不相交；世界碰撞框不变。

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

![受伤范围贴近身体，少算空白：使用前后对比](assets/before-after.webp)

## 触发与输入

用于项目希望边缘擦过不受伤，单大框包含太多空白造成误中，或动画/缩放后受伤区域错位。取得可见轮廓与锚点、实际 hurtbox、各攻击形状、命中规则及独立世界移动碰撞体。先确认允许调整空间容差。

## 实施流程

1. 同时显示角色轮廓、hurtbox 与移动碰撞体，以中心命中和边缘擦过确定伤害实际读取哪个区域。
2. 用明确宽高/半径及单位定义较小受伤区域，设定稳定锚点。轮廓不规则且单框覆盖很多空白时，可改用少量局部矩形/简单形状覆盖重要身体区域：逐个记录局部偏移、大小和所属部件，调试显示组合轮廓。数量按任务选择，不追求每个像素或固定框数；不要用含义不明的百分比替代几何定义。
3. 攻击或危险障碍先通过 hurtbox 相交规则，再进入已有伤害/失败流程。复合区域按并集处理：任一局部区域相交即可成立，不要求所有框同时接触；同一事件同时碰到多个子区域也只提交一次结果，按权威事件身份去重。缩小或重组区域只改变是否命中，不添加减伤或时间免疫。
4. 若目前伤害和世界阻挡共用形状，先拆开用途再调整。走路、落地、贴墙和导航占用保持原规则。
5. 将 hurtbox 更新接到角色变换/状态，验证翻转、动画、缩放和状态切换；每种攻击形状独立校验边界。

## 调参

分别调水平、垂直余量与锚点，不默认等比缩小。先固定攻击几何，逐步寻找可理解的擦边范围；高速漏检需处理检测步长/扫掠能力，不靠增大或缩小区域偶然补救。

## 验收与失败处理

- 区域外擦边不扣血，中心相交仍命中，边界相切规则一致；复合框外部空白允许安全擦过，核心身体不出现未接受的漏检缝隙。
- 单个子区域接触能触发，同一事件重叠多个区域只结算一次；不把复合并集误写成全体同时命中。
- 缩放/翻转/动画无一帧漂移，移动碰撞完全不受影响。
- 各速度、方向、近战/弹体/范围攻击分别验证；关闭调试后仍能理解受伤范围。
- 错误扣血先查事件使用的形状与变换，不让表现触发代替权威判定。

## 组合

[受击保护](../gameplay-post-hit-protection/SKILL.md)处理时间，[低血减伤](../gameplay-low-health-damage-reduction/SKILL.md)处理伤害量；联用时分别记录未命中、免疫与减伤原因。

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

