World of ClaudeCraft

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.

• Nine classic classes, each with a real vanilla-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 90 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.
• 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 14 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.

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 Smith Haldren's, with tooltips, bags, and coin
The drowned climb out at the Glimmermere moongate	Moonfire 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

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

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

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

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.

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

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

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.

Every class uses real vanilla-style mechanics and learns ranked spells across levels 1-20 (Lightning Bolt R2 at 8, R3 at 14, R4 at 20, with high-band abilities like Execute, Kidney Shot, Flash Heal, Stormstrike, and Starfire arriving on their classic level).

• Warrior: rage, Heroic Strike (on-next-swing, off-GCD), Battle Shout, Charge, Rend, Thunder Clap, Hamstring, Bloodrage, Overpower (dodge proc).
• Paladin: Seal of Righteousness unleashed by Judgement, Holy Light, Devotion Aura, Blessing of Might, Divine Protection (absorb), Hammer of Justice (stun), Lay on Hands.
• Hunter: ranged Auto Shot (8-35 yd with the classic dead zone), Raptor Strike, Aspect of the Hawk, Serpent Sting, Arcane Shot, Concussive Shot, Mongoose Bite, Wing Clip, and a tameable pet from level 10.
• Rogue: energy and combo points, Sinister Strike, Eviscerate, Backstab (behind, dagger), Gouge, Evasion, Slice and Dice, Sprint.
• Priest: Smite, Lesser Heal, Power Word: Fortitude, Shadow Word: Pain, Power Word: Shield (absorb), Renew (HoT), Mind Blast.
• Shaman: Lightning Bolt, Rockbiter Weapon (imbue), Healing Wave, Earth Shock, Lightning Shield (thorns), Flame Shock.
• Mage: Fireball, Frost Armor, Arcane Intellect, Frostbolt, Conjure Water, Fire Blast, Arcane Missiles (channeled), Polymorph, Frost Nova.
• Warlock: Shadow Bolt, Demon Skin, Immolate, Corruption, Life Tap, Curse of Agony, Drain Life, and seven summonable demons from Imp to Doomguard.
• Druid: Wrath, Healing Touch, Mark of the Wild, Moonfire, Rejuvenation, Thorns, Entangling Roots, Bear Form at 10.

Heals and buffs land on party members, healing can crit, and absorb shields soak damage before health. Spend points across three talent specs per class (Arms/Fury/Protection, Balance/Feral/Restoration, and so on); allocation is server-validated and exportable as a build string.

The Gravecaller storyline runs through four five-player elite instances, and a solo crypt sits off to the side for explorers.

• The Hollow Crypt (5 players) beneath the Fallen Chapel: paired elite trash, the Sexton Marrow miniboss, and Morthen the Gravecaller, who drops a Shadow Pulse AoE every ten seconds. The crypt door teleports your party into a private instance copy that resets after five minutes empty.
• The Sunken Bastion (5 players, around level 13, southeast Mirefen): Vael the Mistcaller summons waves of Drowned Thralls at 60% and 30% health.
• Gravewyrm Sanctum (5 players, level 20, beneath Thornpeak): three chambers of elite boneguard and drakonid, Korgath the Bound (enrages below 30%), Grand Necromancer Velkhar, and Korzul the Gravewyrm, where epic weapons drop.
• The Drowned Temple (5 players) through the Glimmermere moongate: a pale, moon-violet instance leading to Choirmother Selthe and then Ysolei, Avatar of the Drowned Moon, who pulses Lunar Tide every nine seconds and summons Moonspawn at 60% and 30%.
• The Abandoned Crypt (solo) in Thornpeak: a quiet keystone-and-diary dive for one, no boss, just the story.

The lead-up quest chains are soloable, so the story is never gated behind finding a group. Our automated five-bot raid (warrior, paladin, priest, mage, hunter with focus-fire and healer AI) clears the Hollow Crypt in about five minutes (node scripts/crypt_raid.mjs, needs ALLOW_DEV_COMMANDS=1).

Press G or the arena button to queue. Matchmaking teleports fighters into a private, torch-lit pit, a short countdown heals and resets everyone for a fair start, and the bout ends when a side yields at 1 hp. Nobody dies, and you return exactly where you queued.

• 1v1 and 2v2 ranked ladders, each with a persistent Elo-style rating (everyone starts at 1500) and an all-time leaderboard (GET /api/arena/leaderboard).
• 2v2 Fiesta, a livelier party mode: first team to fifteen takedowns wins inside a six-minute cap, players respawn on growing timers, augment pickups drop power across three waves, and a closing ring forces the fight together.

• Parties up to 5: right-click a player and Invite to Party. Members share tap rights and quest credit, split XP with the real vanilla group bonuses (1.166 / 1.3 / 1.43 for 3/4/5), and show up as blips on the minimap. /p for party chat, /roll to settle loot.
• Trading: right-click and Trade. Both sides stage items and money, both must accept, and the swap is atomic and server-validated. Quest items cannot be traded, and walking apart cancels.
• Duels: right-click and Challenge to a Duel. A 3-second countdown, then fight until one side hits 1 hp; the winner is announced zone-wide and running 60 yards away forfeits.
• Tap rights and away status: the first player to damage a mob owns its loot, XP, and quest credit; /afk and /dnd mark you away with an auto-reply to whispers.

