A lo-fi blobber MMORPG built on real MUD data — combining AI-driven data extraction from Arctic MUD with a custom game server and Godot 4.6 client.
project-aegis/
├── server/ # Node.js game server (Express, Socket.io, Prisma/SQLite)
├── client/ # Browser web client (HTML/JS, Socket.io)
├── godot-client/ # Godot 4.6 blobber client (GDScript, 3D dungeon, Gothic UI)
├── logicbot/ # AI bots and data capture tools
│ ├── arctic-bot/ # v1 MUD bot — dual-char, 8 capture modules, 300+ rooms mapped
│ ├── arctic-bot-v2/ # v2 self-improving AI agent with learning loop
│ ├── heal-bot/ # Standalone cleric healbot
│ ├── live-feed/ # Real-time bot event stream
│ ├── mudlet/ # Lua scripts for Mudlet MUD client
│ └── asset-pipeline/ # Procedural asset generation tools
├── data/ # All Arctic MUD captured & compiled data
│ ├── raw-dump/ # 900+ raw MUD session logs
│ ├── raw-texts/ # 2800+ scraped MUD text files
│ ├── reference/ # Organized reference data (classes, spells, zones, etc.)
│ ├── extract/ # Structured data extractions
│ ├── databases/ # Compiled JSON databases (items, mobs, spells, zones)
│ └── misc/ # Loose data files, archives
├── scripts/ # Python data processing scripts, batch files
├── docs/ # Design documents, integration guides, analysis
└── assets/ # Game art, graphics, and map images
-
Data Capture: AI bots connect to Arctic MUD (mud.arctic.org:2700), explore the world, and extract real game data — rooms, mobs, items, spells, combat mechanics, help topics.
-
Data Compilation: Raw captured data is processed into structured databases that feed the Aegis game server — authentic spells, classes, races, and combat systems derived from a real MUD with 30+ years of game design.
-
Game Server: Node.js server implements an MMORPG with Arctic-inspired mechanics — 15-circle spell system, pray/memorize casting, position-based combat, 11 classes, 20+ races, skill progression, crafting, housing, auction house.
-
Clients: Both a browser client (Socket.io) and a Godot 4.6 blobber client (raw WebSocket) connect to the same server. The Godot client features 3D dungeon rendering, Gothic UI, combat text popups, spell books, and a full character creation wizard.
| Branch | Purpose |
|---|---|
main |
Stable trunk — all project components |
data/arctic-capture |
Arctic MUD data scraping, help crawling, database compilation |
ai/arctic-bot |
Arctic MUD bot AI development (exploration, combat, learning) |
ai/aegis-bot |
Aegis game bot AI (testing, automation) |
client/godot |
Godot 4.6 blobber client development |
server/aegis |
Game server features, world building, combat systems |
- Server: Node.js, Express, Socket.io, Prisma ORM, SQLite
- Web Client: Vanilla HTML/JS, Socket.io, Canvas map renderer
- Godot Client: Godot 4.6, GDScript, WebSocketPeer, 3D Forward+
- Bots: Node.js, raw Telnet, ANSI parsing, Claude AI integration
- Database: SQLite (Prisma), JSON knowledge bases
# Server
cd server && npm install && npx prisma db push && node src/index.js
# Godot Client
# Open godot-client/project.godot in Godot 4.6, hit F5
# Arctic Bot (explore mode)
cd logicbot/arctic-bot-v2 && npm install && node index.js --goal exploreArctic MUD → Bot Capture (rooms, mobs, items, spells, help)
→ JSON databases → import-arctic-data.js → Aegis server world data → Live game