Skip to content

[UNMAINTAINED] - Allows you to roll dice on a slack channel by configuring a slash command and an incoming webhook.

Notifications You must be signed in to change notification settings

mootcycle/slack-diceroller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Slack Dice Roller

This is a node server for moving rolling D&D/White Wolf style dice on Slack.

To set up this server, you'll need to configure your Slack team with a slash command. The slash command allows users to send a roll request from Slack to the node server and for the node server to respond. Go to https://your-team.slack.com/services and expand the section for "Slash Commands". Click the "Add" button and enter a command to active the dice roller. I recommend using "/roll". You can then configure the slash command. The URL should be "https://your-server.com/roll", the method should be "POST" and you can fill out the description and usage hint however you'd like. Make a note of the token Slack gives you, as you'll need it to configure the dice roller teams.json file.

On your server, you'll need to create a configuration file named teams.json and populate it with the webhook url and the token. The format for the teams.json file is:

[
  {
    "teamName": "your team name -- only used for decoration",
    "token": "yourLongTokenGoesHere"
  },
  { [more teams] },
]

Start the server with node index.js and test it out by issuing a /roll command on your Slack team.

You can use simple rolls like:

/roll 3d6

Or White Wolf rolls like this:

/roll 4d10 diff 7

Or more complex rolls like this:

/roll 3d6 + 5d10 / 4 + 2d4 * 5d10 diff 8

I don't know why you'd want to do that last one, but you could.

About

[UNMAINTAINED] - Allows you to roll dice on a slack channel by configuring a slash command and an incoming webhook.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published