Enemy Animation Auditor for Godot 4

Enemy Animation Auditor for Godot 4

Enemy Animation Auditor is an asset-free Godot 4 editor tool for testing 2D enemy scenes before they enter your game world.

Use it to preview full-body or split lower/upper-body AnimatedSprite2D enemies, audit animation naming, run target movement scenarios, catch wrong-facing ranged attacks, inspect melee strike timing, and save reports.

Highlights

• Preview actions and directions for configured enemy scenes.
• Test full-body or split lower/upper-body animation setups.
• Run melee range, strike timing, dodge, retreat, moving target, distance sweep, orbit target, target switch, ranged facing, and z-order scenarios.
• Full Test runner checks every configured enemy through every scenario.
• Reports include pass/fail status, projectile visibility, target hits, facing errors, and attack stability.
• Write Markdown reports to user://enemy_animation_auditor_report.md.
• Includes user documentation and an AI/MCP assistant workflow guide.

Included

• addons/enemy_animation_auditor/
• User guide
• AI/MCP assistant guide
• Sample JSON config
• Minimal enemy contract example

Not included

No enemy art, spritesheets, tilesets, Unity Asset Store files, audio, or paid third-party game assets are included. Screenshots show example enemy art for demonstration only.

Reports

The diagnostics panel shows live results while scenarios run. Click Audit Anim for a fast animation check or Run Full Test for all runtime scenarios. Click Write Report to save the latest result to user://enemy_animation_auditor_report.md.

Setup

1. Copy addons/enemy_animation_auditor/ into your Godot 4 project.
2. Enable the plugin in Project Settings.
3. Create res://enemy_animation_auditor_config.json from the included example.
4. Add your enemy scene paths and animation naming settings.
5. Open Project > Tools > Enemy Animation Auditor.

Commercial license. One purchased license covers one individual developer. See the included LICENSE file for full terms.