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.

Same-tick resolution

Installs
8
GitHub Stars
13
First Seen
Oct 13, 2026