https://github.com/potch/dicecord
https://github.com/potch/dicecord
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/potch/dicecord
- Owner: potch
- Created: 2021-02-18T07:14:27.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-02-19T04:19:12.000Z (over 5 years ago)
- Last Synced: 2025-02-04T21:34:00.875Z (over 1 year ago)
- Language: JavaScript
- Size: 19.5 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# dicecord
bare-bones dice-rolling discord bot.
## Setup
- requires Node LTS and npm
- `npm install` to get needed dependencies
- copy `.env.sample` to `.env`
- [create a discord application](https://discord.com/developers/applications)
- add a Bot user to the application
- copy the application's client ID and the bot's auth token into `.env`
- `npm start` to start the bot
- when running successfully, will log the URL to install the bot on your server
## Dice Syntax
the bot watches for messages starting with `/r `. Here are some examples:
- `/r d20` - roll a d20 die
- `/r 2d6` - roll 2 d6 dice, and return the sum of the rolls
- `/r 2d8 + 3` - roll 2 d8 dice and add 3 to the sum of the rolls
- `/r 2d6k1` - roll 2 d6, and keep only the highest roll
- `/r 3d20k-1` - roll 3d20 and return only the _lowest_ roll.
- `/r 10d4k-3 + 5` - roll 10 d4, keep only the lowest 3 rolls, and add 5 to the result
limited to a max of 20 dice, and dice with 1000 sides