Neocortex Logo

Portal 2 KI-Mod: Eine sprechende Testkammer-KI und Sprachbefehle

Bauen Sie eine Portal-2-KI-Mod: eine sarkastische Testkammer-KI, die auf Ihre Versuche reagiert, sprachgesteuerte Kammern und ein Wissensquiz, angebunden über VScript.

Neocortex TeamThe team behind Neocortex

· 6 Min. Lesezeit

Bauen Sie eine Portal-2-KI-Mod: eine sarkastische Testkammer-KI, die auf Ihre Versuche reagiert, sprachgesteuerte Kammern und ein Wissensquiz, angebunden über VScript.

Kartenskripte von Portal 2 können das Internet nicht erreichen. Das ist das eine Problem, das jede KI-Mod für Portal 2 lösen muss, und die Antwort ist eine kleine Hilfs-App, die neben dem Spiel läuft. Ist sie eingerichtet, kann Ihre Testkammer eine eigene sprechende KI haben, was zu einem Spiel passt, in dem man von einer Stimme in den Wänden beurteilt wird: eine Kammer, die bemerkt, dass Sie denselben Sprung fünfmal verfehlen, und dazu etwas zu sagen hat, eine Kammer, die Sie mit Ihrer Stimme steuern, und ein Quiz, das den Ausgang nur bei richtigen Antworten öffnet. Neocortex stellt den KI-Charakter, Conversation Flows, Quizze und Sprachbefehle auf dem Gerät bereit.

Portal-2-Screenshot aus dem Spiel Screenshot: Portal 2 © Valve

Warum braucht eine Portal-2-KI-Mod eine Hilfs-App?

Portal-2-Karten werden in Hammer mit den Portal 2 Authoring Tools gebaut und im Steam Workshop geteilt. Die Kartenlogik besteht aus Entity-I/O und VScript, das in Portal 2 Squirrel ist. VScript kann Entities lesen und bewegen, den Spieler verfolgen und in die Konsole schreiben, hat aber keinen Netzwerk- oder HTTP-Zugang.

Also macht die Karte, was sie kann: melden und reagieren. Eine lokale Hilfs-App übernimmt das Gespräch mit Neocortex. Die Hilfs-App kann in jeder Sprache mit einem HTTP-Client geschrieben sein.

Wie kommen Ereignisse aus dem Spiel und wieder hinein?

RichtungWie
Aus dem SpielIhr VScript schreibt markierte Zeilen (ein Ereignis, ein Kammerzustand) in die Konsole. Wird Portal 2 mit -condebug gestartet, schreibt es die Konsolenausgabe in eine Datei console.log, die die Hilfs-App beobachten kann. Siehe Valves Befehlszeilenoptionen.
Zurück ins SpielDie Startoption -netconport öffnet einen Konsolen-Port, über den die Hilfs-App Konsolenbefehle zurücksenden kann, zum Beispiel einen Aufruf script in das VScript Ihrer Karte. Halten Sie diesen Port auf Ihrem eigenen Rechner.
UntertitelIhre Karte zeigt den Antworttext mit einer game_text-Entity.
StimmeDie Hilfs-App spielt die Stimme des Charakters über die Audioausgabe des PCs ab.

Auf der Seite von Neocortex liest die Hilfs-App den Spielzustand aus dem Konsolenprotokoll und sendet ihn zusammen mit der Nachricht des Spielers über /v3/chat an einen Charakter. Die Karte zeigt die Antwort als Untertitel, die Hilfs-App spielt die Stimme von /v3/audio/generate oder /v3/audio/stream, und die Aktionen, die der Charakter zurückgibt, gehen als Konsolenbefehle zurück an die Karte. Conversation Flows geben Checkpoint-Schlüsselwörter (flowState) zurück, auf die die Karte reagiert, etwa um den nächsten Test zu öffnen, und die Quiz-Engine führt Frage-und-Antwort-Spiele über /v3/quiz durch.

Was kann eine Testkammer-KI?

