A one-page printable reference for node lifecycle, 2D/3D nodes, physics, signals, input and the most-used GDScript patterns. Pin it next to your monitor! Note: TileMap deprecated in Godot 4.3+ , use TileMapLayer (one node per layer).
func _ready(): # runs when node enters the tree hp = 100 func _process(delta): # runs every frame pass func _physics_process(delta): # runs at fixed timestep (60 Hz) pass func _enter_tree(): # node added to scene tree func _exit_tree(): # node being removed func _input(event): # handle any input event func _unhandled_input(event): # input not caught by UI
| get_node("Path") | Find child node by path |
| get_parent() | Get parent node |
| get_children() | Array of child nodes |
| queue_free() | Safe delete at frame end |
| is_instance_valid(node) | Check if node exists |
| call_deferred("method") | Call at end of frame |
| has_node("Path") | Check if child exists |
| get_node_or_null("Path") | Find or return null |
| set_process(false) | Disable _process |
| get_tree() | Get SceneTree reference |
| CharacterBody2D | Player/enemy with custom physics |
| Sprite2D | 2D texture display |
| CollisionShape2D | Shape for physics/collision |
| Area2D | Detection zones (no physics) |
| TileMap Deprecated 4.3+ | Grid-based level editor , use TileMapLayer instead in Godot 4.3+ |
| TileMapLayer | Replacement for TileMap (Godot 4.3+) , one layer per node |
| Camera2D | 2D camera with smoothing |
| AnimatedSprite2D | Frame-by-frame animation |
| Node2D | Base 2D transform node |
| Marker2D | Position marker (no visual) |
| RemoteTransform2D | Sync position to another node |
| CharacterBody3D | 3D player with move_and_slide |
| MeshInstance3D | 3D model display |
| CollisionShape3D | 3D collision shape |
| Area3D | 3D detection zone |
| Camera3D | 3D camera |
| DirectionalLight3D | Sun/moon light |
| OmniLight3D | Point light (all directions) |
| SpotLight3D | Cone-shaped light |
| Node3D | Base 3D transform node |
| StaticBody3D | Immovable physics body |
# CharacterBody2D / 3D func _physics_process(delta): velocity = Vector2(100, 0) var collision = move_and_slide() # Check surface detection is_on_floor() is_on_wall() is_on_ceiling() # Get collision info for i in get_slide_collision_count(): var col = get_slide_collision(i) var body = col.get_collider() # Raycast (via RayCast2D/3D node) is_colliding() get_collider() get_collision_point()
# Define custom signal signal health_changed(new_hp) # Emit signal health_changed.emit(hp) # Connect in _ready health_changed.connect(_on_health_changed) # Connect node signal via editor body_entered.connect(_on_body_entered) # Disconnect health_changed.disconnect(_on_health_changed) # @onready , set after _ready @onready var sprite = $Sprite2D # @export , expose to inspector @export var speed: float = 200.0
| Input.is_action_pressed() | Held down this frame |
| Input.is_action_just_pressed() | Pressed this frame |
| Input.is_action_just_released() | Released this frame |
| Input.get_axis() | -1 to 1 from two actions |
| Input.get_vector() | 2D direction from four actions |
| Input.get_mouse_position() | Mouse position in viewport |
| Input.is_key_pressed() | Direct key check |
| Input.is_mouse_button_pressed() | Direct mouse button check |
| Vector2(x, y) | 2D vector |
| Vector3(x, y, z) | 3D vector |
| lerp(a, b, t) | Linear interpolation |
| clamp(val, min, max) | Restrict to range |
| move_toward(from, to, delta) | Step toward target |
| rad_to_deg(radians) | Convert radians to degrees |
| deg_to_rad(degrees) | Convert degrees to radians |
| randf_range(min, max) | Random float in range |
| randi_range(min, max) | Random int in range |
── PLAYER MOVEMENT (TOP-DOWN) ── @export var speed = 200.0 func _physics_process(delta): var input = Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down") velocity = input * speed move_and_slide() ── ENEMY AI (CHASE) ── @export var speed = 100.0 @onready var player = get_tree().current_scene.get_node("Player") func _physics_process(delta): var dir = (player.global_position - global_position).normalized() velocity = dir * speed move_and_slide() ── HEALTH SYSTEM ── signal died var hp = 100 func take_damage(amount): hp -= amount if hp <= 0: died.emit() queue_free() ── SCENE TRANSITIONS ── get_tree().change_scene_to_file("res://level2.tscn") get_tree().reload_current_scene() ── SAVE / LOAD ── var save_file = FileAccess.open("user://save.json", FileAccess.WRITE) save_file.store_string(JSON.stringify(data)) var file = FileAccess.open("user://save.json", FileAccess.READ) var data = JSON.parse_string(file.get_as_text())
Follow one of our free step-by-step workshops in the Workshop hub.
🔧 Browse Workshops →