Half-Life 2 KI-NPC-Mod: Trupps und Begleiter per Sprache
Planen Sie einen Half-Life-2-KI-NPC-Mod auf Source SDK 2013: einen Rebellentrupp, den Sie per Sprache befehligen, einen Begleiter, der antwortet, Story-Momente im Versteck und ein Quiz-Terminal.
Neocortex TeamThe team behind Neocortex
· 6 Min. Lesezeit

Half-Life 2 hat eine Trupp-KI, die auf Tastendrücke hört, und eine Welt voller Menschen, die nur sagen, was das Skript erlaubt. Die Rebellen folgen Ihnen, aber Sie können ihnen nichts sagen; die Bürger reden, aber nie darüber, was gerade passiert ist. Ein Half-Life-2-KI-NPC-Mod behebt beides: Rebellen, die laut auf Ihre Befehle reagieren, ein Begleiter, der über den Kampf spricht, den Sie gerade überlebt haben, und Story-Szenen, die sich nach den Entscheidungen des Spielers biegen. Neocortex liefert die KI-Charaktere, Gesprächsabläufe, Quizze und lokale Sprachbefehle, und Source SDK 2013 gibt Ihnen den Code, um sie einzubinden.
Screenshot: Half-Life 2 © Valve
Sprachbefehle für einen Rebellentrupp
Half-Life 2 erlaubt Ihnen bereits, Ihren Trupp an einen Punkt zu schicken und zurückzurufen. Sprachbefehle ersetzen den Tastendruck durch Sprache: „geh vor“, „halt hier“, „in Deckung hinter dem Auto“, „sammelt euch bei mir“.
Im Neocortex-Dashboard entwerfen Sie das Befehlsset als Akteure, Aktionen und Objekte: Akteur „Trupp“, Aktionen „bewegen“, „halten“ und „Deckung“, Objekte wie „ich“, „Auto“ und „Tür“. Spieler sprechen natürlich, und der Mod erhält passende Befehle sofort, auch mehrere Aktionen und Mengen in einem Satz: „zwei von euch sichern die Tür, der Rest folgt mir“. Ihr Code bildet sie auf den vorhandenen Trupp-Code ab.
Es funktioniert mit Push-to-Talk oder dauerhaftem Zuhören, in mehreren Sprachen, und läuft auf dem Rechner des Spielers, sodass Befehle mitten im Feuergefecht ankommen, ohne Umweg über die Cloud.
Voice Commands ist ein lizenziertes SDK: Kontaktieren Sie uns für eine Voice-Commands-Lizenz.
Ausgearbeitetes Beispiel: Mara Venn und das Versteck
Der Begleiter. Erstellen Sie einen eigenen Begleiter, etwa Mara Venn, eine ehemalige Feldsanitäterin, die sich dem Widerstand anschloss, nachdem ihre Klinik geschlossen wurde. Ihr Mod sendet die Frage des Spielers zusammen mit dem, was das Spiel weiß: nahe Objekte (die Barrikade, die Munitionskiste, das Funkgerät) und aktuelle Ereignisse („zwei Trupp-Mitglieder gefallen“, „der Spieler nahm den linken Tunnel“, „Gesundheit unter 30“). Mara antwortet mit Stimme und trägt in jeder Zeile einen Emotions-Tag. Sie kann Aktionen zurückgeben, etwa ein Medkit übergeben oder das Tor öffnen, nach dem der Spieler gefragt hat.
Der Trupp widerspricht. Der Gruppenchat (Pro- und Team-Tarife) lässt bis zu sechs Charaktere ein Gespräch teilen, sodass der ganze Trupp über den nächsten Zug streiten kann.
Der Keller. Mara führt den Spieler in ein Kellerversteck, wo er das Vertrauen eines misstrauischen Zellenführers gewinnen muss, bevor dieser die Route aus der Stadt verrät. Ein Gesprächsablauf legt die Abschnitte fest: Vorstellung, beweisen, auf welcher Seite man steht, der Deal, die Route. Der Charakter lenkt das Gespräch durch sie hindurch, egal wie der Spieler formuliert, und die API liefert Checkpoint-Schlüsselwörter wie TRUST_EARNED oder ROUTE_SHARED. Ihr Mod reagiert, indem er die versteckte Tür öffnet oder den Führer erscheinen lässt, der Sie hinausbringt.
Das Terminal. In der Ecke bringt ein Terminal neuen Rekruten bei: welche feindlichen Einheiten man meiden sollte, wie man dem Trupp Signale gibt, welche Vorräte man mitnimmt. Die Quiz-Engine von Neocortex (Team-Tarif) führt Fragen und Punktestand, und eine richtige Serie kann dem Spieler Munition oder eine Abkürzung einbringen.
Screenshot: Half-Life 2 © Valve
Source-SDK-2013-Zweige für einen Half-Life-2-KI-NPC-Mod
Half-Life 2 läuft auf Source. Ein Mod ist ein Ordner mit eigener gameinfo.txt, Inhalten und zwei C++-Bibliotheken, die aus dem Code von Valve gebaut werden: eine Server-DLL für NPC-KI, Trupps und Spiellogik sowie eine Client-DLL für HUD, VGUI-Panels und lokale Effekte. Wählen Sie zuerst die Basis:
| Basis | Was sie enthält | Stand |
|---|---|---|
Source SDK 2013 singleplayer-Branch | Der Code für die Half-Life-2-Einzelspieler-Kampagne | Seit 2015 kein Code-Update; läuft auf dem 32-Bit-Source-SDK-Base-2013-Singleplayer |
Source SDK 2013 master-Branch | Der Multiplayer-Code | Im Februar 2025 mit dem Spielcode von Team Fortress 2 und 64-Bit-Builds aktualisiert; Valve pflegt ihn weiterhin |
| Mapbase | Eine von der Community gepflegte Basis für Einzelspieler-Mods | Version 8.0 erschien im Juli 2025 mit neuen Entitäten, Korrekturen und einer VScript-Implementierung für Map-Skripte |
Für eine Story-Mod wie das Versteck oben starten Sie vom singleplayer-Branch oder von Mapbase.
Neocortex aus einer Source-DLL aufrufen
Die SDK-Header enthalten die Steamworks-HTTP-Schnittstelle, und viele Modder nutzen stattdessen libcurl. In beiden Fällen führen Sie Anfragen in einem Worker-Thread aus und geben Ergebnisse an die Spielschleife zurück. Ein Chat-Aufruf aus der Client- oder Server-DLL mit libcurl:
// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
// "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
std::string response;
CURL* curl = curl_easy_init();
curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_perform(curl);
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return response; // sessionId, lines with emotions, actions and flowState
}Der Mod liest den Spielzustand und sendet ihn zusammen mit der Nachricht des Spielers über /v3/chat an einen Neocortex-Charakter, zeigt die Antwort als Untertitel, spielt die Stimme von /v3/audio/generate oder /v3/audio/stream ab und führt die Aktionen aus, die der Charakter zurückgibt. Gesprächsabläufe liefern Checkpoint-Schlüsselwörter (flowState) in derselben Antwort, die Quiz-Engine läuft über /v3/quiz, und lokale Sprachbefehle wandeln gesprochene Phrasen ohne Umweg über die Cloud in Spielaktionen um, wobei Neocortex Voice Commands auf dem Rechner des Spielers läuft.
Für die Oberfläche können VGUI-Panels in der Client-DLL Untertitel und einen Quiz-Bildschirm zeigen. Die Untertitel und Soundscripts von Source sind für vorab erstellte Zeilen gebaut, daher bekommen Live-KI-Antworten meist ein eigenes Untertitel-Panel, und die erzeugte Stimme wird in einer Datei gespeichert und über die Engine abgespielt.
Vor der Veröffentlichung: die Lizenz des Source-1-SDK
Die Lizenz des Source-1-SDK erlaubt, Mods nur kostenlos zu verbreiten; kostenlose Mods dürfen auf Steam erscheinen. Halten Sie KI-NPC-Mods auf den Einzelspieler beschränkt, setzen Sie sie nie entgegen den Regeln auf Multiplayer-Servern ein, und lassen Sie jeden Spieler seinen eigenen Neocortex-API-Schlüssel verwenden.
Von der leeren Map zum sprechenden Trupp
- Richten Sie Source SDK 2013 ein. Wählen Sie für eine Story-Mod den
singleplayer-Branch oder Mapbase, bauen Sie ihn und starten Sie eine leere Testmap. - Entwerfen Sie Ihre Charaktere im Neocortex-Dashboard: einen Begleiter, einen Zellenführer mit Gesprächsablauf, ein Quiz für das Terminal und ein Befehlsset für den Trupp.
- Rufen Sie die API aus Ihrer Spiel-DLL in einem Worker-Thread auf und verwenden Sie die
sessionIdjeder Antwort erneut. - Bewahren Sie den API-Schlüssel in einer Konfigurationsdatei auf, die der Spieler ausfüllt, niemals fest im Code eines Mods, den Sie weitergeben.
- Binden Sie Untertitel, Stimme und Aktionen an, dann ordnen Sie die Sprachbefehle dem vorhandenen Trupp-Code zu.
- Testen Sie im Einzelspieler auf einer Map, bevor Sie zu einer ganzen Kampagne ausbauen.
Wie Sprachbefehle in einem Mod funktionieren, lesen Sie unter lokale Sprachbefehle für Spiel-Mods. Für GoldSrc sehen Sie unseren Leitfaden zum Half-Life-KI-NPC-Mod, und für Source-Sandbox-Server den Beitrag zum KI-NPC- und Quiz-Addon für Garry's Mod. Mara und ihren Trupp können Sie heute im Neocortex-Browser-Editor testen, lange bevor die erste Map kompiliert ist.
Tool-Versionen und Links geprüft im Oktober 2026. Modding-Werkzeuge ändern sich oft; prüfen Sie die Seite jedes Projekts auf die neueste Version.
Häufig gestellte Fragen
Kann man KI-NPCs zu Half-Life 2 hinzufügen?
Ja. Half-Life-2-Mods werden mit Source SDK 2013 von Valve gebaut, das den vollständigen C++-Spielcode bereitstellt, sodass ein Mod eine Web-API aufrufen und auf die Antwort reagieren kann. Neocortex liefert den KI-Charakter, seine Stimme und die Aktionen, die er zurückgibt, und Ihr Mod führt sie aus.
Soll ich den Singleplayer- oder den Multiplayer-Branch von Source SDK 2013 nutzen?
Story-Mods starten meist vom Singleplayer-Branch oder einer darauf aufbauenden Community-Basis wie Mapbase. Der Multiplayer-Branch bekam 2025 ein großes Update mit 64-Bit-Unterstützung und wird weiterhin gepflegt, aber sein Code zielt auf Multiplayer-Spiele. Neocortex funktioniert mit beiden, weil es eine einfache Web-API ist.
Kann ich Half-Life-2-Rebellen per Sprache befehligen?
Ja, mit einem Mod. Half-Life 2 hat bereits Trupp-Befehlscode, und ein Mod kann ihn über Sprache auslösen. Neocortex Voice Commands erkennt natürliche Phrasen auf dem PC des Spielers, daher erreichen „geh vor“, „halt hier“ und „sammelt euch“ Ihren Code sofort und offline.
Kann ich einen Half-Life-2-Mod mit KI-Charakteren verkaufen?
Nein. Die Lizenz des Source-1-SDK erlaubt nur die kostenlose Verbreitung von Mods, kostenlose Mods dürfen aber auf Steam erscheinen. Die Neocortex-Seite eines kostenlosen Mods können Sie im Browser-Editor bauen und testen.






