/godot-version-migration

Bridge: Godot 3.x → 4.0

Tier A — official guide: Upgrading from Godot 3 to Godot 4.

Also use: docs changelog, interactive changelog, GitHub releases.

Preconditions

1. Full backup / VCS — the upgrade tool does not create backups.
2. Project on latest 3.x stable when possible.
3. Optional prep (3.5+): Tweener + Time; rename .shader → .gdshader.

Run the converter

• Project Manager: Import → Convert Full Project (not only project.godot unless advanced recovery).
• CLI: --validate-conversion-3to4 then --convert-3to4 (optional size limits for huge files).
• Only Godot 3.0+ projects.

After convert (expect manual work)

• Auto renames cover many nodes (KinematicBody→CharacterBody*, Spatial→Node3D, Particles→GPUParticles*, ARVR→XR, …).
• Manual: FileAccess/DirAccess, DisplayServer/Time splits, signal Callable style, Tween→Tweeners, super() in lifecycle, call_group immediacy, Camera2D zoom invert, shader hints, Environment quality → project settings.
• Caveats: Bullet removed; no GLES2; ArrayMesh format break; C#/.NET platform gaps historically.

Skill-scoped deltas

Domain Skills with a ## 3.x → 4.0 section in mirrored notes (see ../hop-index.md Pre-4.0 / module lists). Load only topics present in the project.

Next

Enter the 4.x ladder at 4.0 → 4.1 — never jump to 4.7 notes. Library target: 4.7+.