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

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

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