https://github.com/toddself/slack-dnd
D&D slash commands for slack
https://github.com/toddself/slack-dnd
Last synced: about 1 year ago
JSON representation
D&D slash commands for slack
- Host: GitHub
- URL: https://github.com/toddself/slack-dnd
- Owner: toddself
- Created: 2014-06-09T19:59:14.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2014-06-09T20:09:46.000Z (about 12 years ago)
- Last Synced: 2025-04-10T16:08:56.849Z (about 1 year ago)
- Language: JavaScript
- Size: 215 KB
- Stars: 36
- Watchers: 6
- Forks: 32
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Slack D&D
A collection of endpoints to help you play D&D in your slack chat room.
## Requirements
1. A publically accessible server running node (or abilty to reverse proxy back to your node server);
1. node.js
## Installation
```
npm i -g slack-dnd
slack-dnd --host [hostname || 127.0.0.1] --port [port || 3000] --token [Your Slack integration token] --group [Group ID to restrict usage to]
```
## Slack set up
If you add a custom emoji for the `:dm:` command, it'll use that as the avatar for the icon. I highly recommend using a visage of [dungeon master](http://www.dungeonsdragonscartoon.com/2009/08/dungeon-master.html) from the 80s D&D cartoon!
### Dice
1. Add a [new slash command](https://slack.com/services/new/slash-commands) with the following settings:
* **Command**: `/roll`
* **URL**: `http://yourhost.com/roll`
* **Method**: `get`
* **Label**: `roll dice!`
1. Set up a new [incoming webhook](https://slack.com/services/new/incoming-webhook)
* Choose a `channel` to integrate with (this doesn't matter -- it'll always respond to the channel you called it from)
* Get your `token` from this page (this is what you'll use when you launch the server)
Or if you like pictures:
