This is an old revision of the document!
The Thentao Dice Server
The Dice Server is designed as a way to have a “trusted” third-party roll dice when communication is done using email.
Overview
The person who wishes to roll the dice (aka “Roller”) sends a plain text email message to the dice server address (which is not included here for security reasons). The Roller must “CC” the other person(s) who need to see the roll.
When the dice server receives this message, it will roll the dice and send the results to the Roller, as well as any person CC'd on the initial message.
Syntax
Messages sent to the dice server may contain any number of lines as follows:
- [ whitespace ] “!roll” whitespace dice-expression(s)
Where a dice-expression is as follows:
- [ repeat-count “x” ] [ number-of-dice ] “d” dice-size [ ('+'/'-') dice-adder ] [ “x” repeat-count ]
Examples:
- !roll d20
- Roll a single d20
- !roll 3d6
- Roll three six-sided dice, show the individual numbers, and the total
- !roll 2d4+2
- Roll two four-sided dice, show the individual numbers, add two to the total and show it
- !roll d20x5
- Roll a single d20 five times
- !roll 6x3d6
- Roll three six-sided dice six times
If no dice-expression exists, the dice server will roll a single d20.
Caveats
If you do not “CC” anybody, the dice server will still roll the dice, but the response will be seen only by you – which defeats the main purpose.1)
The dice server currently ignores “HTML” sections in email – so please send plain text only.2)
Each recipient will always receive TWO copies of each message – one from the original sender, and a second from the dice server. The exception to this is the “V2” mailing list. Messages sent to the mailing list are run through the dice roller and the response is sent ONLY to the mailing list.