v1.5.0  •  MIT License

A Modern MUSH Server

High-performance, modular MU* engine built with TypeScript and Deno.
WebSocket-native • Sandbox scripting • Plugin architecture • Discord bridge.

terminal
# Install the UrsaMU DX bootstrapper
deno install -A --global -n deno-x jsr:@dx/dx
deno x --install-alias
# Initialize a new world
dx jsr:@ursamu/ursamu init

WebSocket Native

First-class WebSocket interface with a 10 cmd/sec rate limiter. Connect from any browser or MU* client.

Sandboxed Scripting

Scripts run in Web Workers with a rich SDK — database access, messaging, rooms, and channels — without touching the host.

Plugin Architecture

Extend the engine with typed plugins. Add commands, hooks, flags, routes, and custom database services.

Discord Bridge

Built-in Discord integration with exponential-backoff reconnect — relay in-game chat to Discord channels and back.

Flexible Database

Pluggable database layer (dbojs) for game objects, channels, mail, and bulletin boards. Query by flags, owner, or custom data.

Scene Archive

Collaborative roleplay scene tracking with REST export endpoints — download logs as Markdown or JSON.

Game Hooks

Typed, fire-and-forget event bus — 12 built-in events covering players, scenes, and channels. Plugins subscribe without touching core command files.

Wiki & Content

File-based markdown wiki with folder-driven routing, YAML frontmatter, full REST API, and in-game read/search/write commands.

Jump to a section

Installation

Get UrsaMU running in minutes with the DX wizard or from source.

Player Guide

Commands, movement, communication, building, and object interaction.

Admin Guide

User management, channels, scene export, rate limiting, and security.

API Reference

Core, database, command, flag, hook, and utility APIs documented in full.

Plugin Dev

Build plugins that add commands, hooks, flags, and custom services.

Contributing

Help shape UrsaMU — from bug reports to PRs and new features.

Architecture at a Glance

Runtime
Deno (TypeScript) • ESM modules • Web Workers for sandboxing
Transport
WebSocket hub (4202) • HTTP REST (4203) • Telnet sidecar (4201)
Persistence
dbojs (game objects) • chans • mail • bboard • counters
Integrations
Discord gateway • Scene REST API • Wiki REST API • Plugin SDK
Events
GameHooks typed bus • WikiHooks • EventHooks • Daemon restart loop (exit 75)

Community & Links

GitHub Discord Quick Start