Home / Level & Game Design / Hitbox Editor

Hitbox Editor

Draw hitboxes, hurtboxes, collision shapes and jump sensors on every frame of a sprite sheet. Export JSON, or a kit for Godot 4, Unity and Phaser.

Click or drop here
One sprite sheet, or several frame images

Box positions are saved relative to this point. Use the same point as the sprite origin in your engine. With Custom, hold Alt and click the frame.

Depth for 2.5D, in pixels

Leave 0 for a flat 2D game. For a belt scroller, or 2D sprites standing in a 3D world, this is how thick every box is front to back, so a hit only counts when both characters are in the same lane. A box can have its own depth in the list under the frame.

Shrink12%

A hurtbox a little smaller than the drawing feels fair to players. The outline is a convex polygon with up to 8 points, which every physics engine accepts.

Adds four thin sensor boxes around the body of this frame and puts the same ones on every frame. Feet tells you when the character stands on something, so it may jump. Front and back find walls, head finds ceilings.

In a top-down game only the feet should bump into walls, so the head can overlap things behind the character. The first button puts a small Body box at the feet and a Hurt box on the body, on every frame. The second adds an interact sensor in front of the character. Set Faces for each animation below first.

FromToFPSFaces

Name the frame ranges like your animations in the engine, for example idle, run, attack. The engine scripts use the names to find the right frame. Faces is for top-down games: it tells the interact sensor which side is ahead.

The JSON and the debug sheet are free. The JSON has every frame, every box and your animations in a plain format you can read from any engine.

Pro · the engine kit: a Godot 4 script that builds Area2D shapes for every frame, a Unity C# component with 2D colliders, and a JavaScript helper with overlap tests for Phaser, PixiJS and plain canvas. See plans

Drop a sprite sheet, then draw boxes on each frame.

V R C P T tools · 1 2 3 4 box type · , . frame · Space play · Del delete · arrows nudge · Ctrl+C / V copy and paste · Ctrl+Z undo · mouse wheel zoom · polygon: click points, press Enter or click the first point to close

Hitboxes, hurtboxes and why they are separate

The picture of a character is not what the game checks for hits. The game checks invisible shapes. A hitbox is the part that deals damage, like the blade of a sword during a swing. A hurtbox is the part that can take damage, usually the body. A body shape is what bumps into walls and floors. Keeping them apart is what makes combat feel fair: the sword hits only on the frames where it is really out, and a raised arm does not get the character killed.

Sensors for jumping and walls

A sensor is a thin box that hits nothing and only reports what it touches. Platformers use them all the time: a feet sensor under the character says "standing on ground, a jump is allowed", front and back sensors find walls for wall slides and wall jumps, and a head sensor finds the ceiling. One button adds all four. For a stomp attack, draw a Hit box under the feet on the falling frames only. How high and how fast the jump goes is a matter of game feel, which you can tune in the Game Feel Lab.

Top-down games

Top-down characters need a different setup. The collision shape is a small box at the feet, so the character can walk close to a wall or a tree and overlap it with the head, which gives the feeling of depth. The hurtbox still covers the body. Make one animation per direction, like walk_down, walk_up and walk_side, and set which way each one faces. The interact sensor then sits in front of the character in every direction, ready for doors, chests and people to talk to. If your game turns the sprite instead, as in a top-down shooter, draw the boxes once: in Godot and Unity they turn with the sprite, and the JavaScript helper takes a rotation.

2.5D: belt scrollers and sprites in a 3D world

In a beat 'em up where characters also walk up and down the street, a punch should only land when both fighters stand in the same lane. Set a depth and every box becomes that thick from front to back. In a 2D engine the Godot script compares the lanes of the two characters before it reports a hit. For 2D sprites placed in a 3D world, the kit has a Godot script for Sprite3D and AnimatedSprite3D and a 3D mode in the Unity component, which build real 3D shapes with that thickness. Isometric games that run in a 2D engine need none of this and work as they are. For characters that are real 3D models with a skeleton, use the 3D Hitbox Editor.

How to use it

Drop a sprite sheet and set the columns and rows. Press Hurtbox from pixels, All frames, to get a body box on every frame in one click. Then go to the attack frames, pick Hit and draw a box over the weapon. Use the ghost of the last frame to keep boxes steady, copy a frame's boxes forward, and press Play to watch them move with the animation. Flip shows how the boxes look when the character faces the other way.

Shapes and points

ShapeGood for
BoxMost hitboxes and hurtboxes. Fast to check and easy to tune.
CircleProjectiles, explosions and round enemies.
PolygonAngled weapons and odd shapes. Keep it convex, with no dents, for the most reliable result.
PointA named spot with no size: the gun muzzle, where an effect spawns, where a hand holds an item.

Each box can have a name and a number. Use the number for damage, knockback or anything else your game needs.

The JSON format

The file lists every frame with its place on the sheet and its boxes. Positions are in pixels, measured from the origin you picked, with y pointing down. A box has a type (hit, hurt, body, sensor or point), a shape (rect, circle, polygon or point), and the numbers for that shape: x, y, w and h for a rect from its top left corner, x, y and r for a circle from its center, and a flat list of points for a polygon. Depth is the thickness of the box for 2.5D games, or 0. Animations list the frames they use. Every field is always present, so the file also loads with Unity's JsonUtility.

Using it in an engine

Godot 4: add the script from the kit as a child of your AnimatedSprite2D. It creates Hit, Hurt and Body areas and rebuilds their shapes whenever the frame changes or the sprite flips, and it sends a signal when a hitbox touches a hurtbox. sensor_touching("feet") tells you if a sensor is on the ground. Unity: add the component next to your SpriteRenderer. It reads the frame number from the sliced sprite name and builds trigger colliders. IsSensorTouching("feet", groundMask) checks a sensor. Phaser, PixiJS and plain JavaScript: the helper gives you the shapes of a frame in world space and tells you when a hit shape overlaps a hurt shape, or when a sensor touches one of your walls or floors.

Is my sprite uploaded?

No. The sheet stays in your browser. Your boxes are saved in this browser for each image, so you can close the tab and continue later.

Hitbox Editor is a free browser tool for indie game developers. Online hitbox editor for sprite sheets: draw hitboxes, hurtboxes and collision shapes per frame and export JSON for Godot, Unity and Phaser.

Drop a sprite sheet and draw the invisible shapes your game checks for hits: hitboxes for attacks, hurtboxes for the body and collision shapes, frame by frame. Get a hurtbox on every frame in one click, copy boxes forward, watch them play with the animation and check the flipped side. Boxes, circles, polygons and named points like a gun muzzle, plus ground and wall sensors for jumping and foot collision and interact sensors for top-down games, and box depth for 2.5D. The JSON export is free. Pro adds ready scripts for Godot 4, Unity and JavaScript.

FAQ

Is 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.