OPENXXAI / OpenWar3AI

# OpenWar3 — write AI for Warcraft III 1.27 in any language
**English** · 简体中文 · Website & docs
**An open API for Warcraft III, built for AI agents. One runtime, one protocol, any model, any language.**
OpenWar3 is a runtime injected into the game (a DLL) plus a Python SDK. Every 50 ms the runtime pushes the
**complete state of the whole map** into shared memory — every player's resources; every unit's HP / mana, order,
current target, cooldowns, buffs and inventory; items on the ground; trees — together with an **event stream**.
External programs issue semantic commands (move, attack, gather, build, train, cast, learn skills, revive, use items…)
with **about one frame of latency**, and every command gets a receipt saying whether it was accepted and, if not, why.
The whole contract between the runtime and your code is a documented protocol (W3P).
The repository also ships a complete reference AI (expanding, creeping, attacking, hero spells, staying alive),
a web console (**Farsight**), automatic camera direction and in-game chat bubbles.
> ⚠ Only for a Warcraft III 1.27 client **you legally own**, on your own machine, LAN or self-hosted games.
> `Game.dll` on disk is never modified and no Blizzard files are distributed.
> **Never use it on Battle.net or on any server with anti-cheat.**
## Quick start
You need 64-bit Windows 10 / 11 and your own Warcraft III **1.27a** (The Frozen Throne, `Game.dll` 1.27.0.52240).
Nothing else has to be installed first.
**Double-click `start.bat`.** The first time, it will:
1. Download Python 3.13 (the official portable package, about 14 MB) into the repository's `bin\env\` —
 **the only thing it installs**. No administrator rights, no changes to the system PATH; on networks in mainland China it switches to mirrors automatically.
2. Install the Python packages, verify the injected runtime in `prebuilt\` (DLL and launcher, checked by SHA-256) and copy it into `bin\`.
3. Download AMAI and generate the strategy data the reference brain needs.
4. Open Farsight's home page, **Control Center**, at http://127.0.0.1:8866.
PowerShell is the Windows PowerShell 5.1 that comes with Windows, and the web UI ships prebuilt (`console\web\dist\`), so no Node.js is needed.
`start.bat` only fetches Node.js if you change the web UI source; run `start.bat node` if you want the website preview.
**Then set your Warcraft III folder at the top of Control Center** (**Find automatically**, or **Browse…**).
Farsight checks the game version and extracts the data it needs from your own copy of the game (Blizzard files are not distributed).
If the version isn't 1.27a you get a notice — please use 1.27.0.52240; more versions are coming, follow War3AI.com.
Maps and next-game settings are relative to this folder (maps in any folder under ` \Maps` can be picked);
change it later on the **Settings** page.
After that, every double-click runs a one- or two-second check and opens Farsight. Starting games, switching AIs, the gateway,
chat bubbles, the lo