Skip to content

DLvalentine/fate

Repository files navigation

fate

A dice roller bot for discord!

Adding fate to your Discord Server

Click here to do that.

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

fate (or, I guess your new fork) requires NodeJS 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!

example output