Erstellen Sie einen eigenen Aufseher statt den des Spiels zu übernehmen: PROCTOR-7, eine Anlagen-Intelligenz, die auf den Betrieb einer einzigen Kammer herabgestuft wurde und darüber nicht glücklich ist. Geben Sie ihr eine Persönlichkeit, eine Emotionseinstellung und eine Wissensbasis über die Lösung Ihrer Kammer, ihre Geschichte und ihre kleinlichen Klagen.

Ihre Karte meldet, was passiert: „Spieler in den Schleim gefallen“, „dritter misslungener Schleuderwurf bei Panel B“, „Würfel auf dem falschen Knopf platziert“, „Spieler steht seit 40 Sekunden still“. Die Hilfs-App sendet diese als Ereignisse mit jeder Nachricht, und PROCTOR-7 kommentiert sie mit Stimme, mit einem Emotions-Tag in jeder Zeile: CURIOUS, wenn Sie etwas Neues ausprobieren, ANGRY, wenn Sie die vorgesehene Lösung brechen.

Sie kann auch Aktionen zurückgeben, etwa ein widerwilliges { "name": "SPAWN_CUBE", "targetId": "dropper_01" } nach genug Fehlversuchen, das Ihre Karte als Hinweis ausführt.

Ein Conversation Flow kann die ganze Kammer in eine Geschichte verwandeln: Einführung, erster Test, eine „Fehlfunktion“, durch die der Spieler PROCTOR-7 hindurchreden muss, und ein letzter Test. Jedes Checkpoint-Schlüsselwort, das die API zurückgibt, öffnet den nächsten Teil der Karte.

Portal-2-Screenshot aus dem Spiel Screenshot: Portal 2 © Valve

Kann der Spieler eine Kammer durch Reden lösen?

Ja. Bauen Sie eine Kammer, die der Spieler durch Reden mit ihr löst. Im Neocortex-Dashboard entwerfen Sie einen Befehlssatz aus Akteuren, Aktionen und Objekten: Akteur „chamber“, Aktionen „raise“, „lower“, „drop“ und „extend“, Objekte „platform“, „cube“ und „bridge“.

Spieler sprechen natürlich, und die Hilfs-App erhält passende Befehle sofort, auch mehrere Aktionen und Mengen in einem Satz: „drop two cubes and raise the platform“. Es funktioniert mit Push-to-Talk oder ständigem Zuhören, in mehreren Sprachen, und Neocortex Voice Commands läuft auf dem Rechner des Spielers ohne Umweg über die Cloud, was zählt, wenn der Zeitpunkt eines Schleuderwurfs davon abhängt.

Voice Commands ist ein lizenziertes SDK: kontaktiere uns für eine Voice-Commands-Lizenz.

Dieselbe Kammer kann auch Wissen statt Reflexe prüfen. Eine Ansagerfigur stellt Physikfragen, die im Neocortex-Dashboard entworfen wurden: Impuls, Schwerkraft, warum ein Portal Ihre Geschwindigkeit behält. Die Quiz-Engine (Team-Tarif) führt die Fragen und die Wertung durch; jede richtige Antwort schaltet ein weiteres Segment der Lichtbrücke frei, und eine falsche lässt einen Würfel in den Schleim fallen.

Funktioniert es in Portal 2: Community Edition?

Portal 2: Community Edition ist eine von der Community gepflegte Version von Portal 2 auf Strata Source, einem offiziell lizenzierten Fork des CS:GO-Engine-Zweigs. Sie ging am 17. April 2026 in die offene Beta auf Steam, ist für Besitzer von Portal 2 kostenlos und bringt einen nativen 64-Bit-Port, AngelScript-Skripting, Panorama-UI, ein Addon-System und einen eigenen Workshop mit.

Sie ist noch eine Beta, daher prüfen Sie ihre Dokumentation, was ihr Scripting kann. Das Muster mit der Hilfs-App funktioniert dort in jedem Fall.

Kann man es im Workshop veröffentlichen?

