mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios
synced 2026-04-30 17:37:19 +00:00
44 lines
2.4 KiB
Markdown
44 lines
2.4 KiB
Markdown
|
# 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 |
|