A modern MUD (Multi-User Dungeon) driver inspired by LDMud, built with Node.js and TypeScript. Write game content in TypeScript, hot-reload it without restarts, and connect players through a browser-based web client.
- TypeScript everywhere - Game content, driver, and client all in TypeScript with full type safety
- Runtime hot-reload - Modify rooms, NPCs, and commands while the game is running
- Browser-based client - Dark-themed web UI with stats panel, minimap, quest tracker, and sound
- AI-powered NPCs - Dynamic dialogue, content generation, and worldbuilding via Claude AI
- Rich game systems - Combat, guilds, quests, professions, pets, mercenaries, vehicles, and more
- Pluggable persistence - Filesystem (default) or Supabase cloud storage
- External integrations - Discord bridge, Giphy, Intermud 3/2, Grapevine cross-MUD network
Modern dark-themed login interface
Character score with stats, equipment, and guild information
Visual area builder for creating game content
git clone https://github.com/jasona/mudforge.git
cd mudforge
npm install
npm run devOpen http://localhost:3000 in your browser and create a character.
| Component | Technology |
|---|---|
| Runtime | Node.js 22+ LTS |
| Language | TypeScript 5.x |
| WebSocket | ws |
| Web Server | Fastify |
| Client Editor | CodeMirror 6 |
| Compilation | tsx (runtime), esbuild (client) |
| Testing | Vitest |
Full documentation lives in the /docs directory, organized into sections for players, builders, admins, and engine internals. Start here:
- Getting Started - Installation, configuration, and first steps
- Architecture - How the driver and mudlib work together
- Mudlib Guide - Creating rooms, items, NPCs, and game content
- Commands Reference - All player, builder, and admin commands
- Efuns Reference - Complete driver API (~55 functions)
- Deployment Guide - Docker, PM2, environment variables, and production setup
Browse the full documentation index for 65+ guides covering every system.
- Discord: https://discord.gg/GEBatdTCYZ - Chat with developers and other MUD builders
- GitHub Issues: Report bugs or request features
MudForge draws inspiration from LDMud, the classic LPMud driver.
MIT