Skip to content

Latest commit

 

History

History
164 lines (116 loc) · 7.78 KB

README.md

File metadata and controls

164 lines (116 loc) · 7.78 KB

Dice Witch

Dice Witch is a highly advanced bot that rolls TRPG dice on Discord. It displays the dice visually, and aims to simulate the experience of rolling real dice.

Table of contents

Install

You can install Dice Witch on your Discord server by clicking here.

Usage

Basic rolls

Dice Witch can roll dice with any number of sides, but will only display images of four, six, eight, ten, twelve, or twenty-sided dice. The recommended way to interact with Dice Witch is to use Discord's new slash commands. To get started, just start typing /roll.

If you want to keep using non-slash commands, you can also use the legacy command !roll.

  • /roll notation:1d4 3d6 1d20: Roll one four-sided die, three six-sided dice, and one twenty-sided die.
  • /roll notation:1d12+3 5d4: Roll one twelve-sided die, adding three to the total, and five four sided dice.
  • /roll notation:3d6+3d6: Roll two sets of three six-sided dice and add the total.

Advanced rolls

You can use (almost) any of these modifiers in conjunction with any other modifiers.

Min/Max

Cause any rolls above/below the value to be treated as equal to the minimum/maximum value.

  • /roll notation:4d6min3: Roll four d6 where values less than three are treated as equal to three.
  • /roll notation:4d10max5: Roll four d10 where values greater than five are treated as equal to five.
  • /roll notation:10d20max15min5: Roll ten d20 where values greater than fifteen are treated as equal to fifteen, and values less than five are treated as equal to five.

Exploding

Allows one or more dice to be re-rolled (Usually when it rolls the highest possible number on the die), with each successive roll being added to the total.

  • /roll notation:2d6!=5: Roll two d6 and explode on any roll equal to five.
  • /roll notation:roll 2d!>4: Roll two d6 and explode on any roll greater than four.
  • /roll notation:4d10!<=3: Roll four d10 and explode on any roll less than or equal to three.

Compounding

Just like exploding, but exploded dice will be combined together in a single roll instead of being re-rolled. You can mark exploding dice to compound by using !! instead of !

  • /roll notation:2d6!!=5: Roll two d6 and explode and compound on any roll equal to five.

Penetrating

A type of exploding dice most commonly used in the Hackmaster system.

Should you roll the maximum value on this particular die, you may re-roll and add the result of the extra die, less one point, to the total (penetration can actually result in simply the maximum die value if a 1 is subsequently rolled, since any fool knows that 1-1=0). This process continues indefinitely as long as the die in question continues to come up maximum (but there’s always only a –1 subtracted from the extra die, even if it’s, say, the third die of penetration)

You can mark exploding dice to penetrate by using !p instead of !.

  • /roll notation:2d6!p=5: Roll two d6 and explode and penetrate on any roll equal to five.

Re-roll

Rerolls a die that rolls the lowest possible number on that die, until a number greater than the minimum is rolled.

  • /roll notation:1d10r: Roll 1d10 and reroll on one.
  • /roll notation:4d10r<=3: Roll 4d10 and reroll on any result less than or equal to three.

Keep/Drop AKA Advantage

Disregard or keep all dice above or below a certain threshold.

  • /roll notation:4d10k2: Roll 4d10 and keep the highest two rolls

  • /roll notation:4d10kl2: Roll 4d10 and keep the lowest two rolls.

  • /roll notation:4d10d1: Roll 4d10 and disregard the lowest roll.

  • /roll notation:4d10dh1: Roll 4d10 and disregard the highest roll.

Target success/failure AKA Dice pool

Counts the number of dice that meet a criterion.

  • /roll notation:2d6=6: Roll 2d6 and count the number of dice that equal six
  • /roll notation:6d10<=4: Roll 6d10 and count the number of dice that are less than or equal to four

Critical success/failure

This is an aesthetic feature that makes it super clear when a die has rolled the highest or lowest possible value. It makes no difference to the roll or its value.

  • /roll notation:1d20cs=20: Roll 1d20 and highlight if result is 20.
  • /roll notation:5d20cs>=16: Roll 5d20 and highlight if result is greater than 16.
  • /roll notation: 1d20cf=1: Roll 1d20 and highlight result is 1.

Sorting

Sorts the results of any of your rolls in ascending or descending numerical order.

  • /roll notation:4d6: Roll 4d6 and do not sort.
  • /roll notation:4d6s: Roll 4d6 and sort results in ascending order.
  • /roll notation:4d6sa: Same as above.
  • /roll notation:4d6sd: Roll 4d6 and sort results in descending order.

Math

You can use add, subtract, multiply, divide, reduce, and use parentheses as you please. You can also use the following JS math functions: abs, ceil, cos, exp, floor, log, max, min, pow, round, sign, sin, sqrt, tan

  • /roll notation:1d6*5: Roll a d6 and multiply the result by 5
  • /roll notation:2d10/d20: Roll 2d20 and add the result together, then roll a d20 and divide the two totals.
  • /roll notation:3d20^4: Roll 3d20 and raise the result to the power of 4.
  • /roll notation:(4-2)d10: Subtract 2 from 4 and then roll a d10 that many times .
  • /roll notation:sqrt(4d10/3): Roll 4d10, divide by three and calculate the square root.

Extras

Titled rolls

You can title a roll using the 2nd paramater of /roll, title.

  • /roll notation:1d20: title:to flirt with the bartender: Roll 1d20 with the title "to flirt with the bartender"

Repeating rolls

You can repeat any roll by using the timestorepeat, the 3rd parameter of /roll.

  • /roll notation:1d20+5 timestorepeat:6: Roll 1d20+5 six times.
  • /roll notation:3d20+3d6 timestorepeat:10: Roll 3d20 and 3d6 and add the results. Repeat ten times.

If you're using !roll, you can repeat by inserting a <times to repeat> string anywhere in your notation.

  • !roll <6> 1d20+5: Roll 1d20+5 six times.
  • !roll 3d20+3d6 <10>: Roll 3d20 and 3d6 and add the results. Repeat ten times.,

Contributing

PRs and forks are welcome! 🙂

Support

If you find a bug, please open a Github Issue. You can also join the support Discord here.

Credits

Dice Witch uses the superb RPG Dice Roller library by Lee Langley AKA GreenImp.

Roadmap

  • Slash commands and buttons support
  • User and guild registration
    • Per user and per guild settings
  • True random numbers based on stochastic atmospheric data
  • A variety of different sets of illustrated and photographed dice