dice/README.md

dice roller

This html file allows a user to perpetually add calculated dice rolls to a history list. It then encodes/compresses the entire page into an itty.bitty url to pass between players.

To Use

• Enter the name of the roller (the actor) and the reason for the roll (such as "initiative" or "attack/damage")
• Select the number of dice to roll (max 20) and the number of sides on those dice (max 100)
• Add a modifier (positive or negative) and apply it to the total roll or to each die rolled
• Click the roll button and see the results added to the history

After each roll, a new itty.bitty link will be generated in the Custom History box. Click the button to copy and send it off to the next player!

Link Length

The itty.bitty links can get quite long, so it may be prudent to use a link shortener.

For example, the link https://asso.li/dLVZ82wR for the dice.html page in this repo was generated using asso.li, an lstu instance, with the following command (Linux):

cat dice.html | lzma -9 | base64 -w0 | xargs -0 printf "https://itty.bitty.site/#Dice Roller/%s\n" | xargs -0 -I {} curl --data-urlencode "format=json" --data-urlencode "lsturl={}" https://asso.li/a | jq -r '.short'

You can, optionally, generate such a short link with each pass to each player, as needed.