For Claude Code & Cursor · Godot 4.x

Godot 4 Agent Pack

Your agent keeps writing onready var and yield(). It "verifies" with godot --check-only, sees exit code 0, and calls broken code done. This pack fixes that.

Get the pack · $19 Try the free lite version

Examples of Godot 3 code being blocked with the Godot 4 fix

Enforced, not just suggested

A pre-write hook stops Godot 3 syntax before it reaches your project (22 patterns) and gives the agent the exact Godot 4 fix for each line:

Blocked: Godot 3 syntax in a Godot 4 project. Rewrite these lines and retry:
  line 1: extends KinematicBody2D
    fix: KinematicBody2D -> CharacterBody2D
  line 2: export var speed = 200
    fix: "export var" -> "@export var name: Type"

A post-write hook validates every .gd and .tscn edit headlessly and feeds back only the errors. Edits to generated files (.godot/, *.import, *.uid) are blocked, and reads of cache and build output are denied.

A validator that tells the truth

Verified on Godot 4.7.2: godot --check-only exits 0 even when it prints parse errors, and it flags valid autoload references as errors. The pack's tools/check.sh gets both right, handles new class_name caching, and catches broken .tscn resource and parent paths. On 9 deliberately broken files it caught 7; raw --check-only caught 0 by exit code. The other 2 are runtime-only GDScript errors, which is why the pack also includes a dependency-free headless test runner.

Measured, not promised

One feature task (health system, new scene, HUD and tests), 3 runs with the pack and 3 without, Claude Sonnet 5.5:

	Without pack	With pack	Change
Median total tokens	295k	203k	−31%
Median API-equivalent cost	$0.190	$0.166	−13%
Task completed correctly	3/3	3/3	same

A small sample on one task, so treat it as one data point. The full method and raw data are included in the pack.

What's inside

Lean CLAUDE.md

79 lines. Anthropic recommends under 200, because longer files cost tokens and get followed less.

Hooks + validator

Pre-write Godot 3 guard, post-write check, tools/check.sh and a headless test runner.

Skills on demand

Scene editing, Godot 3→4 porting and testing guides that load only when needed.

Commands

/check and /port3 for Claude Code.

Cursor support

Cursor rules and a .cursorignore.

Safe installer

Never overwrites your files. Includes a sample Godot 4 project with tests.

$19

One developer, unlimited projects of your own. 30-day full refund if it's not for you.

Get the pack on Gumroad Free lite version on GitHub

Requires Godot 4.x, Claude Code (or Cursor), bash and python3. Tested on macOS with Godot 4.7.2. Linux expected to work. Windows untested (use WSL).