Godot — Deprecated APIs
Last verified: 2026-02-12
If an agent suggests any API in the "Deprecated" column, it MUST be replaced
with the "Use Instead" column.
Nodes & Classes
| Deprecated | Use Instead | Since | Notes |
|---|
TileMap | TileMapLayer | 4.3 | One node per layer instead of multi-layer node |
VisibilityNotifier2D | VisibleOnScreenNotifier2D | 4.0 | Renamed for clarity |
VisibilityNotifier3D | VisibleOnScreenNotifier3D | 4.0 | Renamed for clarity |
YSort | Node2D.y_sort_enabled | 4.0 | Property on Node2D, not a separate node |
Navigation2D / Navigation3D | NavigationServer2D / NavigationServer3D | 4.0 | Server-based API |
EditorSceneFormatImporterFBX | EditorSceneFormatImporterFBX2GLTF | 4.3 | Renamed |
Methods & Properties
| Deprecated | Use Instead | Since | Notes |
|---|
yield() | await signal | 4.0 | GDScript 2.0 coroutine syntax |
connect("signal", obj, "method") | signal.connect(callable) | 4.0 | Callable-based connections |
instance() | instantiate() | 4.0 | Renamed |
PackedScene.instance() | PackedScene.instantiate() | 4.0 | Renamed |
get_world() | get_world_3d() | 4.0 | Explicit 2D/3D split |
OS.get_ticks_msec() | Time.get_ticks_msec() | 4.0 | Time singleton preferred |
duplicate() for nested resources | duplicate_deep() | 4.5 | Explicit deep copy control |
Skeleton3D signal bone_pose_updated | skeleton_updated | 4.3 | Renamed |
AnimationPlayer.method_call_mode | AnimationMixer.callback_mode_method | 4.3 | Moved to base class |
AnimationPlayer.playback_active | AnimationMixer.active | 4.3 | Moved to base class |
Patterns (Not Just APIs)
| Deprecated Pattern | Use Instead | Why |
|---|
String-based connect() | Typed signal connections | Type-safe, refactor-friendly |
$NodePath in _process() | @onready var cached reference | Performance: path lookup every frame |
Untyped Array / Dictionary | Array[Type], typed variables | GDScript compiler optimizations |
Texture2D in shader parameters | Texture base type | Changed in 4.4 |
| Manual post-process viewport chains | Compositor + CompositorEffect | Structured post-processing (4.3+) |
| GodotPhysics3D for new projects | Jolt Physics 3D | Default since 4.6; better stability |
