Discord Bot

In our sessions, which we are playing through Discord, at the begining we used one of the simple roll bots. Quickly we found out, that our sessions were slowed down by calculations, counting SL etc. That is why we started to create our own bot, which would do that for us and speed up our sessions.

• roll - {number_of_dice}d{number_of_sides} - roll the given dice given number of times. Shortcut command is /r. In example /roll 2d10 will roll two 10 sided dices. Parameters:

  • equation - {number_of_dice}d{number_of_sides} - number of dice is by default 1. Equation supports simple math operation like multiply, add and substract. I.e. 2d20 + 20

  • alias - allows user to give a label to the roll to help distinguish multiple rolles. Alias will be written just after user mention. I.e. command with equation 2d20 + 20 and alias Example may return @User(Example): 42 ((4+18) + 20)

  • hidden - allows user to hide the roll value. The result of the roll will still be public. For fully hidden rolls, please consider creating a seperate channel or direct messaging bot.

• test - this command perform a test of skill with given value. Shortcut command is /t. It will return (alias): roll result - failed/passed (SL number) body part. After performing there will be a button available for 30seconds. Click the button if you want to reroll the test. Each test can be rerolled twice. Parameters:

  • skill_level - value to be tested. Supports simple math operation like multiply, add and substract. I.e. /test 40 + 20

  • alias - allows user to give a label to the test to help distinguish multiple tests. Alias will be written just after user mention. I.e. command with equation 40 + 20 and alias Example may return @User(Example): 81 - failed (-2SL) left hand

  • hidden - allows user to hide the test value. The result of the test will still be public. For fully hidden tests, please consider creating a seperate channel or direct messaging bot.

  • success_sl - success levels that should be added if test is passed

  • additional_sl - success levels that should be added to result (no matter if the test is passed or failed). Allows negative values.

  • send_result_to - a user to which the result will be send in private message. This may be used for tests, that only the GM should see response of.

• fight - this command is used for opposite tests including fight tests. Command should be triggered first by attacker, then by defender. Shortcut command is /f. First test will return a response in given format: @User(alias) attacks roll_result(SL amount) Waiting for opponent.... Second test will return @User(alias) defends rol_result(SL amount). The final response will have a given format: @WinnerUser(Winner alias) won by SL difference over @DefeatedUser(Defeated alias). After performing there will be two buttons available for 30seconds, each button for one opponent. Click the button if you want to reroll the test. Each opponent can reroll twice. Parameters:

  • skill_level - value to be tested. Supports simple math operation like multiply, add and substract. I.e. /fight 40 + 20

  • alias - allows user to give a label to the test to help distinguish multiple tests. Alias will be written just after user mention.

  • hidden - allows user to hide the test value. The result of the test will still be public.

  • success_sl - success levels that should be added if test is passed

  • additional_sl - success levels that should be added to result (no matter if the test is passed or failed). Allows negative values.

• mode - using this command user can switch the SL count method used by test and fight commands. Defaults to STANDARD. Parameters:

  • mode - allows user to choose which mode should be used on the channel. Leaving this parameter empty will cause switch to different mode than currently selected

• help - returns broader information about bot commands. May be used without parameters to get short description of commands or with parameter to get detailed one. Parameters:

  • command - command to get the detailed help about. I.e. /help help