mush 1.0.30 · cli 0.1.2 · MIT

A Modern MUSH Server

High-performance MU* engine in TypeScript and Deno. WebSocket hub, public portal, staff console, sandboxed scripts, JSR plugins.

Get Started GitHub Read the Docs

Install

Quick start

Terminal

# Scaffold a game (engine + portal stack)
deno run -A jsr:@ursamu/cli@0.1.2/create my-game
cd my-game
deno task start
# http://localhost:4203/  ·  /play  ·  /admin/

Product

Capabilities

Transport: WebSocket hub with rate limits — browser play, custom clients, or Telnet
Runtime: Scripts in Web Workers with the full SDK — a bad attr cannot crash the host
Plugins: Typed packages: commands, hooks, flags, routes, namespaced DBO
Front ends: @ursamu/site (/play) and @ursamu/web (/admin) on one HTTP port
Database: TypeGraph/PGlite by default, Deno KV fallback — query by flags, owner, data
Softcode: TinyMUX 2.x evaluator — 250+ functions, attributes, @trigger, $-patterns
Events: Typed GameHooks bus for login, say, move, scenes, and plugin events
Integrations: Optional Discord bridge with reconnect/backoff via JSR
Installs: Fail-fast manifests with semver checks and whole-run rollback

System

Architecture

One Deno process stack: game hub, HTTP portal, and Telnet sidecar.

Runtime: Deno · TypeScript · ESM · sandboxed Web Workers
Transport: 4201 telnet · 4202 ws hub · 4203 http api + site
Engine: @ursamu/mush on @ursamu/core
Public FE: @ursamu/site — portal, skins, /play
Staff FE: @ursamu/web — console at /admin/
Persistence: TypeGraph / PGlite (default) or Deno KV · namespaced DBO
Plugins: JSR packages · help, bbs, mail, wiki, jobs, discord, …
Events: GameHooks bus · supervised restart (exit 75)

Community