What this is

World of ClaudeCraft is a complete classic-era MMO you can play right now in your browser, host yourself with one command, and even train AI agents to play. It is free, open source, and live at worldofclaudecraft.com.

One shared world runs in three places, all from the same game core:

• the offline browser world, where you click Play Offline and you are in,
• the authoritative multiplayer server, where Postgres-backed accounts share a live world,
• the headless RL env, where Python drives the real game through a Gym interface.

Same seed, same world, everywhere. And almost nothing is a shipped asset: the towns, creatures, spell icons, and sound are all generated at runtime.

Highlights

• Nine classic classes, each with a full classic-era-style kit that gains ranks as you level, plus a full talent system (three specs per class, 27 specs in all).
• Three open-world zones from level 1 to 20, nearly 80 quests, and a single connected storyline about the Gravecaller conspiracy.
• Five instanced dungeons, four of them five-player elite raids and one solo crypt, with elite scaling, AoE boss mechanics, and class-archetype loot.
• Scalable delves, a small-group mode for one or two players plus an AI companion, rebuilt from randomized chambers each run across Normal and Heroic tiers.
• The Ashen Coliseum, a ranked PvP arena with 1v1 and 2v2 ladders plus a 2v2 Fiesta mode (augment pickups, a shrinking ring, first to fifteen takedowns).
• Real multiplayer: parties, trading, duels, tap rights, party-split XP, whispers, away status, and a server that owns every combat roll.
• Procedural everything: timber-framed towns, rigged creature families, painted spell icons drawn on canvas, WebAudio sound, biome weather, and real-time shadows. No 3D model files for the world.
• Localized into 22 locales through a deterministic, sim-emits-keys pipeline.
• Headless RL environment with Gymnasium bindings, reward shaping, and a benchmark mode.
• Web3-native: link a Solana wallet to show your $WOC balance and a cosmetic holder badge, fully optional and non-custodial.

Screenshots

Dusk at the Eastbrook campfire	Torch-lit elite pulls in the Hollow Crypt
The restless dead at the ruined chapel	Outnumbered at the bandit camp
Old Greyjaw, the rare spawn, run down on the north road	Gearing up at Trader Wilkes's, with the vendor and bags open
The drowned climb out at the Glimmermere moongate	Lunar Tempest and the altar of the Drowned Temple

Weather is biome-driven and render-only, so it never touches the deterministic sim:

Clear over the Vale	Rain over Mirefen Marsh	Snow on Thornpeak Heights

Play it

You have two ways in, and they run the same world.

Offline, in your browser

npm install
npm run dev        # then open http://localhost:5173 and click Play Offline

Name your character, pick any of the nine classes, and you start in Eastbrook Vale (levels 1-7), a market town ringed by six hubs: wolf runs to the north, boar meadows east, the Webwood west, Mirror Lake northwest, a burrower-ridden copper dig southwest, and a ruined chapel of restless dead northeast, with Gorrak's bandit camp to the southeast. The north road climbs a mountain pass into Mirefen Marsh (6-13, hub Fenbridge) and on up to Thornpeak Heights (13-20, hub Highwatch). The world seed is fixed in src/main.ts, so it is the same place every visit.

Online, with other players

See Host your own world below to stand up the real client/server game with accounts and persistent characters.

Desktop app

The Electron desktop shell wraps the same Vite client. Online sign-in is Discord and email only, exactly the web flow: email/password logs in inside the app, and "Continue with Discord" opens your default browser on the /desktop-login page, which hands a one-time code back to the app over a worldofclaudecraft:// deep link that the app exchanges for a normal World of ClaudeCraft session token.

npm run electron:dev          # Vite + Electron dev shell
npm run electron:pack         # local unpacked desktop app
npm run electron:build        # website-channel installers (self-updating)
npm run electron:build:steam  # SteamPipe depot layouts (in-app updater off)

Point the shell at a different API with VITE_DESKTOP_API_ORIGIN, for example a local server or a staging host:

VITE_DESKTOP_API_ORIGIN=http://127.0.0.1:8787 npm run electron:dev

Override the production API origin for staging builds with VITE_DESKTOP_API_ORIGIN=https://dev.worldofclaudecraft.com (a BUILD-time value: it is baked into the bundle and stamped into the packaged app, and installed builds ignore it as a runtime env var). Steam is a distribution channel only (the same Electron bundle, uploaded via SteamPipe); there is no Steam sign-in. The full release runbook (signing, notarization, publishing an auto-update, SteamPipe depots, the server deploy) is docs/desktop-release.md.

Host your own world (one command)

cp .env.example .env
# edit .env and set a long random POSTGRES_PASSWORD
docker compose up -d --build     # postgres + game server, fully built
# open http://localhost:8787 for accounts, characters, and the whole world

For remote hosting, put the compose stack on any VPS, set a real POSTGRES_PASSWORD in the environment, and front port 8787 with a TLS reverse proxy. Caddy makes this two lines (your.domain { reverse_proxy localhost:8787 }); WebSockets are proxied automatically and the client auto-selects wss:// on https pages. Auth endpoints are rate-limited per IP, passwords are scrypt-hashed, and tokens expire after 7 days. Never set ALLOW_DEV_COMMANDS=1 in production, since it enables the level and teleport cheats the test bots use. See DEPLOY.md for the full production guide.

Develop online with hot reload

