Garry's Mod KI-NPC-Addon: Smarte NPCs und ein Quizmaster
Bauen Sie ein Garry's Mod KI-NPC-Addon in Lua: smarte NPCs für Sandbox- und Rollenspiel-Server, ein Quizmaster für Mehrspieler mit Rangliste und Sprachbefehle.
Neocortex TeamThe team behind Neocortex
· 6 Min. Lesezeit

Ein Garry's Mod KI-NPC-Addon ist ein Lua-Addon, das die Worte der Spieler über die eingebaute Funktion HTTP() des Spiels an eine KI-Figur schickt und auf die Antwort reagiert. Garry's-Mod-Server leben von dem, was Spieler sich ausdenken, und NPCs, die nur herumstehen, verschenken diese Chance.
Mit Neocortex sprechen die Figuren auf Sandbox- und Rollenspiel-Servern tatsächlich: ein Händler, der feilscht, ein Quizmaster, der ein Spiel für den ganzen Server leitet, und Helfer, die Sprachbefehlen folgen. Neocortex stellt die KI-Figuren, Conversation Flows, die Quiz-Engine und Sprachbefehle auf dem Gerät bereit. Lua verbindet sie mit Ihrem Server.
Screenshot: Garry's Mod © Valve
Was auf dem Server und was auf dem Client läuft
Garry's-Mod-Addons sind Ordner mit Lua-Skripten und Inhalten, die in garrysmod/addons liegen oder über den Steam Workshop abonniert werden. Lua läuft in zwei Realms, und ein KI-NPC-Addon teilt sich sauber zwischen ihnen auf. Das Garry's-Mod-Wiki dokumentiert jede Funktion.
| Aufgabe | Realm | Werkzeug |
|---|---|---|
| NPCs, Entities, Spiellogik | Server | Lua-Entities |
| Aufruf von Neocortex, Verwahrung des API-Schlüssels | Server | HTTP(), http.Fetch, http.Post |
| Antworten an Spieler senden | Server zu Client | Die net-Bibliothek |
| Untertitel und HUD | Client | chat.AddText oder ein eigenes HUD-Panel |
| Sprachwiedergabe | Client | sound.PlayURL |
| Sprachbefehle | Client | Neocortex Voice Commands auf dem Rechner des Spielers |
Ein paar Details sind wichtig. HTTP() startet eine asynchrone Anfrage mit URL, Methode, Headern, Body und Callbacks, und http.Fetch sowie http.Post umhüllen sie für einfache Fälle. Der Erfolgs-Callback wird auch bei Fehlerstatus ausgelöst, deshalb prüfen Sie immer den Code. sound.PlayURL spielt externe Audiodateien ab. Stellen Sie die erzeugte Stimme deshalb über einen kleinen Endpunkt bereit, den Sie kontrollieren. Dann können Clients sie streamen, ohne den API-Schlüssel je zu sehen. Native Module (gmsv_ für den Server, gmcl_ für den Client) gehören in garrysmod/lua/bin und werden mit require geladen. Sie lassen sich aber nicht über ein Workshop-Addon installieren, daher ist alles Native eine separate Installation für Spieler oder Serverbesitzer.
Rollenspiel-NPCs, mit denen Spieler reden können
Geben Sie auf einem Rollenspiel-Server der Stadt eine Besetzung: einen Händler, der feilscht und sich merkt, wer ihn übers Ohr gehauen hat, einen Barkeeper, der die Lore des Servers kennt, eine Polizeileitstelle, die auf Meldungen der Spieler reagiert. Jede Figur bekommt im Neocortex-Editor eine Persönlichkeit, eine Emotionseinstellung und eine Wissensbasis, etwa Ihre Serverregeln, die Orte der Karte und Ihre Wirtschaft.
Spieler drücken auf den NPC und tippen im Chat. Ihr Addon schickt die Nachricht zusammen mit Objekten in der Nähe (die Ladentheke, der Automat, die Gefängnistür) und aktuellen Ereignissen („ein Spieler wurde verhaftet“, „der Bankalarm klingelt“). Die Figur antwortet mit einem Emotions-Tag in jeder Zeile und mit Aktionen wie { "name": "OPEN_DOOR", "targetId": "jail_door" }, die das Addon auf dem Server ausführt.
Der Gruppenchat (Pro- und Team-Tarife) bringt bis zu sechs Figuren in ein Gespräch, sodass eine Bande von NPCs gleichzeitig mit einem Spieler streiten kann. Ein Conversation Flow kann eine längere Szene steuern, etwa das Briefing für einen Raubüberfall im Rollenspiel, und Checkpoint-Schlüsselwörter (flowState) zurückgeben, auf die das Addon reagiert.
Einen Quizabend veranstalten
Die Quiz-Engine (Team-Tarif) macht aus einer Bühne, ein paar Buzzern und einer Anzeigetafel ein Server-Event:
- Sie bauen den Fragenkatalog im Neocortex-Dashboard: einen Server-Trivia-Abend, ein Lore-Quiz für neue Rollenspieler oder einen Regelcheck, den neue Spieler bestehen müssen, bevor sie einen Job bekommen.
- Ein Host-NPC auf der Bühne eröffnet die Runde.
- Spieler antworten im Chat, und das Addon leitet jede Antwort über
/v3/quizan die Quiz-Engine weiter. - Der Host verkündet, wer richtig liegt, und die Quiz-Engine übernimmt die Punktewertung und die Rangliste.
- Zwischen den Runden zeichnet Ihr Addon den Stand auf einem HUD-Panel.
Screenshot: Garry's Mod © Valve
Helfer, die auf Sprachbefehle hören
Geben Sie jedem Spieler einen Helfer-NPC, der zuhört: „folge mir“, „warte hier“, „bewache die Tür“, „bring zwei Kisten“. Im Neocortex-Dashboard entwerfen Sie einen Befehlssatz aus Akteuren, Aktionen und Objekten: Akteur „helper“, Aktionen „follow“, „wait“, „guard“ und „bring“, Objekte „me“, „door“ und „crate“.
Spieler sprechen ganz natürlich, und das Addon erhält die erkannten Befehle sofort, auch mehrere Aktionen und Mengen in einem Satz. Es funktioniert mit Sprechtaste oder dauerhaftem Zuhören, in mehreren Sprachen, ohne Umweg über die Cloud. Da es auf dem Rechner des Spielers läuft, schickt die Client-Seite die erkannten Befehle an den Server.
Voice Commands ist ein lizenziertes SDK: Kontakt aufnehmen für eine Voice-Commands-Lizenz.
Der Code des Garry's Mod KI-NPC-Addons
Alles, was die API berührt, läuft auf dem Server. Der Server liest den Spielstand und schickt ihn zusammen mit der Nachricht des Spielers über /v3/chat an eine Neocortex-Figur. Danach zeigt er die Antwort als Untertitel, spielt die Stimme aus /v3/audio/generate oder /v3/audio/stream ab und führt die Aktionen aus, die die Figur zurückgibt:
-- Server realm only: the key stays in garrysmod/data and never reaches players.
local apiKey = string.Trim(file.Read("neocortex_key.txt", "DATA") or "")
local function AskNPC(ply, text, sessionId, onReply)
HTTP({
url = "https://api.neocortex.link/v3/chat",
method = "POST", type = "application/json",
headers = { ["x-api-key"] = apiKey },
body = util.TableToJSON({
characterIds = { "CHARACTER_ID" },
message = text,
playerId = ply:SteamID64(),
sessionId = sessionId or ""
}),
success = function(code, body)
local data = util.JSONToTable(body)
if code == 200 and data then onReply(data) end -- data.sessionId, data.messages
end,
failed = function(reason) print("[Neocortex] " .. reason) end
})
endHausregeln für KI-NPCs
Garry's-Mod-Server setzen ihre eigenen Regeln. Betreiben Sie KI-NPC-Addons deshalb nur auf Servern, die Ihnen gehören oder deren Besitzer zustimmt, und sagen Sie den Spielern, dass sie mit einer KI sprechen. Halten Sie beim Veröffentlichen die Regeln des Steam Workshop ein und sorgen Sie dafür, dass jeder Serverbesitzer seinen eigenen Neocortex-API-Schlüssel nutzt. Fügen Sie eine Abklingzeit pro Spieler hinzu, damit ein Spieler den NPC nicht zuspammen kann.
Das Fazit für Serverbesitzer
Fünf Schritte bringen Sie von einem leeren Ordner zu einem sprechenden NPC:
- Einen Addon-Ordner anlegen mit einer serverseitigen Lua-Datei und einer spawnbaren NPC-Entity.
- Ihre Figuren entwerfen im Neocortex-Dashboard: einen Händler, einen Quizmaster mit Fragenkatalog und einen Befehlssatz für die Helfer.
/v3/chatund/v3/quizvom Server aus aufrufen mitHTTP()und Antworten über dienet-Bibliothek an Spieler senden.- Den API-Schlüssel in einer serverseitigen Konfigurationsdatei halten, niemals im Client-Lua oder in einem Workshop-Upload.
- Mit einem Freund auf einem lokalen Listen-Server testen, bevor Sie auf einem öffentlichen Server laufen lassen.
Beginnen Sie mit dem Händler. Eine Figur, ein HTTP()-Aufruf und ein Chat-Hook reichen, um Ihren Spielern zu zeigen, was ein Neocortex-NPC kann. Das Quiz baut auf demselben Server-Code auf. Um zu verstehen, wie Sprachbefehle auf dem Rechner des Spielers funktionieren, lesen Sie Sprachbefehle auf dem Gerät für Spiel-Mods. Für Mods auf Engine-Ebene für Source lesen Sie unseren Leitfaden zum KI-NPC-Mod für Half-Life 2.
Werkzeugversionen und Links geprüft im Oktober 2026. Modding-Werkzeuge ändern sich oft; prüfen Sie für die neueste Version die Seite des jeweiligen Projekts.
Häufig gestellte Fragen
Kann man KI-NPCs zu Garry's Mod hinzufügen?
Ja. Garry's-Mod-Addons werden in Lua geschrieben, und das Spiel hat die eingebaute Funktion HTTP(). Ein serverseitiges Addon kann daher die Worte der Spieler an eine KI-Figur schicken und auf die Antwort reagieren. Neocortex liefert die Figur, ihre Stimme und die Aktionen, die sie zurückgibt.
Kann ein Garry's-Mod-Addon eine Web-API aufrufen?
Ja. Die globale Funktion HTTP() und die Helfer http.Fetch und http.Post stellen asynchrone Anfragen vom Server oder vom Client aus. Für ein KI-NPC-Addon machen Sie die Aufrufe auf dem Server, damit Ihr Neocortex-API-Schlüssel nie zu den Spielern gelangt.
Wie veranstalte ich eine Quizshow auf einem Garry's-Mod-Server?
Spawnen Sie einen Host-NPC, leiten Sie die Chatantworten der Spieler an eine Quiz-Engine weiter und zeigen Sie die Punkte auf einem HUD-Panel. Die Neocortex-Quiz-Engine übernimmt Fragen, Punktewertung und Rangliste, sodass Ihr Addon nur Bühne und Chat verwaltet.
Können Garry's-Mod-NPCs Sprachbefehlen folgen?
Ja, mit einer Client-Komponente. Neocortex Voice Commands läuft auf dem PC jedes Spielers und macht aus Sätzen wie "follow me" oder "guard the door" Befehle, die Ihr Addon sofort und offline empfängt. Da es auf dem Rechner des Spielers läuft, installieren Spieler den Sprachteil zusammen mit dem Workshop-Addon.
Wo bewahre ich den API-Schlüssel auf einem Garry's-Mod-Server auf?
Nur auf dem Server, zum Beispiel in einer Datei im Datenordner des Servers, die Ihr Addon beim Start liest. Legen Sie den Schlüssel nie in Client-seitiges Lua oder in einen Workshop-Upload, denn jeder Spieler lädt diese Dateien herunter.






