Files
Claude-Code-Game-Studios/docs/engine-reference/godot/deprecated-apis.md
T
DonchitosandClaude Opus 5.5 b21fa0f7f2 Release 1.1.2 — the default path works end to end
Fix release for 1.1.1: the minimal path end to end, engine commands that
run on Godot, Unity and Unreal, hook warnings you can see, and verdicts
that say when they could not check. Details in CHANGELOG.md; upgrade
steps in UPGRADING.md (v1.1.1 → v1.1.2).

Fixes #67
Fixes #131

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WuJn2FdynEybfL5KC697nJ
2026-09-29 21:32:19 +10:00

2.5 KiB

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.set_default_texture_parameter() / get_default_texture_parameter() Texture base type Changed in 4.4; the shading language's sampler2D / texture() did not change
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