Docs Tools

Farsight-Konsole

Lokale Web-Konsole und zugleich der einzige Einstiegspunkt: Spielverzeichnis festlegen, Dienste starten und stoppen, Spielinstanzen starten und stoppen, das nächste Spiel einrichten, sehen, was die KI denkt, manuelle Befehle, Regie, Spielprotokolle.

Farsight ist die Web-Konsole, die lokal auf deinem Rechner läuft, und lauscht nur auf 127.0.0.1. Sie ist auch der einzige Einstiegspunkt ins gesamte System: Partien starten, KI wechseln, Gateway, Sprechblasen, lokales LLM – all das klickst du hier an, ohne nach weiteren Skripten suchen zu müssen.

start.bat                 # Installation prüfen, dann Farsight öffnen: http://127.0.0.1:8866
start.bat 5 6             # startet zusätzlich Tests auf Instanz 5 und 6 (Spiel + Referenz-Brain)
start.bat restart         # nur das Farsight-Backend neu starten (nach Änderungen am Servercode; Spiele und Dienste laufen weiter)
stop.bat                  # alles vollständig stoppen

Den Port änderst du unter ports.console in openwar3.json (Standard 8866).

Kontrollzentrum

Die Startseite von Farsight.

  • Spielverzeichnis: automatisch suchen oder selbst auswählen; Farsight prüft die Spielversion und extrahiert Daten aus deinem Spiel.
  • Lokale Dienste: Gateway, Chat-Sprechblasen, lokales LLM (LM Studio), Website-Vorschau – auf jeder Karte lässt sich der Dienst starten, stoppen und neu starten, und du kannst die Logs ansehen; außerdem siehst du, ob ein Client den MCP-Server eingebunden hat.
  • Umgebungsprüfung: ob Python, Runtime-Dateien, Spieldaten, AMAI-Daten usw. installiert sind.
  • Alle stoppen (oben rechts): Spielinstanzen, KI, Gateway, Sprechblasen, das von diesem System genutzte lokale Modell und das Farsight-Backend werden der Reihe nach beendet – genau wie mit einem Doppelklick auf stop.bat. MCP-Server werden von Clients wie Claude verwaltet und nicht gestoppt; auch das Programm LM Studio selbst wird nicht geschlossen.

Seiten

