# War3AI / OpenWar3

> Offene API für Warcraft III 1.27 für KI-Agents: Eine injizierte Runtime pusht alle 50 ms den vollständigen Zustand der ganzen Karte und einen Event-Stream; externe Programme senden semantische Befehle in etwa einem Frame, jeder Befehl erhält eine Quittung und einen Reason-Code. Das Python-SDK (openwar3) beschreibt alles mit den Begriffen des Spiels (Rawcodes, Order-Strings der Fähigkeiten).

Kürzester Weg zum Bot: „Die 15 Regeln“ und die APIs in api.json lesen, von openwar3.Bot erben, on_start(g) / on_tick(g) / on_event(g, ev) implementieren; nur Methoden verwenden, die in api.json stehen.
Alle Docs in einer Datei: https://war3ai.com/de/llms-full.txt

## Start

- [Überblick](https://war3ai.com/de/docs/index.md): OpenWar3-Doku: was es ist, was es kann; Schnellstart, dein erster Bot, KI schreibt Bots, APIs und Protokoll, Gateway und MCP – je nach Situation, wo du am besten einsteigst.
- [Schnellstart](https://war3ai.com/de/docs/quickstart.md): Doppelklick auf start.bat installiert alles automatisch; in Farsight das Spielverzeichnis festlegen, eine Partie starten und zusehen, wie der Beispiel-Bot übernimmt. Etwa 15 Minuten.
- [Dein erster Bot](https://war3ai.com/de/docs/first-bot.md): Starte mit einem minimalen Bot aus 10 Zeilen, ergänze Bauern, Nahrung, Truppen, Helden und Angriffe und lerne zum Schluss, Quittungen zu lesen.

## KI schreibt Bots

- [Einen Bot mit einem LLM schreiben](https://war3ai.com/de/docs/ai-bot.md): Geht auch ohne Programmierkenntnisse: Du beschreibst, wie gespielt werden soll, das LLM schreibt den Code. Prompt-Vorlage kopieren, Spielweise beschreiben, laufen lassen und nachbessern lassen.
- [Agent-Selbstiteration](https://war3ai.com/de/docs/agent-loop.md): Lass einen Coding Agent selbst Partien spielen, Ergebnisse lesen, Code ändern und erneut spielen. Dafür braucht er einen Befehl, der unbeaufsichtigt läuft, einen strukturierten Spielbericht und ein klares Ziel.
- [LLM als Strategie-Coach](https://war3ai.com/de/docs/llm-coach.md): Überlass dem LLM, worauf gespart wird, wohin die Arbeiter gehen und ob in dieser Minute angegriffen oder abgewartet wird – die Regelschicht führt nur aus und legt bei Bedarf ein Veto ein. Das Referenz-Brain arbeitet bereits so; diese Seite erklärt das Muster und die Fallstricke.
- [LLM ruft Tools direkt auf (MCP)](https://war3ai.com/de/docs/mcp.md): tools/war3_mcp.py ist ein MCP-Server. Hängst du ihn in Claude Code, Claude Desktop oder einen anderen MCP-fähigen Client, kann das LLM direkt die Lage sehen, Befehle erteilen, auf dem Bildschirm mit dem Spieler sprechen, ihm Karten zur Auswahl zeigen und Screenshots ansehen – ohne vorher Code zu schreiben.

## Grundlagen

- [Mentales Modell](https://war3ai.com/de/docs/concepts.md): Snapshot, Befehl, Quittung, Event, Tick, Batch. Wer diese sechs Konzepte versteht, versteht, warum die API so aussieht und wie man schnellen Code schreibt.
- [Die 15 Regeln](https://war3ai.com/de/docs/rules.md): Jede einzelne stammt aus echten Spielen. Prüf deinen Bot beim Schreiben dagegen – das spart den Großteil der Fehlersuche.
- [Fair-Modus](https://war3ai.com/de/docs/fair-mode.md): Ein ins Spiel injizierter Client kann die ganze Karte lesen. Im Fair-Modus sieht dein Bot nur, was in seiner Sicht liegt – wie ein menschlicher Spieler und wie nach den Regeln der Arena.

## Anleitungen

- [Profi-Kochbuch](https://war3ai.com/de/docs/cookbook.md): Der Vorsprung guter Spieler steckt größtenteils in Dutzenden kleiner Gewohnheiten. Diese Seite übersetzt gängige Profi-Techniken eine nach der anderen in SDK-Code – jeder Abschnitt lässt sich direkt in on_tick kopieren.
- [Beispiel-Bots](https://war3ai.com/de/docs/examples.md): Vier Beispiele von einfach bis komplex – jedes sofort lauffähig, jeder Logikblock entspricht einer SDK-Fähigkeit. Dazu ein vollständiges Referenz-Brain.
- [Debugging & Performance](https://war3ai.com/de/docs/debugging.md): Warum ein Tick langsam ist, warum ein Befehl nicht greift, warum das Spiel steht: nach Symptom eingrenzen, dann mit den mitgelieferten Live-Prüfskripten bestätigen.

## Spielerweiterungen

- [RPG-Begleiter](https://war3ai.com/de/docs/companion.md): Ein KI-Begleiter für RPG- und benutzerdefinierte Karten: Er folgt dir, kämpft mit, heilt dich bei niedrigen HP und plaudert mit dir. Vier Modi – eine Klasse erben, ein paar Attribute ändern, fertig ist dein eigener Begleiter.
- [Canvas](https://war3ai.com/de/docs/canvas.md): Textfelder, Panels, Fortschrittsbalken, Bilder, Kreise am Boden und Routen mit Pfeil aufs Spielbild zeichnen. Die Runtime zeichnet selbst in jedem Frame und ändert den Spielzustand nicht – auch in Mehrspieler-Partien sicher; per Python, HTTP oder direkt über Shared Memory.
- [Oberfläche & Eingabe](https://war3ai.com/de/docs/ui-input.md): Buttons und Auswahlkarten auf dem Canvas sind klickbar und leuchten beim Hover auf; Hotkeys registrieren, per Klick auf den Boden eine Position wählen, lesen, worauf die Maus zeigt, und wissen, was der lokale Spieler ausgewählt hat. Klicks, Hotkeys, gewirkte Fähigkeiten, voller Chat-Text und Spieler, die gehen – alles landet im Event-Stream.
- [JASS-Kanal](https://war3ai.com/de/docs/jass.md): Die 1291 JASS-Funktionen, die Kartenautoren nutzen können, lassen sich jetzt von außerhalb des Spiels direkt per Name aufrufen: Einheiten erstellen, Eigenschaften ändern, Effekte, Panels, Dialoge, Sounds, Kamera, Nebel … Vier Wege: Farsight-Konsole, Kommandozeile, HTTP und Python.
- [Gameplay-Mods](https://war3ai.com/de/docs/mods.md): Ein Schema ist nicht nur eine KI, die für dich spielt – es kann auch ein Regelwerk sein: Du spielst selbst im Spielfenster, die Mod richtet den Start ein, schickt Gegnerwellen, verteilt Belohnungen, gibt dir Buttons und Auswahlkarten auf dem Bildschirm und entscheidet über Sieg und Niederlage. Von openwar3.Mod erben – eine Datei ist ein ganzes Spielprinzip.

## Tools

- [Farsight-Konsole](https://war3ai.com/de/docs/console.md): 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.
- [KI-Schemata](https://war3ai.com/de/docs/schemes.md): Ein Schema ist eine komplette KI. In Farsight mit einem Klick wechseln – auch in einer laufenden Partie übernimmt sofort die neue KI. Als zip exportieren und teilen, fremde Schemata importieren und testen; die Ergebnisse jedes Schemas werden automatisch erfasst.
- [Sprechblasen & lokale Modelle](https://war3ai.com/de/docs/speech.md): Lass jede Einheit im Spiel in beliebiger Rolle eine Sprechblase zeigen. Mit einem lokalen LLM geht ein Satz rein, und die Antwort erscheint über der Einheit.
- [Gateway](https://war3ai.com/de/docs/gateway.md): WebSocket-/JSON-Gateway: Die öffentlichen APIs, die das Python-SDK aufrufen kann, stehen auch JS, C#, Go, Rust, Browserseiten und Programmen auf anderen Rechnern offen. Drei Rollen, mit JS-Client und Demoseite für den Browser; die Latenz ist die der Schnellspur plus ca. 1 ms.

## Referenz

- [W3P-Protokoll](https://war3ai.com/de/docs/protocol.md): Der komplette Vertrag zwischen Runtime und externen Programmen: acht Shared-Memory-Blöcke, Weltzustand lesen, Events lesen, Befehle erteilen, Quittungen, Spur-Rollen, Canvas sowie Oberfläche & Eingabe. Lies diese Seite, wenn du aus einer anderen Sprache als Python andockst.
- [Quittungen & Reason-Codes](https://war3ai.com/de/docs/reason-codes.md): Jede Befehlsquittung enthält einen Statuscode und einen Reason-Code. Daran korrigieren sich Bots und Agents selbst: Aus „Warum hat es nicht geklappt?“ wird eine maschinenlesbare Zahl.
- [Datenquellen](https://war3ai.com/de/docs/data-sources.md): Herkunft und Genauigkeit jeder Datenart. Wenn etwas „komisch aussieht“, schau zuerst hier nach.

## Sonstiges

- [FAQ](https://war3ai.com/de/docs/faq.md): Ist das ein Cheat? Welche Versionen werden unterstützt? Was sieht die KI, was kann sie tun? Geht es ohne Programmierkenntnisse? …
- [Nutzungsgrenzen](https://war3ai.com/de/docs/legal.md): Was erlaubt ist, was nicht, die Besucherstatistik dieser Website, dazu Hinweise zu Marken und Drittlizenzen. Wer dieses Projekt nutzt, erklärt sich mit diesen Grenzen einverstanden.

## APIs

- [api.json](https://war3ai.com/de/api.json): Alle 103 Game-Methoden (name / category / status / latency / mechanism / signature / doc), aus dem Code generiert
- [API-Katalog (Web)](https://war3ai.com/de/api/): Durchsuchbare Version derselben Daten

## Optional

- [llms-full.txt](https://war3ai.com/de/llms-full.txt): Alle Docs + API-Katalog in einem Rutsch
- [Nutzungsgrenzen](https://war3ai.com/de/docs/legal.md): Nur für Clients, die du rechtmäßig besitzt; keine Nutzung auf Battle.net oder Servern mit Anti-Cheat