This repository contains the RoomJS game engine (or server).
RoomJS is a modern Node.js-based MUD/MOO engine, where (privileged) players can extend everything while in game. The basic idea is that one can create and edit objects, locations and code from inside the game.
The engine includes built-in WebSocket (SocketIO) communication, user account management, flexible command parsing system and persistent on-disk storage.
The RoomJS server requires Node.js 6.0 or newer.
Clone the repository or download a ZIP archive.
Installation steps are straightforward:
npm install- Create a
.envfile to customize the server's configuration. See.env.developmentfor examples and explanations. npm start
To interact with the server, you must use a web client application. The standard client is provided in a separate repository.
These are but a few of all the things that you get just out-of-the-box:
-
Modern Playing:
- Connect and play simply using a web browser. No need for good old telnet or third-party MUD client.
- Fully enjoy the leveraged experience, with colors and clickable links!
-
Advanced Scripting:
- Code your game in plain modern JavaScript (ES6), using a nice oriented-object design with inheritable traits, with all scripts running in sandboxes. No need for proprietary custom programming languages.
- Edit your code directly in the browser, using the well-known in-browser code editor CodeMirror with syntax coloring and other neat features. No need to leave the game in order to add features and hotboot your changes.
-
Flexible On-Disk Structure:
- All objects are stored in JSON format, in subdirectories along with their attached scripts in JS files: real easy to work with, or to parse for external usage if you ever need to quit the in-browser editing for any reason. No need for custom file formats, YAML entities or other weird things.
- Name and organize your assets logically according to your own needs, without strong restrictions. No strongly imposed directory structure.
-
Easy Communication Channels:
- Out-of-the box "Say" channel for the chatty ones, "Chat" channel for broadcasting... and "Eval" mode for the developers.
- Extensible and easily customizable "mode" system.
-
Powerfull Debugging:
- The game engine relies on Bunyan, a simple and fast JSON logging library, with a nice CLI for viewing and analyzing logs.
-
Lightweight Demonstration:
- The server is bundled with but a small demonstration, to illustrate a few possible ways of coding your own world. No huge codebase with so many specific combat or leveling rules, or complex skill systems, that one would immediately get lost.
- Use it as a base, or wholly replace it, focussing on your own gaming logic!
Live demonstration: http://roomjs.tk/
And it even comes with documentation...
- Building and programming your own RoomJS MUD/MOO
- Organizing and customizing your world objects
- A brief description of the demonstration mudlib
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.