So bauen Sie KI-NPCs in Godot | Anleitung 2026
So bauen Sie KI-NPCs in Godot im Jahr 2026: HTTPRequest und eine Modell-API, das Neocortex Godot SDK, ein lokales Modell mit NobodyWho und das Player2-Plugin.
Sercan AltundasFounder of Neocortex
· 9 Min. Lesezeit

Sie bauen einen KI-NPC in Godot, indem Sie das, was der Spieler sagt, an ein Sprachmodell schicken und die Antwort anzeigen oder sprechen lassen. Das geschieht über den eigenen HTTPRequest-Knoten von Godot und eine Modell-API, über ein Charakter-SDK oder über ein Add-on, das ein Modell auf dem Rechner des Spielers ausführt. Godot hat keine eigene KI-Charakterfunktion. Jeder Weg braucht deshalb GDScript oder ein Add-on.
Dieser Leitfaden richtet sich an Godot-4-Entwickler, die Charaktere wollen, die in eigenen Worten antworten statt aus einem Dialogbaum. Er beschreibt vier Wege: HTTPRequest mit einer Modell-API, das Neocortex Godot SDK, ein lokales Modell mit NobodyWho und das Player2 AI NPC Plugin. Jeder Weg hat seine Schritte, Voraussetzungen und Kosten. Danach folgen eine Vergleichstabelle, Tipps für alle Wege und häufige Fragen.
4 Wege, KI-NPCs in Godot zu bauen
Alle vier beginnen mit einem Knoten in Ihrer Szene, der den Charakter darstellt, und einer Eingabe für den Spieler, einem LineEdit oder einem Mikrofon. Sie unterscheiden sich darin, wo das Modell läuft, wer es bezahlt und wie viel GDScript Sie schreiben.
Methode 1: HTTPRequest und eine Modell-API
Dieser Weg nutzt nur, was mit Godot mitgeliefert wird. Der HTTPRequest-Knoten ist "a node with the ability to send HTTP requests", also kann ein Skript die Zeile des Spielers an einen Modellanbieter schicken und die Antwort lesen. Als Beispiel nutzen wir die Responses API von OpenAI.
Was Sie brauchen: einen API-Schlüssel eines Modellanbieters und etwas GDScript.
- Einen API-Schlüssel erstellen. Bei OpenAI erstellen Sie ihn unter platform.openai.com/api-keys.
- Einen HTTPRequest-Knoten hinzufügen. Machen Sie ihn zum Kind Ihrer NPC-Szene und verbinden Sie sein Signal
request_completedmit einer Funktion im NPC-Skript. - Den Charakter schreiben. Halten Sie eine Systemanweisung als Zeichenkette bereit, mit Name, Rolle, Tonfall und Grenzen des Charakters.
- Die Zeile senden. Bauen Sie einen JSON-Body mit dem Modell, den Anweisungen und der Nachricht des Spielers und rufen Sie dann
request()auf, mithttps://api.openai.com/v1/responses, den HeadernAuthorization: Bearer <key>undContent-Type: application/json, der POST-Methode und dem Body. - Die Antwort lesen. Im Handler für
request_completedlesen Sie den Body als JSON und schreiben den Text in ein Label oder RichTextLabel über dem NPC. - Den Verlauf behalten. Speichern Sie die letzten Wortwechsel in einem Array und schicken Sie sie mit jeder Anfrage mit. Das Modell vergisst alles zwischen zwei Aufrufen.
- Die Extras bauen. Stimme, Lippensynchronisation und Aktionen sind Ihre eigene Arbeit: weitere API-Aufrufe für Sprache und Ihre eigenen Regeln, um Antworten in Spielmechanik zu übersetzen.
- Den Schlüssel schützen. Die Dokumentation von Godot empfiehlt TLS und warnt davor, sensible Informationen zu senden. Ein Schlüssel in einem exportierten Spiel lässt sich auslesen. Stellen Sie deshalb vor der Veröffentlichung einen eigenen Server vor den Anbieter.
Kosten: Godot ist kostenlos. Sie zahlen die Tarife des Anbieters pro Token.
Wo es hakt: Gedächtnis, Stimme, Aktionen, Sicherheit und der Schlüssel-Server sind alle Ihre Aufgabe, und Sie müssen sie pflegen.
Methode 2: Das Neocortex Godot SDK
Neocortex ist unser Produkt, lesen Sie diesen Abschnitt also mit dieser Information im Kopf. Sie gestalten den Charakter in einem visuellen Editor im Browser und nutzen ihn dann in Godot über ein Open-Source-Add-on (Apache 2.0). Persönlichkeit, Wissen, Emotionen, Stimme und Aktionen sind Knoten im Editor. In Godot fügen Sie fertige Knoten hinzu. Die Seite Godot-KI-NPC hat die vollständige Liste.
Was Sie brauchen: Godot 4.7 oder neuer und ein Neocortex-Konto mit API-Schlüssel.
- Den Charakter erstellen. Öffnen Sie im Dashboard Characters, klicken Sie auf Create New Character, geben Sie einen Namen ein und klicken Sie auf Create. Bauen Sie ihn im Node-Editor.
- Im Browser testen. Klicken Sie oben rechts im Editor auf Play.
- Einen API-Schlüssel erstellen. Öffnen Sie im Dashboard API Keys.
- Das Add-on installieren. Laden Sie das neueste Release von
https://github.com/neocortex-link/neocortex-godot-sdk/releases/latestherunter und kopieren Sieaddons/neocortex-godot-sdkin den OrdneraddonsIhres Projekts. - Aktivieren. Öffnen Sie Project > Project Settings > Plugins und aktivieren Sie Neocortex. Fügen Sie Ihren API-Schlüssel im Neocortex-Dock ein.
- Einen Chat in einem Schritt hinzufügen. Wählen Sie Project > Tools > Neocortex > Complete Text Chat oder Complete Voice Chat. Das fügt der Szene einen funktionierenden Chat hinzu. Wählen Sie den Charakter im Dropdown des Inspectors.
- In Ihr Spiel einbinden. Nutzen Sie den Knoten
NeocortexSmartAgentfür den Charakter,NeocortexAudioReceiverfür das Mikrofon,NeocortexFaceAnimatorfür Lippensynchronisation mit Blend Shapes im ARKit-Stil,NeocortexInteractablefür Objekte, die der Charakter kennen soll, undNeocortexEventLoggerfür Ereignisse. Aktionsknoten im Editor senden Aktionsnamen, auf die Ihr GDScript reagieren kann. - Die Beispiele öffnen. Sieben Beispielszenen öffnen sich über das Neocortex-Dock, zusammen mit einem Starter: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating und Quiz Show.
Grenzen, die Sie kennen sollten: Die Aufnahme endet nach 29 Sekunden, Töne, die kürzer als 0.15 Sekunden sind, werden nicht gesendet, und Chat-Anfragen laufen nach 30 Sekunden ab.
Kosten: Starter kostet €9, Pro €29 und Team €99 im Monat bei Jahresabrechnung, oder €11, €35 und €119 bei monatlicher Abrechnung. Die kommerzielle Nutzung braucht Pro oder Team. Siehe Preise.
Wo es hakt: Charaktere laufen in unserer Cloud, das Spiel braucht also eine Verbindung. Ein exportiertes Spiel enthält seinen API-Schlüssel, richten Sie deshalb Nutzungslimits ein. Gruppenchat braucht Pro oder Team, das Quiz braucht Team, und unsere Dokumentation listet nicht jedes Exportziel auf.
Methode 3: Ein lokales Modell mit NobodyWho
NobodyWho ist eine Open-Source-Inferenz-Engine, die Sprachmodelle auf dem Rechner des Spielers ausführt, mit einem Godot-Add-on. Die Readme sagt, es braucht "no API keys" und hat keine versteckten Gebühren.
Was Sie brauchen: Godot 4.6 oder neuer (laut dessen Godot-Dokumentation) und ein Modell im GGUF-Format.
- Installieren. Öffnen Sie in Godot den Tab AssetLib, suchen Sie nach NobodyWho, laden Sie es herunter und importieren Sie es mit angehakter Option Ignore asset root. Oder kopieren Sie
addons/nobodywhoaus einem Release in Ihr Projekt. Starten Sie den Editor neu oder laden Sie ihn neu. - Ein Modell wählen. Jedes GGUF-Modell funktioniert. Die Readme schlägt Qwen3 0.6B zum Einstieg vor. Entfernte Modelle laden beim ersten Gebrauch herunter und werden zwischengespeichert.
- Den Chat erstellen. Rufen Sie in einem Skript
await NobodyWhoChat.create(<model path>, {})auf. - Eine Frage stellen. Rufen Sie
chat.ask(<player text>)auf und warten Sie mitawaitaufcompleted()des Ergebnisses. Die Dokumentation sagt, Sie sollen den zurückgegebenen Wert immer sofort mit await abwarten. - Die Rolle schreiben. Geben Sie dem Chat die Anweisungen für den Charakter. Folgen Sie dabei dem Abschnitt Chat der NobodyWho-Dokumentation.
- Ihre Zielplattformen prüfen. NobodyWho unterstützt Godot für Desktop und Android. Einen Export für iOS oder das Web gibt es nicht.
Kosten: Kostenlos für die kommerzielle Nutzung unter EUPL-1.2. Wenn Sie den eigenen Code von NobodyWho ändern, müssen diese Änderungen als Open Source veröffentlicht werden.
Wo es hakt: Antwortgeschwindigkeit und Qualität hängen von der Hardware des Spielers und der Modellgröße ab, und das Modell vergrößert den Download. Die Sprachfunktionen sind für die Engine aufgeführt. Prüfen Sie, ob die Godot-Anbindung sie hat, bevor Sie fest damit planen.
Methode 4: Das Player2 AI NPC Plugin
Player2 ist eine Desktop-App mit lokalen APIs für Spiele und Mods. Das Godot-Plugin "uses free AI APIs from the Player2 App" und verbindet sich, solange die App geöffnet ist.
Was Sie brauchen: Godot 4.5 (so in der Asset Library angegeben), eine Entwickler-Client-ID von Player2 und die Player2-App.
- Das Plugin installieren. Holen Sie es aus der Godot Asset Library oder von GitHub und ziehen Sie den Ordner
addonsin Ihr Projekt. - Ihre Client-ID eintragen. Erstellen Sie eine unter player2.game/profile/developer und tragen Sie sie unter Project Settings > Player2 > Game Key ein.
- Den NPC-Knoten hinzufügen. Fügen Sie der Szene einen Player2 AI NPC-Knoten hinzu und bearbeiten Sie die Beschreibung des Agenten.
- Den Chat verbinden. Rufen Sie die Funktion
chatdes Knotens mit dem Text des Spielers auf und verbinden Sie das Signalchat_receivedmit der Anzeige der Antworten. Rufen Sienotifyauf, um den Agenten über Ereignisse in der Welt zu informieren. - Stimme hinzufügen. Setzen Sie eine Voice ID in der Character Config oder fügen Sie einen Knoten
Player2TTShinzu. Für Spracheingabe fügen SiePlayer2STThinzu und aktivieren Sie die Audioeingabe unter Project Settings > Audio. - Player2 starten. Öffnen Sie die Player2-App. Das Plugin verbindet sich automatisch.
Kosten: Laut den Seiten von Player2 kostenlos für Entwickler. Das Plugin steht unter GPLv3.
Wo es hakt: Laut der Seite von Player2 funktionieren die lokalen APIs nur, wenn die App geöffnet ist. Planen Sie deshalb ein, was Spieler ohne die App erleben. Prüfen Sie die GPLv3-Lizenz für Ihr Projekt.
Die vier Wege im Vergleich
| Faktor | HTTPRequest und eine API | Neocortex SDK | NobodyWho | Player2-Plugin |
|---|---|---|---|---|
| Wo der Charakter definiert wird | Zeichenketten in GDScript | Visueller Node-Editor im Browser | Ihr GDScript | Knotenbeschreibung in Godot |
| Wo das Modell läuft | Cloud des Anbieters | Neocortex-Cloud | Gerät des Spielers | Über die Player2-App |
| Godot-Version | 4.x mit HTTPRequest | 4.7 oder neuer | 4.6 oder neuer | 4.5 angegeben |
| Stimme | Selbst bauen | Enthalten, mit Lippensynchronisation | Für die Engine aufgeführt | TTS- und STT-Knoten |
| Lizenz des Add-ons | Keine nötig | Apache 2.0 | EUPL-1.2 | GPLv3 |
| Startkosten | Token-Tarife des Anbieters | Ab €9 im Monat | Kostenlos | Kostenlos für Entwickler |
| Nötige Kenntnisse | GDScript, HTTP, ein Server | Add-on kopieren, Knoten hinzufügen | GDScript, Modellwahl | Einen Knoten hinzufügen |
HTTPRequest gibt die volle Kontrolle und braucht am meisten Code. NobodyWho ist der Offline-Weg, abhängig von der Hardware des Spielers. Neocortex hält Charaktere in einem gehosteten Editor mit Stimme, Lippensynchronisation und Beispielen. Player2 ist der schnellste Knoten zum Hinzufügen und hängt von seiner App ab.
Tipps für bessere Ergebnisse in Godot
Diese Gewohnheiten helfen bei jedem Weg.
- Schlüssel aus Exporten heraushalten. Alles in einem exportierten Projekt lässt sich auslesen. Halten Sie Einstellungsdateien mit Schlüsseln aus der Versionsverwaltung heraus und nutzen Sie einen Server oder Nutzungslimits pro Spieler und pro Charakter.
- Zeigen, dass der NPC den Spieler gehört hat. Wechseln Sie sofort in eine Animation "denkt nach" oder zeigen Sie ein Label, wenn die Anfrage startet. So wirkt das Warten auf die Antwort nie wie ein eingefrorenes Spiel.
- Dem Charakter die Szene erklären. Geben Sie mit jeder Nachricht nahe Objekte und letzte Ereignisse mit, damit der NPC über den Raum spricht, in dem er steht.
- Die letzte Entscheidung über Aktionen trifft GDScript. Halten Sie eine kurze Liste der Aktionen, die ein Charakter anfordern darf, und prüfen Sie jede im Code, bevor sie läuft.
- Für den Plot einen Dialogbaum nutzen. Behalten Sie die Zeilen, die die Handlung vorantreiben, in einem Add-on für geskriptete Dialoge und überlassen Sie dem KI-Charakter alles darum herum. Unser Beitrag zu Godot-Plugins listet Add-ons für den geskripteten Teil.
Die richtige Methode für Godot wählen
HTTPRequest und eine Modell-API passt, wenn Sie keine Add-ons wollen, jede Anfrage selbst steuern möchten und einen kleinen Server für den Schlüssel betreiben können.
Das Neocortex SDK passt, wenn Sie Charaktere visuell gestalten, im Browser testen und Stimme, Lippensynchronisation, Aktionen und Beispiele in Godot 4.7 haben wollen. Derselbe Charakter funktioniert auch in Unity und Unreal Engine.
NobodyWho passt, wenn das Spiel offline ohne laufende Kosten funktionieren muss, auf Desktop oder Android.
Das Player2-Plugin passt, wenn Ihre Spieler die Player2-App bereits nutzen oder wenn Sie einen Prototyp mit den wenigsten Schritten bauen.
Weitere Optionen finden Sie unter die besten KI-NPC-Tools für Godot. Wenn Sie noch eine Engine wählen, lesen Sie Godot vs Unity.
Häufig gestellte Fragen
Kann ich KI-NPCs in Godot kostenlos bauen?
Ja. NobodyWho ist kostenlos und führt das Modell lokal aus, Player2 ist für Entwickler kostenlos. Eine Modell-API, die Sie selbst aufrufen, berechnet pro Token.
Hat Godot integrierte KI-NPCs?
Nein. Godot bietet den HTTPRequest-Knoten für Web-Aufrufe, aber kein Sprachmodell und kein System für Charaktere. Unser Beitrag Godot AI behandelt, was es rund um die Engine gibt.
Welche Godot-Version brauche ich?
Neocortex braucht Godot 4.7 oder neuer, NobodyWho 4.6 oder neuer, und das Player2-Plugin gibt 4.5 an. HTTPRequest ist Teil von Godot 4.
Kann ein KI-NPC in Godot offline laufen?
Ja, mit einem lokalen Modell wie NobodyWho auf Desktop oder Android. Cloud-Wege, einschließlich Neocortex, brauchen eine Verbindung.
Ist das Neocortex Godot SDK Open Source?
Ja. Es steht unter Apache 2.0, und der Quellcode liegt auf GitHub unter neocortex-link/neocortex-godot-sdk. Fehlerberichte und Ideen sind dort willkommen.
Funktionieren KI-NPCs in Godot in Web-Exporten?
Das hängt vom Weg ab. NobodyWho hat keinen Web-Export. Für Browserspiele außerhalb von Godot bietet Neocortex außerdem ein Web SDK an.






