Make your own rolls

Make your own commands that pick a random outcome with the chances you set, or roll dice.

What the module does

With Rolls you make your own slash commands and pick the name yourself, for example /encounter, /drink or /attack. When a member uses the command, the bot posts the result in the channel. The commands only exist on your server.

  • Random outcome: the bot picks one of your outcomes, for example what you meet in the forest or who has to drink.
  • Dice: the bot rolls dice like 1d20+5 and shows each die.

Every command gets an optional member option, so you can roll for someone else.

Getting started

  1. 1Open Rolls in the menu under Gaming and turn the module on with the switch at the top of the page.
  2. 2Click New command.
  3. 3Write the command name and a short Description in Discord, which members see when they type /.
  4. 4Pick the Type and fill in the outcomes or the dice.
  5. 5Click Try a roll to see a result the way it will look in Discord.
  6. 6Click Save and then Publish. Only now do the commands show up in Discord.
💡 Command names can only have lower-case letters, digits, - and _, and they cannot have the same name as one of RimFrost’s own commands.

Outcomes and chances

Each outcome has a text and a Weight. The higher the weight, the bigger the chance. Next to the weight you see the chance in percent, so you can see how it adds up.

Example: one outcome with weight 1 and one with weight 3 gives 25% and 75%. For a 5% chance, give the outcome weight 5 and the other one weight 95.

A command can have up to 25 outcomes, and the text can be formatted with bold, italic, lists and more.

Dice

  • 1d20 is one 20-sided die, and d20 means the same.
  • 2d6+3 is two 6-sided dice plus 3.
  • 1d8-1d4 takes a 4-sided die away from an 8-sided one.

Under Message you write the text the bot posts. Each die is shown at the bottom of the message. At most 100 dice and 1000 sides.

Placeholders

  • {user} mentions the member, without a ping.
  • {user.name} is the member’s name, without a mention.
  • {result} is the dice total.
  • {dice} is the dice, for example 2d6+3.

If someone uses the member option, {user} and {user.name} are the member they picked.

Free and Premium

  • Free: up to 2 commands.
  • Premium: up to 50 commands, a picture for each outcome and Who can use it, so only certain roles can use a command.

If Premium ends, the first 2 commands keep working, but without pictures.

Still stuck? Ask on our Discord server or write to support@rimfrost.dk