dMUD: Command Interface

The dMUD system utilizes a slash-command interface designed to be familiar to users of IRC and classic MUDs. As of May 17, 2026, the command system was overhauled with a dynamic command registry (commands_registry.go) containing 60+ commands across 12 categories.

Command Tags

Commands are annotated with genre tags for filtering on the public /commands page:

Tag	Colour	Category
`mud`	Green	Classic MUD commands (navigation, social)
`irc`	Blue	IRC-style commands (channels, privmsg)
`warcraft`	Orange	WoW/RPG integration
`arcade`	Purple	Mini-games and gambling
`telnet`	Cyan	Telnet-specific commands
`bbs`	Yellow	BBS-era nostalgia
`rpg`	Red	RPG mechanics
`generic`	Grey	General utilities
`discord`	Blurple	Discord integration

Command Registry Categories

Navigation & Movement

/goto, /go — Move to a room by name
/back — Return to previous room (tracks PreviousRoom)
/tp, /teleport — Teleport to hubs (with cooldown)
/list — mIRC-style room listing with number teleport
/rooms — List available rooms (IRC mode)
/map, /minimap — World map / toggle minimap

Communication & Social

/say — Send message to current room
/shout — Broadcast to all rooms
/yell — Loud message in current room
/whisper, /msg, /tell, /pm — Private message
/global, /g — Send to Global channel
/me, /emote — Action emote
/whois — Player lookup + location
/topic — Set/view room topic
/ignore — Manage ignore list

Information & Utility

/look, /l — Describe current room
/who, /w — List users in room
/motd — Message of the day
/help, /h, /? — Show all commands
/time — Show server time
/afk, /away — Toggle AFK status
/nick — Change display name
/stats — Show user statistics
/coin — Coin flip
/dice, /roll — Roll dice
/8ball — Magic 8-ball
/yesno — Yes/no oracle
/jimjoke — Jim joke
/dance, /wave, /think — Animated emotes
/flip — Table flip
/weather — Current weather
/rng — Random number generator

RPG & Economy (Warcraft-tagged)

/wallet, /balance — View gold/balance
/pay — Pay another player
/inventory, /inv — View inventory
/use — Use an item
/drop — Drop an item
/give — Give item to player
/trade — Trade with NPC
/pet — Pet management (adopt, feed, buyfood)
/shop — Open shop
/mail — Mail system
/hud — HUD toggle
/prefs — User preferences (show, minimap, hud, timestamps, notify, color, ignore)
/duel, /challenge — PvP challenge
/inspect, /examine — View player equipment
/scores — High scores

Arcade & Games (Arcade-tagged)

/play — Start a mini-game (snake, fishing, slots, blackjack, numberguess)
/stop, /leave — Stop current game

Room Management

/room — Room creation wizard (create/edit/info)
/alias — Manage custom command aliases (admin)
/reload — Reload configs (rooms, users, aliases, docs, all)
/channel, /chan — IRC channel management

Admin & System

/summon — Summon agent (admin)
/quit, /q, /exit — Disconnect
/clear — Clear terminal (telnet)
/photo — Discord photo command

Full Command List

For the complete enumerated list of all 60+ commands with their aliases and tag assignments, see the AGENTS.md command table in the project root, or query the live API at /api/commands.

Implementation Notes

Dynamic Registry: commands_registry.go replaced the hardcoded Parse() switch — commands are now registered at runtime with metadata (aliases, tags, categories)
Directional Shortcuts: Single letters n/s/e/w/u/d work as shortcuts in Parse()
Tag Filtering: The public /commands page has clickable tag filter buttons
Admin Alias Manager: Custom aliases can be added/deleted via the Admin UI (Commands & Aliases tab)