Hitboxes for 3D characters
A 3D character has no frames to draw on. Its hit shapes hang on the bones of the skeleton and move with every animation: a box on the sword bone, capsules on the arms, legs and body, a sphere on the head. This tool lets you place those shapes on your own model, watch them through each animation, and mark the moments when an attack is really dangerous.
How to use it
Drop a rigged model with its animations. Press Hurt capsules on the whole body to cover the character in one click. Then pick the weapon bone, choose Hit and add a box or a capsule over the blade. Move, rotate and size it with the handles. Open the attack animation, scrub to the frame where the swing starts and press Start at this frame, then go to where it ends and press End at this frame. The bar under the timeline shows when each hit shape is on. Play the animation slowly to check it.
Why hit shapes have a window
If the sword could hurt during the whole animation, the enemy would take damage while the hero is still lifting it. Good combat turns the hit shape on only for the few frames of the real swing. The frames before are the wind-up, which gives the other player time to react, and the frames after are the recovery, which is the price of missing. Those three numbers decide how an attack feels more than its damage does.
Shapes
| Shape | Good for |
|---|---|
| Capsule | Arms, legs, the body and long weapons. The cheapest shape for a physics engine after a sphere. |
| Box | Blades, shields and blocky parts. |
| Sphere | Heads, fists and explosions. |
| Point | A named spot with no size: the tip of a blade for a trail, a muzzle, where a hit spark appears. |
The JSON format
Each shape has the name of its bone, a position and a rotation relative to that bone, and its size. Positions and sizes are in the units of the model in this editor, so they do not depend on how the skeleton is scaled inside the file. Capsules stand along their own Y axis and their height includes the round ends. A shape is either always on or has a list of windows, each with an animation name and a start and end time in seconds.
Using it in an engine
Godot 4: add the script from the kit next to your imported model. It finds the Skeleton3D and the AnimationPlayer, builds the shapes, keeps them on the bones and sends a signal when a hit shape touches a hurt shape. Unity: add the component to the character. It finds the bones by name, builds colliders and reads the playing clip from the Animator. three.js: the helper follows the bones of your model and tests hit shapes against hurt shapes. For sprite characters, use the 2D Hitbox Editor.
Is my model uploaded?
No. The model stays in your browser. Your shapes are saved in this browser for each file name, so you can close the tab and continue later.