README.md

Dice.io

A simple Node.js dice roller server.

Getting started

Install server from NPM :

$ npm install -g dice.io

Run the server (use -h for help) :

$ diceio -a 127.0.0.1 -p 8080

Then open http://127.0.0.1:8080 in your browser to display demo application.

Dice roller client library

Application server provide a Javascript client library to create your own web application.

Miro integration

Application server provide a Web Plugin for the Miro online collaborative whiteboarding platform.

Miscellaneous

• Nginx proxy configuration examples
• Linux systemd service file example

About

Project main goals are to provide :

• a simple collaborative way to roll dice formula
• a client library to allow custom integration

If you wish another Javascript dice engine to be added to the project, create a new issue.

A live demo is available here, hosted on a small Heroku free instance. Please don't use it as main server, instead deploy your own server following this guide.

Credits

This project mainly uses the following dependencies :

• dice.js
• express
• rpg-dice-roller (server default engine)
• rpgdice
• socket.io

Dice SVG icon originally made by Freepik from www.flaticon.com.

"Shake And Roll Dice" sound made by Mike Koenig from sounbible.com. Creative Commons.

License

The MIT License (MIT). Please see License File for more information.