A C# (.Net Standard 2.0) port of xori/gamblers-dice.
$ dotnet add package GamblersDice
// OR
$ Install-Package GamblersDice
var die = new GamblersDie(); // Creates a new six-sided die
int result = die.Roll();See API for more examples.
From xori/gamblers-dice:
Normally when rolling a 4 sided die, you would have a 25% chance of rolling any given face, at any time. If you rolled a 4, three times in a row it doesn't make it any less probable of happening the next time. Further, a 1 is not "more likely" because "it hasn't been rolled in a while".
This library breaks that standard rule.
| Roll | % of 1 | % of 2 | % of 3 | % of 4 | Actual Roll |
|---|---|---|---|---|---|
| 1 | 25% | 25% | 25% | 25% | 1 (⚀) |
In the above example, we got out our fancy die from its box, and rolled. Because we are gods, we know the probability of each side being rolled, and see nothing amiss. Every face has a 25%, and we randomly roll a 1.
| Roll | % of 1 | % of 2 | % of 3 | % of 4 | Actual Roll |
|---|---|---|---|---|---|
| 2 | 14% | 29% | 29% | 29% | 2 (⚁) |
| 3 | 22% | 11% | 33% | 33% | ? |
Whoa, that's different, we are now 11% less likely to roll a 1, and indeed, by luck, we don't. We instead roll a 2, and when we do, we see the probabilities shift yet again. Let's roll the die a couple more times.
| Roll | % of 1 | % of 2 | % of 3 | % of 4 | Actual Roll |
|---|---|---|---|---|---|
| 3 | 22% | 11% | 33% | 33% | 3 (⚂) |
| 4 | 30% | 20% | 10% | 40% | 1 (⚀) |
| 5 | 9% | 27% | 18% | 45% | ? |
After four rolls, we've yet to see a 4, it is obviously due and indeed there is now a 45% chance of rolling a 4. If you were going to do something rash (like bet on a 4) now would be the time.
Creates a new die with the default of six sides. Each side is equally weighted. Example: var die = new GamblersDie();
Creates a new die with the number of sides specified. Each side is equally weighted. Example: var die = new GamblersDie(8);
Creates a new die with the number of sides determined by the number of parameters. Each parameter is the weight for its side. Example: var die = new GamblersDie(1, 1, 1, 1, 3, 1, 1);
Same as above, but using an array instead of individual parameters.
A fair die is included as well. It works similar to GamblersDie but it is not weighted.
Creates a new fair die with the default of six sides.
Creates a new fair die with the number of sides specified.
If you don't want each die to create its own System.Random object, pass your own System.Random object as the first argument in the constructor. This works for all constructors:
var rnd = new Random();
var die0 = new GamblersDie(rnd);
var die1 = new GamblersDie(rnd, 1, 1, 1, 7, 1, 1, 1);
var die2 = new FairDie(rnd, 20);