Die Workshop-Bedingungen von Valve gelten für die Karte, und die Hilfs-App ist ein eigener Download, den Spieler bewusst starten. Halten Sie KI- und Sprachfunktionen auf Einzelspieler-Kammern, nutzen Sie sie niemals, um im Koop einen Vorteil gegenüber Mitspielern zu bekommen, die nicht zugestimmt haben, und lassen Sie jeden Spieler seinen eigenen Neocortex-API-Schlüssel verwenden.

Bauen Sie Ihre erste sprechende Kammer

  1. Bauen Sie eine Testkammer in Hammer mit einer VScript-Datei, die markierte Ereignisse in die Konsole schreibt.
  2. Entwerfen Sie Ihren Charakter im Neocortex-Dashboard: PROCTOR-7s Persönlichkeit und Wissen, ein Conversation Flow für die Kammer, ein Quiz und ein Befehlssatz.
  3. Schreiben Sie die Hilfs-App: console.log beobachten, /v3/chat aufrufen, die Stimme abspielen und Befehle über den Konsolen-Port zurücksenden.
  4. Bewahren Sie den API-Schlüssel in der Konfigurationsdatei der Hilfs-App auf, die der Spieler ausfüllt, niemals fest in einen Build eingetragen, den Sie teilen.
  5. Testen Sie im Einzelspielermodus mit den gesetzten Startoptionen, und veröffentlichen Sie danach die Karte im Workshop und die Hilfs-App separat.

Zur Stimmseite lesen Sie Sprachbefehle auf dem Gerät für Spiel-Mods. Für Mods auf Basis der Engine von Source siehe unseren Leitfaden zur Half-Life-2-KI-NPC-Mod, und für ein Source-Spiel, dessen Skripte die API direkt aufrufen können, unseren Leitfaden zur Titanfall-2-KI-Mod. Und wenn Sie PROCTOR-7 später in einem eigenständigen Spiel wollen, funktioniert derselbe Neocortex-Charakter über unsere Unity-Integration.

Versionen der Werkzeuge 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 einem Portal 2 einen KI-Charakter hinzufügen?

Ja, mit einer kleinen Hilfs-App. Kartenskripte von Portal 2 können das Internet nicht erreichen, daher schreibt die Karte Ereignisse in die Konsole, und eine lokale Hilfs-App gibt sie an einen KI-Charakter weiter. Neocortex liefert den Charakter, seine Stimme und seine Antworten, und die Hilfs-App schickt sie zurück ins Spiel.

Kann VScript in Portal 2 HTTP-Anfragen stellen?

Nein. VScript in Portal 2 ist Squirrel, das innerhalb der Karte läuft, ohne Netzwerkzugang. Das übliche Muster ist, Ereignisse in die Konsole zu schreiben, sie aus einer Hilfs-App zu lesen und diese App Web-APIs wie Neocortex aufrufen zu lassen.

Kann ich eine Testkammer in Portal 2 mit meiner Stimme steuern?

Ja. Eine Hilfs-App kann das Mikrofon abhören und passende Befehle ins Spiel schicken, etwa eine Plattform heben oder einen Würfel fallen lassen. Neocortex Voice Commands führt den Abgleich auf dem PC des Spielers aus, daher funktioniert es offline und reagiert sofort.

Was ist Portal 2: Community Edition?

Portal 2: Community Edition ist eine von der Community gepflegte Version von Portal 2 auf der Engine Strata Source, seit April 2026 in der offenen Beta auf Steam und für Besitzer von Portal 2 kostenlos. Sie bringt AngelScript, Panorama-UI und ein Addon-System mit, und das Muster der Hilfs-App für Neocortex funktioniert dort ebenfalls.

Kann ich eine KI-Testkammer im Steam Workshop veröffentlichen?

Sie können die Karte wie üblich im Workshop veröffentlichen, aber die Hilfs-App muss separat geteilt werden, etwa auf GitHub. Jeder Spieler startet sie mit seinem eigenen Neocortex-API-Schlüssel, den Sie im Browser-Editor bekommen.

Ähnliche Beiträge

Weiterlesen