GruppeSeiteFunktion
ZentraleKontrollzentrumSiehe Abschnitt oben
SpielÜbersichtÜberblick über das Spiel der aktuellen Instanz
SchlachtfeldKartenansicht; manuelle Befehle möglich (manuelle Befehle haben in der Claim-Tabelle die höchste Priorität: 95)
EinheitendatenOrder, Aufgabenziel, Mana, Heldenstufe und Erfahrung, Abklingzeiten, Inventar jeder Einheit
KI-Entscheidungen / KampfentscheidungenWas das Referenz-Brain in diesem Tick denkt, Details zu jeder Kampfentscheidung
Strategie-CoachStatus des LLM-Coaches: ob der Modellserver läuft, ob jede Instanz verbunden ist, der letzte Ratschlag und die Eingaben, die er gesehen hat
RegiepultAutomatische Kameraführung, HP-Balken über Einheiten
SprechblasenEinheiten sprechen lassen, mit dem lokalen Modell chatten, Bauern-Kaffeeklatsch, Kamera-Dialoge, ereignisgesteuerte Kommentare, Modelleinstellungen. Siehe Sprechblasen
BefehlstempoAPM und Befehlsdurchsatz
Events & EingabeWas in dieser Partie passiert ist: gewirkte Fähigkeiten, Chat und Bildschirmnachrichten, Button-Klicks, Hotkeys, Klicks auf den Boden, Auswahl, Spieler, die gehen – nach Kategorie filterbar; daneben Mausposition, das Element unter dem Mauszeiger und die lokale Auswahl. Siehe Oberfläche & Eingabe
ProtokolleLogs / SpielprotokolleLog-Quellen jeder Instanz; Ergebnis, Dauer und maximale Truppenstärke jedes Spiels
ProblemnotizenIm Spiel mit Pause/Break pausieren und den Zeitpunkt festhalten, hier später die Beschreibung ergänzen
SystemInstanzen & StartInstanzen starten und stoppen; Karte (Melee-Karte, wahlweise auch RPG- / Custom Map), Völker beider Seiten, Schwierigkeit und Geschwindigkeit für das nächste Spiel festlegen; pro Instanz ein KI-Schema wählen; „Test starten“ startet Spiel + KI mit einem Klick
KI-SchemataSchemata importieren, exportieren, kopieren, als vertrauenswürdig markieren, löschen; das Schema einer Instanz wechseln (auch in der laufenden Partie übernimmt sofort ein anderes); Ergebnisse jedes Schemas ansehen. Siehe KI-Schemata
JASS-KonsoleJASS-Skript schreiben und auf Ausführen klicken; rechts die 1291 Funktionen nach Kategorie durchsuchen und per Klick ins Skript einfügen; Variablen bleiben während derselben Partie erhalten. Siehe JASS-Kanal
Anbindung & ErweiterungGateway-Status und Start per Klick; Verbindungsadressen pro Rolle (Dev / Spieler / Zuschauer), MCP-Einbindungsbefehle und -Konfiguration; Beispiele in JS und Python. Siehe Gateway und MCP
Daten & SpeicherplatzWie viel Speicherplatz Laufzeitdaten wie Aufnahmen, Spielprotokolle und Logs belegen, wie viel am letzten Tag hinzugekommen ist und was gelöscht werden kann (Farsight löscht nie etwas automatisch)
EinstellungenSpielverzeichnis, Sprache der Oberfläche, Darstellung (dunkel / hell, modern / Warcraft-Stil) usw.
Feedback & VorschlägeProbleme und Vorschläge direkt an uns senden; Diagnoseinformationen werden nur angehängt, wenn du sie ankreuzt, und lassen sich vor dem Senden ansehen

Mit Strg + K öffnest du die Befehlspalette: Seite wechseln, Instanz wechseln, das laufende Spiel beenden, ein neues Brain starten.

Unten in der Seitenleiste zeigt „Neuigkeiten“, was bei Farsight und der Plattform zuletzt hinzugekommen ist. Beim Start (und danach alle 6 Stunden) fragt Farsight bei War3AI.com nach, ob es eine neue Version gibt, und weist dich gegebenenfalls darauf hin. Nach einem Update von Farsight erscheint oben auf der Seite ein Banner: Sichere zuerst, was du gerade eingibst, und klicke dann auf „Neu laden“.

Mehrere Instanzen

runtime/farm.py übernimmt das Multi-Boxing (Farsight ruft es für dich auf, wenn Instanzen gestartet oder gestoppt werden): Es kopiert den Original-Starter War3.exe und benennt ihn in War3-<N>.exe um (keine Spieldatei wird verändert); jede Instanz hat eine Nummer und ein eigenes Verzeichnis (bin/inst<N>/). Nach jedem Spiel startet das nächste automatisch gemäß next_game.json (genau diese Datei bearbeitest du auf der Konsolenseite „Instanzen & Start“).

Dein Bot verbindet sich mit --inst N zu einer bestimmten Instanz. Auf der Konsolenseite „Instanzen & Start“ siehst du, welche Nummern belegt sind – komm dem Referenz-Brain nicht in die Quere.

Live-Seite

http://127.0.0.1:8866/live ist eine scrollende Log-Seite für die „Browserquelle“ in OBS und zeigt die Entscheidungen der KI und das Kampfgeschehen.

API

Das Backend der Konsole ist eine Reihe lokaler REST- und WebSocket-APIs (Instanzstatus, Einstellungen fürs nächste Spiel, Einheitendetails, manuelle Befehle, Logs, Spielprotokolle, Regie, KI-Schemata, JASS-Aufrufe, Canvas …); die Webseite ist nur einer von mehreren Clients, Programme in jeder Sprache können sie direkt aufrufen. Die Liste der APIs steht im Dateikopf von console/server/app.py; wie die drei Gruppen Schemata, JASS und Canvas benutzt werden, steht unter KI-Schemata, JASS-Kanal und Canvas.