Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DLvalentine/fate
A dice roller bot for discord with GM mode!
https://github.com/DLvalentine/fate
dice dice-roller discord discord-bot dnd dnd-tools javascript pathfinder pathfinder-game pathfinder-rpg pathfinder-tools
Last synced: 2 months ago
JSON representation
A dice roller bot for discord with GM mode!
- Host: GitHub
- URL: https://github.com/DLvalentine/fate
- Owner: DLvalentine
- License: mit
- Created: 2019-02-21T17:39:55.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-05-12T00:31:44.000Z (over 3 years ago)
- Last Synced: 2023-10-09T05:18:53.367Z (over 1 year ago)
- Topics: dice, dice-roller, discord, discord-bot, dnd, dnd-tools, javascript, pathfinder, pathfinder-game, pathfinder-rpg, pathfinder-tools
- Language: JavaScript
- Homepage:
- Size: 59.6 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- stars - DLvalentine/fate - A dice roller bot for discord with GM mode! \[*MIT License*\] (⭐️2) (JavaScript)
- stars - DLvalentine/fate - A dice roller bot for discord with GM mode! \[*MIT License*\] (⭐️2) (JavaScript)
README
# fate
A dice roller bot for discord!
### Adding fate to your Discord Server
[Click here to do that.](https://discordapp.com/api/oauth2/authorize?client_id=548192715129749544&permissions=7168&scope=bot)
I run this on a little raspberry pi out of my basement... so... if there's a ton of traffic I imagine it won't be pretty. Maybe one day I'll move it to AWS or something.
`NOTE`: My pi running Fate died a while back, so consider the above link dead for now. I'll probably spin it back up soon™
### So you forked it? Now what?
You can create an app/bot via [Discord for Developers](https://discordapp.com/developers/applications/)
fate (or, I guess your new fork) requires [NodeJS](https://nodejs.org/) to run. All other dependences can be installed via npm once you have NodeJS installed.
Be sure to open `auth.json` and include the secret token that Discord will use to login as that bot. You can also include specific channels on your server in `channels.json` to be able to send messages strictly to a specificed channel.
1. clone/download repo
2. `cd` to directory*
3. `npm install`
4. `node fate.js`
\* 2.5 See above note for updating `auth.json` and (optionally) `channels.json`
~ let fate (or your fork!) decide ~
# Contributing
Seeing as you'd need to create your own app/bot to make changes, feel free to re-release this as your own flavor of a dice roller. They're a dime a dozen, anyway. MIT license, so just gimmie a shoutout and I'm happy.
But if you'd like to improve this project, make a PR :) I'm happy to accept changes.
# Commands
`!fate` : Print the commands.... y'know. This.
`!r [argument]` : Given a dice string, like `3d6`, roll a specified number of dice of a type. No need to include `1` for single die. You can add bonuses or penalties with `-` and `+` after the quantity/type string.
`!gr [argument]` : the same as `!r`, but will be whispered to the author for a "hidden" roll. Typically used for GMs
`!srd` : Posts a link to the online SRD for Pathfinder.... maybe one day configurable to go to other SRDs
`!e [argument]` : Sends a formatted "ENCOUNTER" text block to the log, in order to help break up text between encounters in your server
`!g [argument]` : The same as `!e` , but for "GRANTED" - as in, granting items or experience
`!motd` : Will repeat the Message of the Day, as configured in `motd.txt`
## Examples
`!r d20`: roll 1 d20.
`!r 2d20`: roll 2 d20s.
`!r 1d6+2`: roll 1d6, adding a bonus of 2.
And so on. It works similar to the Roll20 Dice Roll system.
Depending on your argument, it will return the expected messages, complete with a reference to who rolled!
