ChatGPT-NPCs in Unity: So lassen Sie Figuren sprechen
NPCs mit ChatGPT in Unity sprechen lassen: OpenAI API per UnityWebRequest aufrufen, sehen, was offen bleibt, und eine vertonte Figur schneller bauen.
Sercan AltundasFounder of Neocortex
· 9 Min. Lesezeit

"ChatGPT-NPC" ist für die meisten Unity-Entwickler das erste Bild von einer KI-Figur: Was der Spieler tippt, geht an ein Sprachmodell, und die Antwort erscheint über dem Kopf des NPCs. Dieser Leitfaden baut genau das mit der OpenAI API. Danach zeigen wir, was dabei offen bleibt, und wie dieselbe Figur mit dem Neocortex Unity SDK aussieht.
Weg 1: die OpenAI API selbst aufrufen
Sie brauchen einen OpenAI-API-Schlüssel und ein Unity-Projekt. Der NPC führt eine Liste von Nachrichten, beginnend mit einem System-Prompt, der sagt, wer die Figur ist, und schickt die ganze Liste bei jeder Äußerung des Spielers:
using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using UnityEngine;
using UnityEngine.Networking;
public class ChatGptNpc : MonoBehaviour
{
[Serializable] class Message { public string role; public string content; }
[Serializable] class ChatRequest { public string model; public Message[] messages; }
[Serializable] class Choice { public Message message; }
[Serializable] class ChatResult { public Choice[] choices; }
[SerializeField] private string apiKey; // for local testing only, never ship it
private readonly List<Message> history = new()
{
new Message { role = "system", content = "You are Brannoch, a gruff village blacksmith. Answer in one or two sentences." }
};
public IEnumerator Ask(string playerLine)
{
history.Add(new Message { role = "user", content = playerLine });
string body = JsonUtility.ToJson(new ChatRequest { model = "MODEL_NAME", messages = history.ToArray() });
using var request = new UnityWebRequest("https://api.openai.com/v1/chat/completions", "POST");
request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(body));
request.downloadHandler = new DownloadHandlerBuffer();
request.SetRequestHeader("Content-Type", "application/json");
request.SetRequestHeader("Authorization", "Bearer " + apiKey);
yield return request.SendWebRequest();
if (request.result != UnityWebRequest.Result.Success) { Debug.LogWarning(request.error); yield break; }
Message reply = JsonUtility.FromJson<ChatResult>(request.downloadHandler.text).choices[0].message;
history.Add(reply);
Debug.Log(reply.content); // show it in your dialogue UI
}
}Ersetzen Sie MODEL_NAME durch ein aktuelles Modell aus der Dokumentation von OpenAI, rufen Sie StartCoroutine(npc.Ask("Got any work?")) auf, und Brannoch antwortet. Das ist ein funktionierender Prototyp in etwa vierzig Zeilen.
Was der Prototyp Ihnen überlässt
Das erste Gespräch ist der leichte Teil. Damit es im Spiel funktioniert, müssen Sie Folgendes lösen:
- Der Schlüssel. Ein OpenAI-Schlüssel in einem Build kann von jedem herausgelesen werden und belastet Ihr gesamtes Konto. Zwischen Spiel und API brauchen Sie einen eigenen Server.
- Stimme. Spracherkennung für den Spieler, Sprachausgabe für die Antwort und Streaming dazwischen, sonst wartet jede Antwort, bis beide Schritte fertig sind. Unser Leitfaden zur Sprach-Pipeline erklärt das im Detail.
- Emotionen und Aktionen. Die Antwort ist reiner Text. Um Animation oder Spielmechanik zu steuern, lassen Sie JSON erzeugen, parsen es und fangen die Fälle ab, in denen es fehlerhaft zurückkommt.
- Verlauf. Die Liste wächst mit jeder Zeile, und mit ihr Kosten und Verzögerung. Sie brauchen Kürzung oder Zusammenfassungen.
- Die Rolle halten. Ein System-Prompt allein bricht schnell, wenn Spieler drängen. Siehe wie Sie KI-NPCs in ihrer Rolle halten.
- Kostenkontrolle. Nichts hindert einen Spieler daran, den ganzen Tag auf Ihre Rechnung zu sprechen.
Weg 2: dieselbe NPC mit Neocortex
Mit Neocortex entwerfen Sie Brannoch einmal in einem Browser-Editor, mit Persönlichkeit, Welt, Wissensbasis, Stimme und Aktionen. Das Unity SDK übernimmt den Rest:
- Fügen Sie das Paket in Unity über die Git-URL hinzu:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Fügen Sie Ihren API-Schlüssel unter Tools > Neocortex > Settings ein.
- Klicken Sie im Hierarchy-Fenster mit der rechten Maustaste und wählen Sie Neocortex > Complete Voice Chat. Wählen Sie dann Brannoch im Dropdown des Smart Agent.
- Drücken Sie Play und sprechen Sie.
Im Code ist eine Textfrage mit gesprochener Antwort ein einziger Aufruf:
agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgentJede Antwort kommt als Zeilen mit einer Emotion pro Zeile, dazu Aktionen mit der ID des Objekts, auf das sie zielen. So hängen Animation und Spielmechanik an Unity-Events statt an geparstem Text. Unser Schritt-für-Schritt-Tutorial zu KI-Charakteren in Unity zeigt das ganze Setup.
Nebeneinander
| OpenAI API direkt | Neocortex Unity SDK | |
|---|---|---|
| Erste Textantwort | Etwa 40 Zeilen Code | Kein Code |
| Stimme rein und raus | Selbst bauen: STT, TTS, Streaming | Eine Komponente, gestreamt |
| Emotion pro Zeile | Per Prompt anfordern und parsen | Eingebaut, 17 Emotionen |
| Aktionen | Per Prompt JSON anfordern und prüfen | Im Editor definiert, als Daten gesendet |
| Schutz des Schlüssels | Eigener Server | Limits pro Spieler und pro Figur je Schlüssel |
| WebGL-Mikrofon | Nicht in Unity | Vorlage inklusive |
| Figurendesign | Ein System-Prompt | Visueller Editor mit Test im Browser |
Häufige Fragen zum Weg mit eigener Programmierung
- "Die Antwort wird abgeschnitten." Das Modell hat sein Ausgabelimit erreicht. Bitten Sie im System-Prompt um kurze Antworten, das sind auch die besseren Dialoge.
- "Es hat vergessen, was wir gesagt haben." Sie müssen bei jeder Anfrage den ganzen Verlauf mitsenden. Ein Sprachmodell erinnert sich zwischen Anfragen an nichts.
- "Kann ich es als WebGL-Build ausliefern?" Nicht mit dem Schlüssel darin: Jeder kann ihn im Netzwerk-Tab des Browsers lesen. Schicken Sie die Anfragen über Ihren eigenen Server.
Nächste Schritte
Um mit Neocortex in Unity weiterzugehen, fügen Sie Sprachchat und Sprachausgabe für geskriptete Zeilen hinzu. Wenn Sie beim Prototypen lieber ein Modell auf Ihrem eigenen Rechner laufen lassen möchten, lesen Sie wie Sie ein LLM lokal in Unity ausführen. Alle Tutorials stehen im Leitfaden zum Bauen von KI-NPCs.
Stand November 2026. Neocortex ist nicht mit OpenAI verbunden.
Häufig gestellte Fragen
Kann ich ChatGPT für NPCs in Unity verwenden?
Ja. Sie können die OpenAI API aus Unity mit UnityWebRequest und einem System-Prompt aufrufen, der die Figur beschreibt. Für Stimme, Emotionen, Aktionen und Schlüssel-Limits ohne Eigenbau gibt Ihnen Neocortex über sein Unity SDK eine fertige Figur.
Ist es sicher, einen OpenAI-API-Schlüssel in ein Unity-Spiel zu legen?
Nein. Alles in einem Build kann herausgelesen werden, und ein OpenAI-Schlüssel gibt vollen Zugriff auf die Ausgaben Ihres Kontos. Wenn Sie OpenAI direkt aufrufen, leiten Sie die Anfragen über Ihren eigenen Server. Neocortex-Schlüssel können Nutzungslimits pro Spieler und pro Figur tragen, die unsere Server durchsetzen, und Sie können einen Schlüssel im Dashboard deaktivieren.
Wie halte ich einen ChatGPT-NPC in seiner Rolle?
Schreiben Sie einen konkreten System-Prompt, beschreiben Sie die Welt, begrenzen Sie, was die Figur weiß, und testen Sie mit Spielern, die versuchen, sie zu brechen. Neocortex-Figuren entstehen in einem Editor mit Welt, Wissensbasis und Aktionen und bleiben in der Welt, die Sie beschreiben.
Wie bringe ich einen ChatGPT-NPC zum Sprechen?
Sie brauchen Spracherkennung für den Spieler, Sprachausgabe für die Antwort und Streaming dazwischen, damit die Wartezeit kurz bleibt. Das Neocortex Unity SDK erledigt alle drei mit einer Komponente.






