Home / Level & Game Design / 3D Hitbox Editor

3D Hitbox Editor

Put hit and hurt shapes on the bones of a rigged 3D model, mark the frames where each attack is on, and export JSON or a kit for Godot 4, Unity and three.js.

Click or drop here
GLB, glTF, VRM, FBX or DAE with a skeleton
Bone

A shape follows its bone through every animation. Hit shapes deal damage, Hurt shapes take it, Body shapes are solid, Sensors only report what they touch, and a Point marks a spot like a blade tip or a gun muzzle.

One capsule per body part, sized from the skeleton. Fingers, toes and weapons are left out.

The JSON is free. It lists every shape with its bone, its place on that bone, its size and the animation frames where it is on.

Pro · the engine kit: a Godot 4 script that puts the shapes on your Skeleton3D and switches hit shapes on and off with the AnimationPlayer, a Unity C# component that does the same with colliders and the Animator, and a three.js helper with hit tests. See plans

Drop a rigged model, then put shapes on its bones.

W move · E rotate · R size · Space play · , . frame · Del delete · Ctrl+D duplicate · Ctrl+Z undo · drag to orbit, right drag to pan, wheel to zoom

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

ShapeGood for
CapsuleArms, legs, the body and long weapons. The cheapest shape for a physics engine after a sphere.
BoxBlades, shields and blocky parts.
SphereHeads, fists and explosions.
PointA 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.

3D Hitbox Editor is a free browser tool for indie game developers. Online 3D hitbox editor: attach hit and hurt shapes to the bones of a rigged model, set active frames per animation, export for Godot, Unity and three.js.

Drop a rigged 3D model with its animations and put capsules, boxes and spheres on its bones. Cover the whole body with hurt shapes in one click, add a hit shape on the weapon, then scrub the attack animation and mark the frames where the swing is really dangerous. The shapes follow the bones through every animation. The JSON export is free. Pro adds ready scripts for Godot 4, Unity and three.js.

FAQ

Is 3D Hitbox Editor free?

Yes. It runs in your browser with no account and no install. Some tools have a small daily free limit, and bigger exports or extras are marked Pro on the page.

Who makes GameShipKit?

GameShipKit is made by Jaehyun Cho, a solo indie game developer who builds tools for his own games and shares them. See the About page for more.

Updated 2026-11-23 · Made by GameShipKit

New tools every weekGet new free tools and game asset packs by email. About twice a month. Unsubscribe in one click.