====== GDScript — Kurzes Cheatsheet (Deutsch) ======

Dieses Cheatsheet fasst die wichtigsten Elemente von GDScript (Godot 3 & 4) kompakt zusammen. Codebeispiele sind kurz und direkt anwendbar.

===== Allgemeines =====
   * Kommentar: # Einzeiliger Kommentar
   * Datei-Scope:
      * extends Node2D          # Erbt von einem Node-Typ
      * class_name MyClass     # Globaler Klassenname (registriert im Editor)

===== Variablen & Typen =====
==== Dynamisch / untypisiert ====

<codedoc code:python>var x = 5 </codedoc>
==== Getypt (empfohlen) ====

<codedoc code:python>var speed: int = 200
const MAX_HP: int = 100 </codedoc>
==== onready (erst nach Knoten-Initialisierung): ====

<codedoc code:python>@onready var sprite = $Sprite </codedoc>
==== export (sichtbar/konfigurierbar im Editor) ====

<codedoc code:python>@export var speed := 200
@export (int, 0, 400) var health := 100   # Hinweis: Hint-Syntax kann je nach Version leicht variieren</codedoc>

===== Funktionen =====
==== Definition ====
<codedoc code:python>func my_func(param: int) -> String:
   return str(param)</codedoc>
==== Lebenszyklus-Hooks ====
<codedoc code:python>func _ready():                 # nach dem Hinzufügen in die Szene
func _process(delta):          # every frame (nicht-physikalisch)
func _physics_process(delta):  # physics frame</codedoc>

==== Sichtbarkeits-/Annotations ====
<codedoc code:python>@tool         # Skript läuft auch im Editor (Godot 3/4) export, onready, class_name siehe oben</codedoc>

===== Knoten & Szenen =====

==== Zugriff ====
<codedoc code:python>var player = get_node("Player")
var p = $Player/SubNode</codedoc>
==== Instanziieren ====
<codedoc code:python>var Packed = preload("res://Enemy.tscn")
var enemy = Packed.instantiate()   # Godot 4
var enemy = Packed.instance()      # Godot 3 (alte Methode)
add_child(enemy)</codedoc>
==== Entfernen ====
<codedoc code:python>queue_free()</codedoc>

===== Ressourcen laden =====
==== preload (compile-time, schneller) ====
<codedoc code:python>var TEX = preload("res://sprite.png")</codedoc>
==== load (runtime) ====
<codedoc code:python>var TEX = load("res://sprite.png")</codedoc>

===== Signale =====
==== Definieren / Emittieren ====
<codedoc code:python>signal hit(damage)
emit_signal("hit", 10)</codedoc>
==== Verbinden ====
<codedoc code:python>connect("hit", self, "_on_hit")
$Button.connect("pressed", self, "_on_pressed")</codedoc>
==== Godot 4: Typed signal syntax möglich ====
<codedoc code:python>signal hit(damage: int)</codedoc>

===== Eingabe (Input) =====

==== _input(event) ====
<codedoc code:python>func _input(event):
   if event is InputEventKey and event.pressed:
      if event.scancode == KEY_SPACE:
         jump()</codedoc>
==== Input-Mapping (Project Settings -> InputMap) ====
<codedoc code:python>if Input.is_action_pressed("ui_right"):
 ...</codedoc>

===== Await / Coroutines / Timer =====

==== Godot 3 yield ====
<codedoc code:python>yield(get_tree().create_timer(1.0), "timeout")</codedoc>
==== Godot 4 await ====
<codedoc code:python>await get_tree().create_timer(1.0).timeout</codedoc>
==== Timer-Node ====
<codedoc code:python>$Timer.start(2.0)</codedoc>

===== Collections =====
==== Array ====
<codedoc code:python>var a = [1, 2, 3]
a.append(4)
for i in a: 
   ...</codedoc>
==== Dictionary: ====
<codedoc code:python>var d = {"hp": 10, "name": "Player"}
if d.has("hp"): 
   ... </codedoc>

===== Kontrollstrukturen =====

==== if/elif/else ====
<codedoc code:python>if x > 0:
   # die Zahl ist größer Null
   pass
elif x < 0:
   # die Zahl ist kleiner Null
   pass
else:
   # die Zahl ist Null
   pass</codedoc>

==== match (Godot 4 / GDScript 2.0): ====
<codedoc code:python>match value:
   1:
      ...
   _:
      ...</codedoc>
      
==== for/while: ====
<codedoc code:python>for i in range(5): 
   ...

while cond: 
   ...</codedoc>

===== Fehlerbehandlung & Debug =====
   * print(), push_error(), push_warning()
   * assert(condition, "message") [[https://docs.godotengine.org/de/4.5/tutorials/scripting/gdscript/gdscript_basics.html#assert-keyword|Online-Doku]]
   * 

===== Best Practices (Kurz) =====
  * Typisieren wo möglich (besseres Autocomplete & Fehlercheck)
  * Export für Editor-Bearbeitbarkeit
  * onready für Knoten-Referenzen
  * Verwende preload für häufig genutzte Ressourcen
  * Trenne Gameplay-Logik in übersichtliche Methoden
  * Nutze Signals statt eng gekoppelter Node-Referenzen (lockere Kopplung)

==== Nützliche One-Liner====  
=== Position setzen (Node2D) ===
<codedoc code:python> position = Vector2(100, 200)</codedoc>
=== Bewegung ===
<codedoc code:python>velocity = velocity.move_toward(target, speed * delta)</codedoc>
=== Prüfen ob in Gruppe ===
<codedoc code:python>if is_in_group("enemies"): 
   ...</codedoc>
=== Connect per Code: ===
<codedoc code:python>some_node.connect("signal", self, "_method")</codedoc>

===== Kurze Beispiele =====
==== Player (Grundgerüst) ====
<codedoc code:python>extends CharacterBody2D class_name Player

export var speed: float = 200.0
onready var sprite = $Sprite

func _physics_process(delta):
    var dir = Vector2.ZERO
    if Input.is_action_pressed("ui_right"): dir.x += 1
    if Input.is_action_pressed("ui_left"): dir.x -= 1
    velocity.x = dir.x * speed
    move_and_slide()</codedoc>