Skip to content

# brainss/diced

### Subversion checkout URL

You can clone with
or
.
Dice distributions - probabilities of dice rolls
JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

 Failed to load latest commit information. example test .gitignore README.md diced.js package.json

# Diced

Dice distributions - probabilities of dice rolls

```var diced = require('diced')
var d = diced('2d6')

for(var i=0; i < d.length; i++){
var roll = i + d.low
console.log('Roll a %d: %d%', roll, (d[i] * 100).toFixed(2))
}```

Result:

``````Roll a 2: 2.78%
Roll a 3: 5.56%
Roll a 4: 8.33%
Roll a 5: 11.11%
Roll a 6: 13.89%
Roll a 7: 16.67%
Roll a 8: 13.89%
Roll a 9: 11.11%
Roll a 10: 8.33%
Roll a 11: 5.56%
Roll a 12: 2.78%
``````

## diced(diceString)

The notation for diceString is `NdS`, where `N` is the number of dice used and `S` is the number of sides each die has. Examples:

```// two 6-sided die
diced('2d6')
// three 12-sided die
diced('3d12')```

### var d = diced('2d6')

The result of diced is an Array-like object.

#### d[n]

The probability of a roll `n`, where `n=0` is the probability of the lowest possible roll

#### d.low

The lowest possible roll

#### d.high

The highest possible roll

#### d.quantity

The number of dice in the distribution set

#### d.sides

The number of sides for a single die

Something went wrong with that request. Please try again.