ellymud

EllyMUD is a Multi-User Dungeon written in Node.js and TypeScript. It accepts connections over Telnet on port 8023, WebSocket and a bundled xterm.js web client on port 8080. The first boot prompts for an admin password. Gameplay features include real-time turn-based combat with NPCs and PvP, abilities and spellcasting with mana and cooldowns, a room-based world with safe zones, shops, banks, and combat areas, a 12-slot equipment system, inventory and vendor economy, character progression through levels and stat training, status effects such as poisons, stuns, roots, buffs, debuffs, and heals, rest and meditation recovery, multi-user chat with say, yell, and emotes, and a Snake mini-game. The project also provides a REST and React admin dashboard on port 3000 with a drag-and-drop World Builder, a Model Context Protocol server on port 3100 with API-key authentication for AI and headless testing, bcrypt password hashing, RBAC, JWT for admin access, API keys for MCP, and per-user daily-rotated logging. Storage is pluggable through JSON by default, SQLite, or PostgreSQL using an environment variable switch. The repository includes Jest unit, integration, and end-to-end tests, and is licensed under AGPL-3.0-or-later with commercial licensing available on request.