Skip to content
Metatext Decide — typed decisions for your agents, with a probability on every answerGet early access
Metatext
Sign Up

wc3env

Gym-style environment for offline Warcraft III with deterministic stepping and fog-filtered observations, plus an agent using Jev for micro.

Projectresearch
View on GitHub ↗

Overview

wc3env is a gym-style environment for real Warcraft III Legacy (version 1.29) on Windows. An injected DLL provides deterministic stepping, fog-filtered observations and native commands on stock maps, with offline self-play and pools of independent game processes; Linux workers run under Wine. You need your own licensed installation, and it must never be used online.

The repository also includes an LLM agent in wc3agent that uses Jev for micro-level decisions alongside a separate macro model from Anthropic or OpenAI, and can play mirror duels. The environment itself is model-agnostic and designed for driving decision models against a real game. Linux workers can run the same environment under Wine, an end-to-end test drives the real game for about three minutes, and setup requires Windows build tools for the 32-bit hook.

What the decision model decides

TypeQuestionAnswers
ChoiceWhich micro-level command should this unit take? (wc3agent)(inferred)—

How it works

  1. Launch Warcraft III with the injected hook.
  2. Step the environment and read fog-filtered observations.
  3. Jev decides micro actions; a macro model plans strategy.
  4. Send native commands and repeat.

Strengths

  • Deterministic stepping for reproducible experiments.
  • Fog-of-war-respecting observations.
  • Parallel game processes and Wine workers.

Caveats

  • Requires a licensed Warcraft III 1.29 install and Windows build tools.
  • Offline only; unofficial.

Getting started

wc3hook/build.bat, python -m pip install -e ., set WC3_GAME_DIR in .env

At a glance

Type
Project
Status
research
Language
Python, C++
Runtime
Windows game hook + Python environment
Has code
yes
Has tests
yes

Use cases and integrations

How curated lists describe it

  • Gym-style environment for real Warcraft III: deterministic stepping, fog-filtered observations and native commands, for driving decision models against a game.

    MrJev/awesome-jev

Frequently asked questions

Where does Jev come in?

The included wc3agent uses Jev for micro decisions with a separate macro model.

Can I use it online?

No, it is offline only.

Do I need the game?

Yes, your own licensed Warcraft III Legacy 1.29 installation.

Related projects

  • jev-arena

    Real-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.

    ProjectbetaTypeScript
  • ra2web-jev-player

    Bot that plays Red Alert 2 web skirmishes, with code handling mechanics and a decision model making stance, threat and timing calls.

    ServicebetaPython
  • river-oaks

    Multiplayer 3D science-fantasy version of Houston's River Oaks District with Jev-powered NPC companion, chauffeur and smart drive.

    ProjectbetaTypeScript
  • roverlab

    Browser 3D planetary rover sandbox where a TypeSafe controller chooses the next action from complete candidates, versus a baseline.

    ProjectbetaTypeScript
  • DoomSat

    Doom runs as a spacecraft payload over real flight software; Jev pilots from the ground every half second while Claude reviews.

    ProjectprototypePython
  • hermes-and-jev-play-minecraft

    Minecraft agent where Hermes plans, Jev picks one bounded action at a time and a Mineflayer harness validates and executes.

    ProjectprototypeJavaScript