coin.tscn<\/code> (Strg + S).<\/li>\n<\/ol>\n\n\n\n
\n\n\n\nSchritt 3: Script an die M\u00fcnze anh\u00e4ngen und Signal verbinden<\/h3>\n\n\n\n
Nun kommt der Teil, der die Interaktion erm\u00f6glicht. Wir h\u00e4ngen ein Script an die Coin<\/code> (Area2D<\/code>) und verbinden ihr body_entered<\/code> Signal, das ausgel\u00f6st wird, wenn ein PhysicsBody<\/code> in die Area2D<\/code> eintritt.<\/p>\n\n\n\n\n- W\u00e4hle im Scene Dock den Coin<\/strong> (
Area2D<\/code>) Node aus.<\/li>\n\n\n\n- Klicke auf den Button „Attach Script“<\/strong> (Pergamentrolle mit Plus) oberhalb des Scene Trees (oder \u00fcber das Kontextmen\u00fc).<\/li>\n\n\n\n
- Stelle sicher, dass „Base Type“<\/strong> auf
Area2D<\/code> steht und der Pfad coin.gd<\/code> vorschl\u00e4gt. Das „Template“<\/strong> kann auf „Node“ bleiben.<\/li>\n\n\n\n- Klicke „Create“<\/strong>. Du siehst nun den Script Editor mit dem Basis-Template. <\/li>\n\n\n\n
- Erg\u00e4nze
class_name Coin extends Area2D<\/code> am Anfang des Scripts. <\/li>\n\n\n\n- Stelle sicher, dass der Coin<\/strong> Node im Scene Dock ausgew\u00e4hlt ist.<\/li>\n\n\n\n
- Gehe ins Node Dock<\/strong> (dieses befindet sich standardm\u00e4\u00dfig rechts neben dem Inspector, unter den Reitern „Inspector“ und „Node“).<\/li>\n\n\n\n
- Im Node Dock findest du eine Liste von Signalen, die der ausgew\u00e4hlte Node (
Area2D<\/code>) aussenden kann. Suche das Signal body_entered(body: PhysicsBody2D)<\/code><\/strong>.<\/li>\n\n\n\n- Klicke doppelt auf dieses Signal oder w\u00e4hle es aus und klicke unten im Node Dock auf „Connect…“<\/strong>.<\/li>\n\n\n\n
- Ein Fenster „Connect a Signal“<\/strong> \u00f6ffnet sich. Im oberen Bereich siehst du das Signal (
body_entered<\/code>). Im unteren Bereich siehst du den Receiver. Stelle sicher, dass der Coin<\/strong> Node der Receiver ist (er ist bereits ausgew\u00e4hlt, da wir das Script an ihn geh\u00e4ngt haben). Die Methode, die generiert wird, sollte so aussehen: _on_body_entered<\/code>.<\/li>\n\n\n\n- Klicke auf „Connect“<\/strong>. Godot erstellt automatisch die Funktion
_on_body_entered(body)<\/code> in deinem coin.gd<\/code> Script und springt zum Script Editor.<\/li>\n<\/ol>\n\n\n\n
\n\n\n\nSchritt 4: Kommunikation \u00fcber Signale: Player sammelt die M\u00fcnze ein<\/h3>\n\n\n\n
Um dem Player mitzuteilen, dass er eine M\u00fcnze ber\u00fchrt hat und diese dann „einsammeln“ soll, nutzen wir eigene Signale<\/strong>. Das ist der Godot-Weg, um Nodes miteinander kommunizieren zu lassen, ohne dass sie direkt voneinander wissen m\u00fcssen. Die M\u00fcnze signalisiert lediglich, dass sie eingesammelt wurde. Unser Player kann dann auf dieses Signal h\u00f6ren und reagieren.<\/p>\n\n\n\nHierf\u00fcr werden wir:<\/p>\n\n\n\n
\n- Ein benutzerdefiniertes Signal in unserem
coin.gd<\/code><\/strong>-Script deklarieren und aussenden.<\/li>\n\n\n\n- Im
player.gd<\/code><\/strong>-Script eine Funktion erstellen, die auf das Einsammeln reagiert.<\/li>\n<\/ul>\n\n\n\nDie Verbindung zwischen dem M\u00fcnz-Signal und der Player-Funktion in unserer world.tscn<\/code><\/strong> herstellen, da die World<\/code>-Scene sowohl den Player:in als auch die M\u00fcnzen kennt.<\/p>\n\n\n\n
\n\n\n\nSchritt 5: Den Player identifizieren (Gruppen)<\/h3>\n\n\n\n
Wenn ein anderes Objekt jetzt das CollisionShape2D unserer M\u00fcnze ber\u00fchrt (in den K\u00f6rper eintritt), wird das Signal body_entered<\/code> gesendet und jeder Abonnement informiert. In unserem Fall wird die Methode _on_body_entered(body)<\/code> aufgerufen. Die Variable body<\/code> in der Funktion <\/code>ist genau der Node, der gerade in unsere M\u00fcnz-Area eingetreten ist.<\/p>\n\n\n\nJetzt m\u00fcssen wir nur noch sicherstellen, dass der body auch wirklich ein Player ist. Nicht das die Gegner uns alle M\u00fcnzen klauen! Godot bietet ein sehr flexibles System, um Nodes zu identifizieren: Gruppen<\/strong>. Du kannst Nodes zu einer oder mehreren Gruppen hinzuf\u00fcgen. Dies ist der Weg, um Nodes nach ihrer „Rolle“ oder ihrem „Typ“ im Spiel zu kennzeichnen, anstatt sie direkt \u00fcber ihren Namen oder ihren spezifischen Node-Typ zu identifizieren.<\/p>\n\n\n\nDen Player einer Gruppe hinzuf\u00fcgen:<\/h4>\n\n\n\n\n- \u00d6ffne deine Scene
player.tscn<\/code><\/strong>.<\/li>\n\n\n\n- W\u00e4hle im Scene Dock den Root Node Player<\/strong> (
CharacterBody2D<\/code>) aus.<\/li>\n\n\n\n- Gehe ins Node Dock<\/strong> (rechts neben dem Inspector). Dort findest du den Reiter „Groups“ <\/strong>(gleich neben „Signals<\/strong>„).<\/li>\n\n\n\n
- Klicke auf das „+<\/strong>„. Es \u00f6ffnet sich ein neues Fenster mit dem Namen „Create New Group“. Gib in das Feld „Name“<\/strong> den Namen
Player<\/code> ein und klicke auf „Ok“<\/strong>.\n\n- Wichtig: Gruppennamen sind case-sensitive. Die Gro\u00df-Kleinschreibung ist sp\u00e4ter wichtig.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Du siehst nun
Player<\/code> in der Liste der Gruppen, zu der dein Player geh\u00f6rt (am Haken zu erkennen).<\/li>\n<\/ol>\n\n\n\nSpeichere die Scene player.tscn<\/code> (Strg + S).<\/p>\n\n\n\n
\n\n\n\nSchritt 6: Ein Signal in der M\u00fcnze deklarieren und aussenden<\/h3>\n\n\n\n
\u00d6ffne dein coin.gd<\/code> Script. Ganz oben im Script, unter extends Area2D<\/code>, deklarieren wir ein neues Signal namens collected<\/code>. Danach wird dieses Signal in der _on_Coin_body_entered<\/code>-Funktion ausgesendet, bevor die M\u00fcnze entfernt wird.<\/p>\n\n\n\nclass_name Coin extends Area2D\n \n# Signal, das ausgesendet wird, wenn die M\u00fcnze eingesammelt wird.\nsignal collected\n \nfunc _on_body_entered(body):\n if body.is_in_group(\"Player\"):\n print(\"M\u00fcnze ber\u00fchrt!\")\n \n # Sende das \"collected\"-Signal aus.\n # Jeder Node, der mit diesem Signal verbunden ist, wird benachrichtigt.\n emit_signal(\"collected\")\n \n # M\u00fcnze am Ende des aktuellen Frames sicher aus der Szene entfernen\n queue_free()<\/pre><\/div>\n\n\n\n
\nbody.is_in_group(\"players\")<\/code> gibt true<\/code> zur\u00fcck, wenn der Node in der Gruppe \u201eplayers\u201c ist, ansonsten false<\/code>. <\/li>\n\n\n\nsignal collected<\/code>: So deklarieren wir ein benutzerdefiniertes Signal. Es ist sinnnvoll, Signale am Anfang des Scripts zu deklarieren.<\/li>\n\n\n\nemit_signal(\"collected\")<\/code>: Ruft das Signal collected<\/code> auf und informiert alle damit verbundenen Nodes.<\/li>\n\n\n\nqueue_free()<\/code> ist der Weg in Godot, um einen Node und alle seine Kinder sicher aus der Scene zu entfernen. Sie markiert den Node zur L\u00f6schung am Ende des aktuellen Frames. Das L\u00f6schen erst am Ende des Frames ist wichtig, um Fehler zu vermeiden, wenn der Node noch aktiv Operationen ausf\u00fchrt.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n Schritt 7: Eine Sammel-Funktion im Player erstellen<\/h3>\n\n\n\n
\u00d6ffne dein player.gd<\/code> Script. Wir f\u00fcgen eine einfache Funktion collect_coin()<\/code> hinzu, die sp\u00e4ter Punkte hinzuf\u00fcgen, Sound abspielen oder andere Logik ausf\u00fchren k\u00f6nnte, wenn der Player eine M\u00fcnze einsammelt.<\/p>\n\n\n\nclass_name Player extends CharacterBody2D\n\nvar speed = 200 # Einheit: Pixel pro Sekunde\n\n# ... (Deine _ready, _process, _physics_process Funktionen bleiben unver\u00e4ndert)\n\n# Neue Funktion: Wird aufgerufen, wenn der Player:in eine M\u00fcnze einsammelt\nfunc collect_coin():\n print(\"Player hat die M\u00fcnze erfolgreich gesammelt!\")\n # Hier kommt sp\u00e4ter Logik wie Punkte erh\u00f6hen, Sound abspielen etc.<\/pre><\/div>\n\n\n\n
\n\n\n\nSchritt 8: Das Signal in der World-Scene verbinden<\/h3>\n\n\n\n
Damit unser Player auf das collected<\/code>-Signal der M\u00fcnze reagieren kann, m\u00fcssen wir eine Verbindung herstellen. Die World<\/code>-Scene ist der ideale Ort daf\u00fcr, da sie sowohl unseren Player:in als auch die instanziierten M\u00fcnzen kennt.<\/p>\n\n\n\n\nScript an World-Scene anh\u00e4ngen:<\/strong><\/p>\n\n- \u00d6ffne
world.tscn<\/code>.<\/li>\n\n\n\n- W\u00e4hle den Root Node World<\/strong> aus.<\/li>\n\n\n\n
- Klicke auf „Attach Script“<\/strong> (Pergamentrolle mit Plus) oberhalb des Scene Trees.<\/li>\n\n\n\n
- Als „Base Type“<\/strong> sollte
Node<\/code> stehen, und der Pfad world.gd<\/code>. Klicke „Create“<\/strong>.<\/li>\n\n\n\n- Speichere das
world.gd<\/code> Script (Strg + S).<\/li>\n<\/ul>\n<\/li>\n\n\n\nVerbindung im world.gd<\/code> Script herstellen:<\/strong> Wir nutzen die _ready()<\/code>-Funktion der World<\/code>-Scene, da diese aufgerufen wird, sobald die Scene und alle ihre Kinder (inklusive Player:in und M\u00fcnzen) bereit sind. Wir gehen alle Kinder der World durch, identifizieren Player:in und M\u00fcnzen und stellen die Verbindungen her.<\/p><\/li>\n<\/ol>\n\n\n\nclass_name World extends Node\n\n# Called when the node enters the scene tree for the first time.\nfunc _ready():\n # Referenz auf den Player holen\n var player_node = null\n for child in get_children():\n # Pr\u00fcfen, ob das Kind eine Instanz von Player ist\n if child is Player: \n player_node = child\n break # Player gefunden, Schleife beenden\n\n if player_node == null:\n print(\"Fehler: Player-Node in der Szene nicht gefunden!\")\n return # Abbruch, wenn kein Player da ist\n\n # Alle M\u00fcnz-Instanzen in der Szene finden und deren Signal mit dem Player verbinden\n for child in get_children():\n # Pr\u00fcfen, ob das Kind eine Instanz unserer Coin-Szene ist\n # Hier nutzen wir auch den class_name f\u00fcr Coin,\n if child is Coin:\n # Verbinde das 'collected'-Signal der M\u00fcnze mit der 'collect_coin'-Funktion des Players\n child.collected.connect(player_node.collect_coin)\n print(\"M\u00fcnze ('\", child.name, \"') mit Player verbunden.\")<\/pre><\/div>\n\n\n\n\nget_children()<\/code>: Gibt eine Liste aller direkten Kinder dieses Nodes (der World<\/code>) zur\u00fcck. Dar\u00fcber iterieren wir.<\/li>\n\n\n\nif child is Player<\/code>: Da wir unserem Player-Script class_name Player<\/code> gegeben haben, k\u00f6nnen wir hier direkt den Typ des Nodes pr\u00fcfen. Das ist eine sehr robuste Methode.<\/li>\n\n\n\nchild.collected.connect(player_node.collect_coin)<\/code>: Dies ist der Kern der Signalverbindung im Code. Es sagt: „Wenn das collected<\/code>-Signal von diesem child<\/code> (unserer M\u00fcnze) ausgesendet wird, dann rufe die Funktion collect_coin()<\/code> auf dem Player<\/code> auf.“<\/li>\n<\/ul>\n\n\n\n
\n\n\n\nDas Sammeln der M\u00fcnze testen<\/h3>\n\n\n\n
Was haben wir gemacht, damit alles funktioniert? Eine ganze Menge:<\/p>\n\n\n\n
\n- Player zur Gruppe „Player“ hinzugef\u00fcgt<\/strong><\/li>\n\n\n\n
- Im M\u00fcnz-Script <\/strong>
signal collected<\/code> definiert und emit_signal(\"collected\")<\/code> in der Funktion _on_body_entered(body)<\/code> aufgerufen und die M\u00fcnze entfernt.<\/li>\n\n\n\n- Im Player<\/strong> die Funktion
func collect_coin()<\/code> implementiert.<\/li>\n\n\n\n- Im World-Script <\/strong>alle M\u00fcnzen mit dem Player verbunden.<\/li>\n<\/ol>\n\n\n\n
Nun m\u00fcssen wir nur noch die M\u00fcnzen in der World platzieren.<\/p>\n\n\n\n
\n- \u00d6ffne
world.tscn<\/code>. Platziere ein paar Instanzen unserer M\u00fcnz-Scene im Level (zieh die gespeicherte coin.tscn<\/code> Datei aus dem Filesystem Dock in den Viewport oder auf den World<\/strong> Node im Scene Dock). Passe ggf. die Gr\u00f6\u00dfe an (im Inspector unter Node2D -> Transform -> Scale)<\/li>\n\n\n\n- F\u00fchre
world.tscn<\/code> aus (F5).<\/li>\n<\/ol>\n\n\n\nJetzt solltest du die M\u00fcnzen sehen, und wenn du mit deinem Player \u00fcber eine dr\u00fcberl\u00e4ufst, sollte sie verschwinden und sowohl „M\u00fcnze ber\u00fchrt!“<\/strong> (aus dem Coin-Script) als auch „Player hat die M\u00fcnze erfolgreich gesammelt!“<\/strong> (aus dem Player-Script) im Output Dock (unten im Editor) erscheinen.<\/p>\n\n\n\n
\n\n\n\nDein n\u00e4chster Schritt<\/h3>\n\n\n\n
Sehr gut! Du hast jetzt erfolgreich interaktive Objekte erstellt, die auf \u00dcberlappungen reagieren, und dabei die Signal-Kommunikation<\/strong> in Godot genutzt. Wir haben gelernt:<\/p>\n\n\n\n\n- Wie man Area2D<\/strong> Nodes nutzt, um \u00dcberlappungen zu erkennen.<\/li>\n\n\n\n
- Das Konzept von Signalen<\/strong> in Godot, wie man sie deklariert, aussendet und im Code verbindet, um auf Ereignisse zu reagieren.<\/li>\n\n\n\n
- Wie man Gruppen<\/strong> und
class_name<\/code><\/strong> verwendet, um Nodes robust zu identifizieren.<\/li>\n\n\n\n