Sprite + Hitbox JSON → Godot Game Integration

To sync CollisionPolygon2D hitboxes with animated sprites in Godot 4, this integration loads per-frame polygon JSON and updates the collision shapes deterministically whenever the animation frame changes. This ensures hurtboxes and attack hitboxes match the exact visual frame.

You can mirror 2D combat hitboxes for left and right facing directions by automatically flipping the polygon vertices. This allows you to reuse a single set of JSON hitbox data for both directions without creating duplicate assets.

The best way to convert per-frame PNG sprites and JSON polygon data into Godot collision shapes is to auto-discover the matching assets and generate CollisionPolygon2D data. This workflow eliminates manual alignment by directly translating the JSON coordinates into usable Godot 4 collision polygons.

To visualize and debug 2D hitbox and hurtbox polygons during gameplay, you can use a built-in debug overlay. It draws transparent collision polygons in distinct colors, using green for hurtboxes and red for attack hitboxes, to verify frame accuracy in-game.

This Godot 4 frame-accurate hitbox integration works for boss attack systems and melee combat. It updates attack areas deterministically on every animation frame, ensuring complex polygon-based collision detection only activates when the attack polygon is active.

You do not need to manually align collision polygons for every animation frame. The integration handles the synchronization automatically by reading the per-frame polygon hitbox JSON and applying it to the CollisionPolygon2D whenever the animated sprite updates.