Weights & Wyverns is a multiplayer text-based dungeon game that lives inside your Claude Code session. Instead of typing cryptic commands, you speak naturally -- "go north and check out that chest" -- and Claude translates your words into game actions, then narrates the results in vivid prose. Your AI companion fights alongside you, strategizes about tactics, and converses with genuine personality. No MUD has ever had NPCs that could actually think. This one does.
The game runs as a centralized Rust server. You connect through an MCP (Model Context Protocol) server that runs locally alongside Claude Code. Claude sees the game tools, understands the world, and acts as both your narrator and the voice of your AI companion. All game state lives on the server -- combat, economy, quests, parties -- so every player shares one persistent world.
Install the MCP client, type /ww, and Claude greets you. Pick a name and class (Warrior, Mage, Rogue, or Cleric), and your companion appears. You start in a short tutorial: three rooms teaching you to look, move, and fight. Then you step into the Town Hub and the real world opens up. The whole process takes less than five minutes.
AI Companion
Every player has a companion controlled by Claude. It fights alongside you, reasons about tactics ("The troll regenerates -- use fire"), follows your commands, and converses with genuine personality. Choose brave warrior, cautious scholar, sarcastic rogue, or stoic guardian.
Equilibrium/Balance Combat
Inspired by Achaea. Every action costs equilibrium (mental) or balance (physical), recovering in 2-4 seconds. Choosing the right action matters more than reaction speed -- perfect for text and LLM latency. Status effects interact tactically: poison plus paralysis, blind plus prone.
Four Classes
Warrior (tank/melee DPS, heavy attacks, shield moves), Mage (ranged DPS/control, spells, staff attacks), Rogue (burst DPS, backstab, poisons, traps), and Cleric (healer/support, buffs, holy strikes). Each has 15-20 abilities unlocked through leveling.
Party System
Form parties of 2-4 players. Shared XP split by contribution. Coordinated combat with tanks drawing aggro and healers targeting allies. AI companions of all party members participate -- a 4-player party means 8 combatants. Auto-matchmaking available.
Persistent World
One server, one world, one community. Guilds, an auction house, leaderboards, and zone resets following the classic MUD model. Your character persists between sessions. Gold economy with meaningful sinks. Dungeon bosses with the best loot.
Hub-and-Spoke World
A central Town Hub for socializing, shopping, and quest boards. Four surrounding zones radiate outward with increasing difficulty: the Enchanted Forest, the Deep Mines, the Dark Forest, and the Wilds. Dungeons offer multi-room challenges designed for parties.
-
Build the MCP client
Clone the repo and build: cd client && cargo build --release
-
Register with Claude Code
Run: claude mcp add --transport stdio ww-client ./target/release/ww-client -- --server ws://MudSta-netwo-kCSYczbTcWoJ-1479263896.us-east-1.elb.amazonaws.com/ws
-
Launch Claude Code
Open your terminal and start a Claude Code session as usual.
-
Connect to the game
Type /ww and Claude will greet you and begin character creation.
-
Create your character
Pick a name and choose from four classes: Warrior, Mage, Rogue, or Cleric.
-
Complete the tutorial
Three short rooms teach you to look, move, and fight. Takes about two minutes.
-
Enter the world
Step into the Town Hub. Check the quest board, visit shops, or head into the wilds.
| Command | Description |
|---|---|
look | Observe the room or examine a target |
move | Travel in a direction (north, south, east, west, up, down) |
map | Show an ASCII map of explored rooms |
| Command | Description |
|---|---|
attack | Attack a target with your weapon |
use_ability | Use a class ability on a target |
flee | Attempt to escape combat |
status | View HP, mana, eq/balance, active effects |
| Command | Description |
|---|---|
inventory | List carried items |
get | Pick up an item from the room |
drop | Drop an item |
equip | Equip a weapon or armor |
use_item | Use a consumable (potion, scroll, food) |
| Command | Description |
|---|---|
say | Speak to everyone in the room |
tell | Send a private message |
shout | Broadcast to the zone (costs gold) |
emote | Perform a custom action |
who | List online players |
channel | Send to a chat channel (ooc, trade, guild) |
| Command | Description |
|---|---|
party_invite | Invite a player to your party |
party_accept | Accept a party invitation |
party_leave | Leave your current party |
party_list | Show party members and status |
matchmake | Queue for auto-matchmaking |
| Command | Description |
|---|---|
companion | Give your AI companion an instruction |
companion_status | Check companion HP and behavior |
| Command | Description |
|---|---|
character_info | Full character sheet |
abilities | List available abilities and cooldowns |
quests | View active and completed quests |