• Eating and drinking: sit to restore over 18 seconds, broken by damage or standing, and yes, you can eat and drink at once.
• Vendors that buy food and water and sell honest white gear, with coin shown in gold, silver, and copper.
• Mob AI: wander, proximity aggro by level difference, social pulls, chase, leash and reset, corpse loot, and respawns, with a rare spawn (Old Greyjaw) on a long timer.
• Fishing spots with their own loot tables and rare catches.
• Cosmetic skins rolled at uncommon, rare, and epic rarity, purely for looks.
• Death and recovery: release your spirit to the graveyard, take falling damage, and slow down while swimming.
• Biome weather: clear in the Vale, rain in the Marsh, snow on the Peaks, cross-fading as you move between zones.

Touch controls (a movement stick, camera drag, and on-screen action buttons) come up automatically on mobile.

Three ideas hold the project together:

• One sim, three hosts. The same src/sim/ code runs the offline browser world, the online server, and the RL env. Behavior must be identical everywhere, and the tests exist to keep it that way.
• IWorld is the only seam. src/world_api.ts defines IWorld. The offline Sim satisfies it structurally and the online ClientWorld implements it by mirroring server snapshots. The renderer and HUD talk only to IWorld, never to a concrete world, so a new feature extends the interface first and then both worlds.
• The server is authoritative. Clients send intent; the server decides outcomes. The client never resolves combat, loot, or economy on its own.

The sim is a fixed 20 Hz tick (DT = 1/20), all randomness flows through one seeded Rng, and src/sim/ carries zero DOM, browser, or Three.js imports. That is what lets the same code bundle into a Node env server, an authoritative game loop, and a browser tab without changing a line.

Most directories carry their own CLAUDE.md with local conventions. The full set of project invariants lives in the root CLAUDE.md.

Combat, leveling, and threat all run on authentic classic-era rules: rage and energy, hit and dodge tables, armor mitigation, the real XP curve, swing timers, and the global cooldown. It feels the way you remember rather than approximating it. The exact numbers live in src/sim/ if you want to read them.

And almost none of it is a shipped asset. The world is drawn from code:

• Procedural towns, creatures, terrain, water, weather, and real-time shadows, with no 3D model files for the world.
• Twelve rigged creature families with full walk, attack, cast, sit, and death animations.
• Spell, item, and buff icons painted on canvas at runtime.
• A complete classic HUD (unit frames, action bars, tooltips, quest log, world map, minimap, floating combat text) and procedural WebAudio for every sound.

npm test                        # vitest: formulas, combat, AI, quests, all 9 classes, parties, duels, trades, dungeons
npm run build                   # production web build
node scripts/smoke_browser.mjs  # warrior end-to-end (needs npm run dev)
node scripts/smoke_mage.mjs     # mage: casting, polymorph, conjure and drink, death and release
node scripts/visual_tour.mjs    # screenshot tour of the zone and UI into tmp/
node scripts/tour_temple.mjs    # screenshot tour of the Glimmermere and Drowned Temple into tmp/
node scripts/mp_integration.mjs # API, WS, and persistence checks (server running)
node scripts/social_e2e.mjs     # trade and duel over the wire (ALLOW_DEV_COMMANDS=1)
node scripts/arena_visual.mjs   # two clients queue and fight a ranked 1v1
node scripts/crypt_raid.mjs     # five bots clear the Hollow Crypt (ALLOW_DEV_COMMANDS=1)

Logic and unit tests use Vitest. While iterating, run a single file: npx vitest run tests/sim.test.ts. The E2E and visual scripts drive real browsers via puppeteer-core and need npm run dev running (often npm run server too). Browser agents can drive movement through window.__game.controller instead of simulating held keys, for example controller.move({ forward: true }, facingRadians) or compact flags like { f: 1, sr: 1 }.

For the server commands see Develop online above, DEPLOY.md for production, and CREDITS.md for asset licenses.

Every player-visible string resolves through t(), and the game ships in 14 locales (English, two Spanish, two French, English Canada, Italian, German, Simplified and Traditional Chinese, Korean, Japanese, Brazilian Portuguese, and Russian). The sim and server stay language-agnostic: they emit stable keys or English that the client re-localizes at the boundary, which keeps determinism intact. Contributors add English only; the maintainer batch-fills the other locales before each release. The workflow is documented in docs/i18n-scaling/translation-workflow.md.

Contributions of every kind are welcome: code, translations, bug reports, and documentation. Start with CONTRIBUTING.md for setup, read the Code of Conduct, and check SECURITY.md before reporting a vulnerability. New here? Look for issues labeled good first issue, open an issue, or say hello on Discord.

The code is MIT licensed, so fork it, remix it, and host your own world.

The bundled third-party art assets (models, textures, HDRIs) keep their own licenses, all CC0 public domain except the MIT water normal maps, documented per pack in CREDITS.md.