{"id":576,"date":"2025-06-04T09:00:11","date_gmt":"2025-06-04T07:00:11","guid":{"rendered":"https:\/\/staratnight.de\/blog\/?p=576"},"modified":"2025-06-01T16:31:37","modified_gmt":"2025-06-01T14:31:37","slug":"spieleraktionen-in-godot-steuern","status":"publish","type":"post","link":"https:\/\/staratnight.de\/blog\/spieleraktionen-in-godot-steuern\/","title":{"rendered":"Spieleraktionen in Godot steuern"},"content":{"rendered":"\n

Nachdem wir unseren Sprite mit einem Script zum Rotieren gebracht haben, ist es an der Zeit, ihm Interaktion mit der Spieler:in zu erm\u00f6glichen. Input ist ein zentraler Bestandteil der meisten Spiele. Wie reagiert unser Spiel auf die Eingaben der Spieler:in (Tastatur, Maus, Gamepad)? Godot hat daf\u00fcr ein sehr flexibles System, die Input Map<\/strong>. Anstatt direkt auf Tasten wie „W“ oder „Up Arrow“ zu pr\u00fcfen, definieren wir Input Actions<\/strong>. Eine Action ist ein abstrakter Befehl, wie z.B. „move_up“, „attack“ oder „move_right“. Diesen Actions k\u00f6nnen wir dann eine oder mehrere Tasten\/Mausbuttons\/Gamepad-Buttons zuweisen. Das hat den Vorteil, dass wir die Steuerung sp\u00e4ter leicht \u00e4ndern k\u00f6nnen, ohne den Script-Code anpassen zu m\u00fcssen.<\/p>\n\n\n\n

\n\n\n\n

Schritt 1: Input Actions definieren<\/h3>\n\n\n\n

Wir beginnen damit, unsere Bewegungs-Actions in den Project Settings zu definieren:<\/p>\n\n\n\n

    \n
  1. Gehe im Men\u00fc oben auf Project<\/strong> -> Project Settings…<\/strong>.<\/li>\n\n\n\n
  2. W\u00e4hle oben den Tab Input Map<\/strong>.<\/li>\n\n\n\n
  3. Oben siehst du ein Feld „Add New Action“<\/strong>. Gib hier den Namen unserer ersten Action ein, z.B. move_right<\/code>.<\/li>\n\n\n\n
  4. Klicke auf den Button „+ Add“<\/strong> daneben. Die Action move_right<\/code> erscheint in der Liste.<\/li>\n\n\n\n
  5. Klicke neben der Action move_right<\/code> auf das „+“<\/strong> Symbol.\u00a0<\/li>\n\n\n\n
  6. Ein Fenster \u00f6ffnet sich, das dich auffordert, eine Taste auszuw\u00e4hlen. Dr\u00fccke die Rechte Pfeiltaste<\/strong>. Es erscheint „Right or Right (physical) or Right (Unicode) im Eingabefeld \u00fcber der Liste und in der Liste wird der Eintrag „Right“ ausgwe\u00e4hlt. Klicke auf „OK“<\/strong>.<\/li>\n\n\n\n
  7. (Optional) Klicke erneut auf das „+“<\/strong> neben move_right<\/code> und dr\u00fccke die Taste „D“<\/strong>, um „D“ ebenfalls f\u00fcr die Bewegung nach rechts zu konfigurieren.<\/li>\n\n\n\n
  8. Wiederhole die Schritte 3-6\/7 f\u00fcr die anderen drei Bewegungsrichtungen:\n
      \n
    • move_left<\/code> (z.B. Linke Pfeiltaste und „A“)<\/li>\n\n\n\n
    • move_up<\/code> (z.B. Obere Pfeiltaste und „W“)<\/li>\n\n\n\n
    • move_down<\/code> (z.B. Untere Pfeiltaste und „S“)<\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • Wenn du alle vier Actions definiert und die gew\u00fcnschten Tasten zugewiesen hast, schlie\u00dfe das Fenster Project Settings<\/strong>. Die \u00c4nderungen werden automatisch gespeichert.<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n

      Schritt 2: Input Actions im Script abfragen<\/h3>\n\n\n\n

      Jetzt kehren wir zu unserem Player.gd<\/code> Script zur\u00fcck. Wir erweitern die _process<\/code>-Funktion, um auf diese Input Actions zu reagieren und den Sprite zu bewegen.<\/p>\n\n\n\n

      \u00d6ffne dein Script (klicke im Filesystem Dock doppelt auf Player.gd<\/code>, falls es nicht mehr ge\u00f6ffnet ist).<\/p>\n\n\n\n

      Wir f\u00fcgen eine Variable f\u00fcr die Geschwindigkeit hinzu und \u00e4ndern dann die _process<\/code>-Funktion:<\/p>\n\n\n\n

      class_name Player extends Sprite2D\nvar speed = 200 # Einheit: Pixel pro Sekunde\n# Called when the node enters the scene tree for the first time.\nfunc _ready():\n    pass\n# Called every frame. 'delta' is the elapsed time since the previous frame.\nfunc _process(delta):\n    # Rotation (behalten wir erstmal)\n    rotation_degrees += 45 * delta\n    # Bewegung Input verarbeiten\n    var direction = Vector2.ZERO\n    if Input.is_action_pressed(\"move_right\"):\n        direction.x += 1 # Bewegung nach rechts addiert 1 zur X-Koordinate\n    if Input.is_action_pressed(\"move_left\"):\n        direction.x -= 1 # Bewegung nach links subtrahiert 1 von der X-Koordinate\n    if Input.is_action_pressed(\"move_down\"):\n        direction.y += 1 # Bewegung nach unten addiert 1 zur Y-Koordinate\n    if Input.is_action_pressed(\"move_up\"):\n        direction.y -= 1 # Bewegung nach oben subtrahiert 1 von der Y-Koordinate\n    # Normalisieren bei diagonaler Bewegung\n    if direction.length() > 0: # Pr\u00fcfen, ob \u00fcberhaupt eine Richtung aktiv ist\n        direction = direction.normalized() # Normalisieren auf Vektor der L\u00e4nge 1\n    # Bewegung anwenden: Aktuelle Position + (Richtung * Geschwindigkeit * Zeit seit letztem Frame)\n    position += direction * speed * delta<\/pre><\/div>\n\n\n\n
      Erkl\u00e4rung des neuen Codes:<\/h4>\n\n\n\n
        \n
      • var speed = 200<\/code>: Eine neue Variable speed<\/code> wird deklariert und initialisiert. var<\/code> ist das Schl\u00fcsselwort f\u00fcr Variablen. Sie speichert, wie viele Pixel pro Sekunde sich der Sprite bewegen soll.<\/li>\n\n\n\n
      • var direction = Vector2.ZERO<\/code>: Vector2<\/code> ist ein eingebauter Godot-Datentyp, der ein Paar von 2D-Koordinaten (x<\/code>, y<\/code>) darstellt. Perfekt f\u00fcr Positionen, Richtungen oder Geschwindigkeiten in 2D. Vector2.ZERO<\/code> ist eine Abk\u00fcrzung f\u00fcr Vector2(0, 0)<\/code>. Wir initialisieren hiermit einen Vektor, der die aktuelle Bewegungsrichtung speichern wird.<\/li>\n\n\n\n
      • Input.is_action_pressed(\"...\")<\/code>: Dies ist die Funktion, um abzufragen, ob die Taste(n) f\u00fcr die genannte Input Action gerade gedr\u00fcckt werden. Sie gibt true<\/code> oder false<\/code> zur\u00fcck.<\/li>\n\n\n\n
      • direction.x += 1<\/code>, etc.: Abh\u00e4ngig davon, welche Bewegungstasten gedr\u00fcckt sind, addieren oder subtrahieren wir 1 zu den X- oder Y-Komponenten unseres direction<\/code>-Vektors. Zum Beispiel, wenn nur „move_right“ gedr\u00fcckt wird, ist direction<\/code> am Ende Vector2(1, 0)<\/code>. Wenn „move_right“ und „move_down“ gleichzeitig gedr\u00fcckt werden, wird direction<\/code> Vector2(1, 1)<\/code>.
        Hinweis:<\/em> in Godot 2D geht Y nach unten.<\/li>\n\n\n\n
      • if direction.length() > 0: direction = direction.normalized()<\/code>: Wenn wir diagonal laufen (z.B. rechts und runter, Vector2(1, 1)<\/code>), ist die L\u00e4nge des Richtungsvektors gr\u00f6\u00dfer als 1 (genau: Wurzel von 2<\/span><\/span><\/span>\u200b<\/span><\/span><\/span><\/span><\/span><\/span><\/span>). Um zu verhindern, dass die diagonale Bewegung schneller ist als die horizontale oder vertikale, normalisieren wir den Vektor. normalized()<\/code> gibt einen neuen Vektor mit derselben Richtung, aber der L\u00e4nge 1 zur\u00fcck. So hat die Richtung immer die L\u00e4nge 0 (kein Input) oder 1 (Input in eine beliebige Richtung). Wir pr\u00fcfen length() > 0<\/code>, damit wir nicht versuchen, einen Nullvektor zu normalisieren, was einen Fehler geben w\u00fcrde.<\/li>\n\n\n\n
      • position += direction * speed * delta<\/code>: Dies ist die Zeile, die die Position des Sprites tats\u00e4chlich aktualisiert. position<\/code> ist eine eingebaute Eigenschaft, die die aktuelle Position des Nodes speichert (ein Vector2<\/code>). Wir addieren zu der aktuellen Position den Bewegungsvektor. Dieser Bewegungsvektor wird berechnet, indem wir die normierte direction<\/code> (L\u00e4nge 0 oder 1) mit unserer speed<\/code> (Pixel pro Sekunde) und delta<\/code> (Zeit seit letztem Frame in Sekunden) multiplizieren. Das Ergebnis ist die Strecke, die der Sprite in diesem einen Frame zur\u00fccklegen soll. Das +=<\/code> addiert diese Strecke zur aktuellen position<\/code>.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        Schritt 3: Script speichern und Scene ausf\u00fchren<\/h3>\n\n\n\n
          \n
        1. Speichere dein Script (Strg + S).<\/li>\n\n\n\n
        2. F\u00fchre die Scene aus (F6 oder F5).<\/li>\n<\/ol>\n\n\n\n
          Ergebnis:<\/h4>\n\n\n\n
          Du siehst nun das rotierende Godot-Logo, das du mit den von dir konfigurierten Tasten (Pfeiltasten oder WASD) bewegen kannst!<\/p>\n\n\n\n
          \n\n\n\n
          Dein n\u00e4chster Schritt<\/h3>\n\n\n\n
          Du hast gelernt, wie man Input Actions<\/strong> in Godot definiert und diese dann in GDScript nutzt, um unseren Sprite mit der Tastatur zu bewegen. Du verstehst jetzt die grundlegende Struktur f\u00fcr Spieler-Input und die Bedeutung von Vector2<\/code> sowie delta<\/code> f\u00fcr eine fl\u00fcssige, bildratenunabh\u00e4ngige Bewegung.<\/p>\n\n\n\n
          Als N\u00e4chstes tauchen wir in das Thema Kollisionen ein \u2013 wie unser Sprite mit anderen Objekten in der Welt interagieren kann.<\/p>\n","protected":false},"excerpt":{"rendered":"
          Nachdem wir unseren Sprite mit einem Script zum Rotieren gebracht haben, ist es an der Zeit, ihm Interaktion mit der Spieler:in zu erm\u00f6glichen.…<\/p>\n","protected":false},"author":2,"featured_media":629,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[33],"tags":[35,34,38],"class_list":["post-576","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-godot","tag-2d-game","tag-godot","tag-input-management"],"_links":{"self":[{"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/posts\/576","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/comments?post=576"}],"version-history":[{"count":5,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/posts\/576\/revisions"}],"predecessor-version":[{"id":613,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/posts\/576\/revisions\/613"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/media\/629"}],"wp:attachment":[{"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/media?parent=576"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/categories?post=576"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staratnight.de\/blog\/wp-json\/wp\/v2\/tags?post=576"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}