Alldice is a RESTful service along with a NSQ service that allows you to query it with dice rolling expressions (currently only scheme) and it will compute the roll and then return the result.

Syntax

| ---------- | --------------------------- | ----------------- |
| Syntax     | Explaination                | Example           |
| ---------- | --------------------------- | ----------------- |
| (dice n)   | Roll a n side dice (1 .. n) | (dice 6)          |
| (roll n d) | Roll n dices                | (roll 2 (dice 6)) |
| (+ d y)    | Add y to the dice roll      | (+ (dice 6) 2)    |
| ---------- | --------------------------- | ----------------- |

Limitations

There are currently no firm limitation implemented as it is. This software is probably quite unsecure so use it at your own risk! Eventually I would like to implement controllable limits such as:

Max of N dice rolls in one expression
Max amount of memory consumed in one expression
Max amount of cpu consumed in one expression

Configuration

There is currently no real configuration available so the rough setup is:

Logging stream to StdErr
Ekg instance running at localhost:8081
RESTful Dice API at 0.0.0.0:8080
NSQ queue reader at: lethalcode.com on the alldice queue.

RESTful Dice API

http://localhost:8080?src="https://github.com/pharaun/alldice/raw/main/(dice 6)"

NSQ API

Request:

{
    "expression": "(dice 6)",
    "replyQueue": "foobar"
}

Reply:

{
    "expression": "(dice 6)",
    "result": "4",
    "error": ""
}

Future features

Extended scheme buildins to support more fancy dice types such as: dice-pool types; sum, exploding (mxn), "open roll", "Collective tests", Additive dice pool, target number dice pool, highest-die dice pools
Additional arthmetic such as; min, max, least x, largest x
Probabilistic programming/rolls in which it computes the probability of the particular dice expression.
Implement other dice system such as PCGen, Roll20, and so on.

pharaun / alldice

readme