Get Started

SharpMUSH can easily be installed locally, or on a remote server, thanks to Docker. It is a MUSH server with a web portal attached, so installing it gets you both a telnet game and a website for it.

To get started, pick the option that best aligns to your needs:

Try it first Our live example game runs the current build. Have a look around before installing anything.

Launch a Server The quickest way to a public game. Rent a server, paste one block of text or fill in a form, and an installer sets everything up.

Run with Docker (Recommended) The best option if you want to run a game. One Compose file brings up the game server and its web portal, the connection server, and NATS. The world is an embedded LMDB database on disk.

Migrate from another MUSH Rehearse a one-way import, validate your world, cut over with evidence, and retain a rollback path.

Develop SharpMUSH Build from source to change the server or the portal, or to contribute to the SharpMUSH project.

Once it is running

The Web Portal First-run setup, the admin panel, the wiki, and the in-browser terminal.

Visual Layouts and Images Create a consistent visual language that adapts to terminals, the portal, personal themes, and screen readers.

Operator Handbook First claim, backups and restore drills, upgrades, monitoring, and incident entry points.

Connect Screen and MOTD Change what a new connection sees and the message of the day players get on login.

Softcode Packages Install and upgrade global softcode from a repository. Safer than pasting in .mush files.

Writing Plugins Extend the server with compiled C#, without forking it.