skilld
All skills
thedivergentai avatar

/godot-version-migration

@57c9225
by Divergent AIthedivergentai/gd-agentic-skills783 stars
48

Full-history Godot version migration hub. Use when upgrading any Godot project toward the library target (currently 4.7)—from 1.x/2.x legacy eras through 3→4 and hop-by-hop 4.x minors—or finding Domain Skill-scoped migration notes. Trigger keywords: upgrade Godot, migrate Godot version, Godot 3 to 4, Godot 2 to 3, upgrading_to_godot, version migration, breaking changes, convert-3to4, TileMapLayer, AnimationMixer, engine.cfg, project.godot.

Ask your Agent

Use this Skill: https://skilld.dev/gh/thedivergentai/gd-agentic-skills/godot-version-migration

This session only. Nothing lands on disk.

referencesui-theming.md

≈771 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Migration notes: godot-ui-theming

Incremental upgrade for topics this skill covers. Apply one hop, stabilize/test, then next. Never skip hops.

If the project is < 4.0, follow godot-version-migration era bridges (legacy → 3→4) until 4.0, then these hops. Official 3→4: Upgrading from Godot 3 to Godot 4.

3.x → 4.0

Official: Upgrading from Godot 3 to Godot 4

  • Theme API: get_stylebox → get_theme_stylebox; checked/unchecked icon names.
  • Fonts → FontFile; rebuild theme resources.
  • Control offsets replace margins.

4.0 → 4.1

Official: Upgrading to Godot 4.1

  • SubViewportContainer.mouse_filter must be STOP/PASS for input to reach SubViewports embedded in themed HUD shells.

4.1 → 4.2

Official: Upgrading to Godot 4.2

  • Font fallback property structure changed — update Theme/default-font fallback chains.

4.2 → 4.3

Official: Upgrading to Godot 4.3

  • Default font outline color is black (was white) — rebalance outline-only Theme overrides.
  • auto_translate deprecated for Node auto_translate_mode (inherit semantics).

4.3 → 4.4

Official: Upgrading to Godot 4.4

No skill-relevant breaking changes for this hop.

4.4 → 4.5

Official: Upgrading to Godot 4.5

  • CanvasItem/Font/TextLine draw APIs gain optional oversampling.
  • ProjectSettings.add_property_info warns on invalid/usage keys — validate custom theme-related project settings.

4.5 → 4.6

Official: Upgrading to Godot 4.6

  • Control.grab_focus / has_focus gain hide-focus options.
  • PopupMenu.submenu_popup_delay default 0.2 (was 0.3).

4.6 → 4.7

Official: Upgrading to Godot 4.7

  • New projects default stretch canvas_items + aspect expand — retest Theme scale on legacy viewport/keep projects.
  • Control offset transform for inspector-driven visual tweaks without relayout.
  • ResourceImporterDynamicFont.hinting default changed to 3 — verify font crispness on target DPI.
  • GradientTexture2D supports conic gradients in Theme icon/background recipes.
  • CanvasItem no longer adds antialiasing feather that thickened lines — widen themed separator strokes if needed.

Source: SKILL.md on GitHub

Third-party checks

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is a comprehensive documentation and orchestration hub for migrating Godot engine projects across various versions. It provides structured guidance, checklists, and references to official and community documentation to ensure a safe and stable upgrade path.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Provenance

Signed by skilld at 57c9225. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 2 months ago

README badge

README badge for thedivergentai/gd-agentic-skills/godot-version-migration