Overview

I couldn't find a Slack dice-rolling integration that could handle my office D&D sessions, so I wrote one.

If you like this command, why not try my SRD 5e Spell Lookup!

Supported roll syntaxes

The currently supported roll syntax can be found in the project README.

Installing the dice roller for yourself

The easiest way to get this running in Slack is to add a slash command, and tell it to POST to https://api.carl.fish/dice/slack

Step 1:

While logged into Slack, go to the relevant integrations page. (If this link does not work, you may need to ask your organisation's Slack administrator to install it for you).

Choose a command name (I suggest "/roll") and then "Add Slash Command Integration"

Step 2:

Under "Integration Settings",

• set URL to https://api.carl.fish/dice/slack
• set Method to POST
• set the bot name, icon and help text to whatever you want.

Step 3

Save the integration and you're done.

Notes

The service is not currently restricted or rate-limited, although I might have to add that later if it turns out there's a lot more D&D nerds out there than I thought.

You can run the service yourself either as a bot that connects to Slack, or as a web service that receives commands from it, but since I am not going to provide any support or advice for people who want to do that, I'm going to start not providing support or advice by not explaining how. :)

DISCLAIMER

This service is provided on an "as is" basis, without warranties of any kind, express or implied, including warranty of fitness for any particular purpose. If it doesn't work, it doesn't work.

The random number generator is just the stock Java RNG. Do not use this service for gambling or similar activities, as it is possible to predict the likelihood of future rolls.

Support for chat services other than Slack

Would be nice. If it's as easy as providing a REST resource, look at the RollWeb object.