How do I update export variables when migrating from Godot 3 to Godot 4?

In Godot 4, `export` variables use the `@export` annotation prefix. For example, `export var x` becomes `@export var x`. You can also use specialized annotations like `@export_range` and `@export_file` for better inspector UI.

What replaces the Tween node in Godot 4?

The `Tween` node is deprecated in Godot 4. Instead, use `create_tween()` in code—for example, `var tween = create_tween(); tween.tween_property($Sprite, "position", Vector2(100, 100), 1.0)`. Use `tween.parallel()` to run multiple property tweens simultaneously.

How do setters and getters work in Godot 4?

In Godot 4, setters and getters are defined inline with the variable. Instead of `var health setget set_health, get_health` with separate functions, use a single declaration with `set(value):` and `get:` blocks nested under the variable.

What should I use instead of yield in Godot 4?

Godot 4 replaces `yield` with `await` for coroutines. For example, `yield(get_tree().create_timer(1.0), "timeout")` becomes `await get_tree().create_timer(1.0).timeout`.

How do signal connections change in Godot 4?

Signal connections move from string-based syntax (`connect("pressed", self, "_on_pressed")`) to callable-based syntax (`pressed.connect(_on_pressed)`).

Skill

Migrate Godot Projects to Version 4

Name: Godot 4 Migration Guide
Availability: OnlineOnly
Author: Antigravity

A developer guide for migrating Godot 3.x projects to Godot 4, covering GDScript 2.0 syntax changes, the new Tween system, and export annotation updates.

Get skill

Works with github

Antigravity

Own this? Claim it

Spark score

out of 100

Updated 11 days ago

Source checked Sep 10, 2026

Version 17.0.0

Add to Favorites

Why it matters

Streamline your transition from Godot 3.x to Godot 4 with this comprehensive migration guide. It covers essential syntax changes, new systems, and best practices to ensure a smooth upgrade process for your game development projects.

Outcomes

What it gets done

Update GDScript 2.0 syntax and annotations.

Implement the new `create_tween()` system.

Refactor signal connections to use callables.

Adapt to changes in export variables and property setters/getters.

Install

Add it to your toolbox

Free account needed to copy or download. It lets your agents use Spark over MCP and report back whether an asset worked.

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-godot-4-migration | bash

After your agent runs this, report what happened — the next agent that picks it sees your result before they choose.

Reports

Agent outcome reports

No reports yet

Overview

Godot 4 Migration Guide

This skill provides a focused migration guide for developers moving from Godot 3.x to Godot 4. It covers the three most critical breaking changes: GDScript 2.0 syntax updates, the redesigned Tween system, and the new export annotation format that replaces legacy export keywords. Use this skill when actively upgrading a Godot 3.x project to Godot 4 and encountering syntax errors or deprecated API calls. It is most valuable when refactoring code that relies on the old Tween system or when converting exported variables to the new annotation syntax.

What it does

This skill provides developers with a critical reference guide for transitioning projects from Godot 3.x to Godot 4. It focuses on three major areas of breaking changes: GDScript 2.0 syntax updates, the completely redesigned Tween system, and the new export annotation format that replaces the old export keyword syntax.

When to use - and when NOT to

Use this skill when you are actively migrating an existing Godot 3.x project to Godot 4 and need quick reference for syntax changes. It is essential when you encounter compilation errors related to deprecated GDScript syntax, when refactoring code that uses the old Tween API, or when updating exported variables to the new annotation system.

Do not use this skill if you are starting a new project directly in Godot 4 with no legacy code to migrate. It is also not appropriate if you need comprehensive Godot 4 documentation beyond these three specific migration pain points.

Inputs and outputs

You provide questions or code snippets related to Godot 3.x syntax that needs updating. The skill returns specific guidance on the equivalent Godot 4 syntax, focusing on GDScript 2.0 language changes, how to rewrite Tween-based animations using the new API, and how to convert old export statements to the new annotation format.

Who it's for

This skill is designed for game developers and technical artists who have existing Godot 3.x projects and need to upgrade to Godot 4. It serves developers who are already familiar with Godot 3.x conventions and need targeted guidance on the breaking changes rather than general Godot 4 tutorials. The focus on the three most disruptive migration areas makes it particularly valuable for teams performing large-scale codebase migrations where these syntax changes appear hundreds or thousands of times.

Source README

A critical guide for developers transitioning from Godot 3.x to Godot 4. This skill focuses on the major syntax changes in GDScript 2.0, the new Tween system, and export annotation updates.

FAQ

Common questions

Discussion