# 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.

Quelle: https://war3ai.com/de/docs/console/

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.

```bash
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](https://war3ai.com/de/docs/gateway/), [Chat-Sprechblasen](https://war3ai.com/de/docs/speech/), 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](https://war3ai.com/de/docs/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

| Gruppe | Seite | Funktion |
|---|---|---|
| Zentrale | Kontrollzentrum | Siehe Abschnitt oben |
| Spiel | Übersicht | Überblick über das Spiel der aktuellen Instanz |
| | Schlachtfeld | Kartenansicht; manuelle Befehle möglich (manuelle Befehle haben in der Claim-Tabelle die höchste Priorität: 95) |
| | Einheitendaten | Order, Aufgabenziel, Mana, Heldenstufe und Erfahrung, Abklingzeiten, Inventar jeder Einheit |
| | KI-Entscheidungen / Kampfentscheidungen | Was das Referenz-Brain in diesem Tick denkt, Details zu jeder Kampfentscheidung |
| | Strategie-Coach | Status des [LLM-Coaches](https://war3ai.com/de/docs/llm-coach/): ob der Modellserver läuft, ob jede Instanz verbunden ist, der letzte Ratschlag und die Eingaben, die er gesehen hat |
| | Regiepult | Automatische Kameraführung, HP-Balken über Einheiten |
| | Sprechblasen | Einheiten sprechen lassen, mit dem lokalen Modell chatten, Bauern-Kaffeeklatsch, Kamera-Dialoge, ereignisgesteuerte Kommentare, Modelleinstellungen. Siehe [Sprechblasen](https://war3ai.com/de/docs/speech/) |
| | Befehlstempo | APM und Befehlsdurchsatz |
| | Events & Eingabe | Was 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](https://war3ai.com/de/docs/ui-input/) |
| Protokolle | Logs / Spielprotokolle | Log-Quellen jeder Instanz; Ergebnis, Dauer und maximale Truppenstärke jedes Spiels |
| | Problemnotizen | Im Spiel mit Pause/Break pausieren und den Zeitpunkt festhalten, hier später die Beschreibung ergänzen |
| System | Instanzen & Start | Instanzen 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-Schemata | Schemata 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](https://war3ai.com/de/docs/schemes/) |
| | JASS-Konsole | JASS-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](https://war3ai.com/de/docs/jass/) |
| | Anbindung & Erweiterung | Gateway-Status und Start per Klick; Verbindungsadressen pro Rolle (Dev / Spieler / Zuschauer), MCP-Einbindungsbefehle und -Konfiguration; Beispiele in JS und Python. Siehe [Gateway](https://war3ai.com/de/docs/gateway/) und [MCP](https://war3ai.com/de/docs/mcp/) |
| | Daten & Speicherplatz | Wie 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) |
| | Einstellungen | Spielverzeichnis, Sprache der Oberfläche, Darstellung (dunkel / hell, modern / Warcraft-Stil) usw. |
| | Feedback & Vorschläge | Probleme 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“).

> **Tipp**
>
> 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](https://war3ai.com/de/docs/schemes/), [JASS-Kanal](https://war3ai.com/de/docs/jass/) und [Canvas](https://war3ai.com/de/docs/canvas/).
