godot-gdscript

1# Godot GDScript (4.x)
2 
3Write correct, statically typed GDScript and use the node lifecycle and signal
4system the way the engine intends. Targets **Godot 4.7** (GDScript 2.0).
5 
6## When to use
7 
8- Use when writing or fixing `.gd` files: declaring variables, functions, classes,
9  using `@export`/`@onready`, connecting signals, or awaiting coroutines/signals.
10- Use when porting Godot 3.x scripts to 4.x and the script no longer parses.
11 
12**When *not* to use:** scene/node structure and instancing questions →
13`godot-nodes-scenes`; signal *architecture*/decoupling patterns →
14`godot-signals-groups`; using C# instead of GDScript → `godot-csharp`.
15 
16## Core workflow
17 
181. **Type everything you can.** GDScript 2.0 supports static types
19   (`var hp: int = 10`, `func add(a: int, b: int) -> int:`). Types catch errors at
20   parse time and speed up the VM. Use `:=` for inferred types.
212. **Use the lifecycle callbacks for their purpose:** `_ready()` once when the node
22   and its children enter the tree; `_process(delta)` every rendered frame;
23   `_physics_process(delta)` on the fixed physics tick (use it for movement/physics).
243. **Grab node references with `@onready`**, not in `_init()` — children do not exist
25   until the node enters the tree.
264. **Expose tunables with `@export`** so designers edit them in the Inspector.
275. **React to events with signals + `await`**, not polling, where it reads cleanly.
286. **Run and read errors.** The Debugger panel prints typed errors with line numbers;
29…