npm install
cp .env.example .env
# set POSTGRES_PASSWORD and point DATABASE_URL at the same password
npm run db:up        # postgres 16 in docker (port 5433, volume-persisted)
npm run server       # authoritative game server on :8787 (REST + WebSocket)
npm run dev          # client dev server on :5173 (proxies /api and /ws)

Open http://localhost:5173, choose Play Online, create an account, create a character, and Enter World. Open a second tab and log in again to see each other in town. Enter opens chat. A real MediaWiki player wiki comes up alongside the Docker Compose stack at http://localhost:8080/wiki/; its seed pages are generated from current game content with npm run wiki:seed.

What persists and how the server stays in charge:

• Accounts: scrypt-hashed passwords and 7-day bearer tokens (auth_tokens).
• Characters: up to 10 per account; level, gear, bags, bank vault, quests, talents, position, and money persist as JSONB in Postgres, saved every 30 seconds, on logout, and on server shutdown. Names are globally unique, letters only, classic style.
• The server is authoritative: clients stream movement intent and commands at 20 Hz; the server runs the one shared Sim and returns interest-scoped snapshots (~120 yd) plus per-player events. Every combat roll, loot drop, quest credit, and vendor transaction resolves server-side. The client is a renderer.

Train an agent (headless RL)

The same deterministic core runs as a Gymnasium environment, so an agent learns against the actual game, not a reimplementation of it. The env server (headless/env_server.ts) wraps one Sim and speaks newline-delimited JSON over stdio; the Python bindings in python/ launch it as a subprocess and expose the usual reset / step / close loop.

npm run build:env    # bundle the env server to dist-env/env_server.cjs
npm run env          # run it directly (NDJSON on stdio)
npm run bench        # in-process throughput benchmark (no IPC)

# drive it from Python
pip install gymnasium numpy
python python/example_random_agent.py

from wow_env import WoWClassicEnv

env = WoWClassicEnv(player_class="warrior")   # warrior or mage
obs, info = env.reset(seed=42)
obs, reward, terminated, truncated, info = env.step(env.action_space.sample())
env.close()

• Observation and action spaces are content-derived. Query them from the env's info reply at startup rather than hardcoding; they grow with the game. Today the action space is Discrete(44) (movement, target, attack, the full ability kit, interact, eat/drink) and the observation is a Box of 276 floats (self, abilities, target, nearby mobs, nearest interactable, quest progress).
• Reward is a weighted sum of per-tick counter deltas (XP, damage dealt and taken, kills, deaths, quest progress, level-ups), tunable per reset. Each step applies one action and advances five sim ticks by default, so roughly four decisions per simulated second.
• Deterministic by construction. No wall clock, no Math.random. Seed the reset and the episode replays exactly.

The protocol and bindings are documented in headless/CLAUDE.md and python/CLAUDE.md.

Web3

World of ClaudeCraft is web3-native around $WOC, our community token on Solana. Connect a Solana wallet, link it to your account with one signature (non-custodial, no transaction to approve), and your read-only $WOC balance shows up in the HUD alongside a cosmetic holder-tier badge.

It is cosmetic only and not needed to play. Nothing is spent or earned in-game, there is no pay-to-win, and the whole game plays fine without ever connecting a wallet.

$WOC contract address (Solana):

3WjLscH2JsXLEFJZRA9z8ti8yRGxWGKbqymPd7UicRth

More on the token at worldofclaudecraft.com.

A tour of the world

The nine classes

Every class runs on classic-era MMO mechanics implemented from first principles, and learns ranked spells across levels 1-20 (Arc Bolt R2 at 8, R3 at 14, R4 at 20, with high-band abilities like Early Grave, Low Blow, Urgent Prayer, Ancestral Strike, and Skyfall arriving near the top of the band).

• Warrior: rage, Reaver Strike (on-next-swing, off-GCD), Iron Bellow, Onrush, Deep Gash, Quaking Blow, Hobbling Cut, Blood Toll, Redhand (dodge proc).
• Paladin: Oathbrand unleashed by Verdict, Mending Light, Steadfast Aura, Oath of Iron, Ward of Faith (absorb), Sundering Gavel (stun), Last Rite.
• Hunter: ranged auto-attack (8-35 yd with a classic-style dead zone), Gutting Strike, Harrier's Guise, Venom Barb, Fell Shot, Rattling Shot, Counterfang, Fettering Slash, and a tameable pet from level 10.
• Rogue: energy and combo points, Wicked Slash, Dirt Nap, Craven Thrust (behind, dagger), Eye Jab, Ghostfoot, Cutthroat Tempo, Swift Heels.
• Priest: Smite, Whispered Prayer, Litany of Resolve, Dirge of Decay, Psalm of Warding (absorb), Lingering Grace (HoT), Mindfracture.
• Shaman: Arc Bolt, Stonebound Weapon (imbue), Mending Waters, Earthen Jolt, Thunder Ward (thorns), Cinder Jolt.
• Mage: Cinderbolt, Hoarfrost Mantle, Aether Insight, Rimelance, Waterbind, Cinderfall, Aether Darts (channeled), Bewitch, Icebind.
• Warlock: Gloom Bolt, Fiendhide, Burning Pact, Blackrot, Hard Bargain, Hex of Anguish, Consume, and seven summonable demons from Emberkin to Wraithborn.