hitbox-hurtbox
Installation
SKILL.md
Hitbox and hurtbox
Choose the representation required by the game:
| Column | Shape |
|---|---|
| 2d-boxes | AABB / OBB on a gameplay plane |
| 3d-capsules | body/limb capsules or other declared primitives |
| projectile-volume | spawned gameplay volume with lifetime |
Ownership and identity
Hitboxes and hurtboxes are gameplay data, not render meshes. Active move ticks publish attack volumes; vulnerable state publishes hurt volumes independently.
Each attack activation has a stable attack_instance_id. A multi-hit move additionally publishes a hit_index or equivalent schedule. Duplicate-hit prevention is keyed by attack instance, hit index and target according to the move policy; it is not inferred from overlap duration.
Grab/throw, strike, projectile and clash volumes are distinct interaction classes. Eligibility rules decide which classes can affect the target.