Dmud Enhancement

Last updated: May 31, 2026

dMUD: The Super Terminal Enhancement

The dMUD module is being transformed into a Super Terminal—a multi-user social ecosystem that combines the utility of a modern terminal with the soul of classic BBS and MUD systems.

🌟 The Vision: "IRC meets RPG meets Agent Hub"

dMUD is the definitive "Partyline" for the dLAN ecosystem. It is an all-in-one terminal environment for:

  • System Orchestration: Perform real-world admin tasks via AI agent whispers.
  • Social Gaming: Play mini-games (Snake, Fishing, Slots) with other live users.
  • Idle Aesthetics: High-performance ASCII screensavers for AFK periods.
  • Persistent Life: Nurture pets and level up your character in a persistent world.

💰 Economy & Progression

The economy system bridges the gap between gaming and utility:

  • Gold & XP: Earned through engagement, games, and daily login bonuses.
  • RPG Stats: Persistent levels that grant access to restricted rooms and prestige features.
  • Eggdrop Logic: Automated bot-led events and social triggers within the chat flow.

🐾 Pet System (The Digital Menagerie)

A deep management system with 12 species ranging from Kittens to Dragons:

  • Nurture: Feed and play with your pet to keep hunger low and happiness high.
  • Automation: Install "Auto-Feeders" and "Comfort Nests" to maintain your pet while you're away.

🎮 Arcade & Super Terminal Utilities

The environment is divided into specialized "Rooms" that serve as functional contexts:

  • Arcade Hub (sys_arcade): The center for gambling and skill-based ASCII games.
  • Dashboard (sys_system): A live terminal dashboard showing CPU, RAM, and cluster health.
  • Screensavers: Toggleable high-frame-rate ASCII animations (Matrix rain, Fish Tank, Starfield).

🤖 AI Agent Presence (The Agent Bridge)

Agents are no longer just "chatbots"; they are citizens of the Super Terminal:

  • Physicality: Agents spawn into rooms with entrance/exit messages.
  • Orchestration: Delegate tasks to agents via call_agent and watch them appear to help you.
  • Contextual Awareness: Agents know who else is in the room and can participate in group discussions.

🛠️ Technical Implementation

  • Dual-Stack Server: Telnet (Port 7777) and WebSocket + HTTP (Port 7778) — see dmud/server.go and dmud/dmud.go.
  • Hot-Reloadable Content: /reload rooms, /reload users, /reload aliases, /reload docs, /reload all (via RoomManager.ReloadRooms(), DocCache.Reload(), etc.). No downtime required.
  • Lua Scripting: Full embedded Lua VM in npc_script.go with give_item, event triggers (on_user_enter, on_chat, on_trade, on_item_use, etc.), and per-NPC mutex serialization.
  • Dynamic Room System: 64+ rooms defined in dmud/data/rooms/*.ini (system + player-created). Includes extensive castle zone, agent dens, ambient rooms, and custom player housing. LoadRoomFromINI + full CRUD via /room commands.
  • Commands Registry: Dynamic registration in commands_registry.go (85+ slash commands across categories, tag-based filtering, admin alias manager).
  • Recent Subsystems (current source): items.go (inventory/trade), mail.go, photo.go, farm.go, agent_bridge.go, room_creation.go (wizard), history.go, time.go.

See also: dMUD Overview, Web Servers