NodeJS based MUD engine

See the staging branch for the latest features.

Ranvier is not a websocket MUD. It does not have a web client. It is a plain ol' fashioned telnet MUD. Any client you use to connect to the MUD you played 15 years ago will work with Ranvier.


Docs can be found on our website ranviermud.com


We have a slack channel you can use to ask questions, suggest features, or just keep up to date with the project. https://ranviermud.slack.com

Get an invite


  • Robust bundle system: Nearly every aspect of the game can be modified without changing the core and allows for easy packaging and sharing of commands/areas/items/npcs/channels/behaviors.
  • Scripting support: It's in Javascript! No need for a shitty DSL. The codebase is javascript, the scripting is javascript.
  • Scripting is event-based. Put a listener in the script attached to your mob and it'll automagically happen when the event is emitted. Adding new events is easy as npc.emit('eventName'); See documentation on node event emitters for more.
  • Pfile saving in JSON, easy to parse for external usage.
  • Rooms, items, and npcs are easily described in yaml. No weird bullshit ~~~~ and byte-specific parsing that requires a GUI editor to build.
  • Did I mention it's in blasting Javascript? No compiling, no C, no cygwin, no 15 year old spaghetti code.
  • Leveling, passive/active skills, effects.
  • Flexible channel system.
  • Incredibly simple-to-add commands.
  • Quest system allowing for starting/progress/completion from any event in the game
  • Simple Diku-style combat system


  • NodeJS >= v7.1.0

Up and running

git clone git://github.com/shawncplus/ranviermud
cd ranviermud
npm install
sudo ./ranvier -v --save=10 --respawn=10

Connect to the server using telnet localhost 23


There is an in-progress Web interface for viewing information about the MUD and building areas in real time. Currently, the following routes are supported:


Right now, you can whitelist IPs by adding them to a key called webWhitelist in ranvier.json. By default only the local host IP is whitelisted.

Common Issues

Debugging in Visual Studio Code

Visual Studio Code's built-in terminal will incorrectly render Ranvier output unless you set the console to "externalTerminal" or "internalTerminal", "internalConsole" will not work. View the relevant Visual Studio Code documentation here: https://code.visualstudio.com/docs/editor/node-debugging#_launch-configuration-attributes