d20
DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/d20 package

1.4.1 • Public • Published

d20.js

Javascript library for rolling RPG dice. Supports dice notation such as "4d6" and "d20+2".

npm version Build Status

Installation

In the browser

Download the files from GitHub and include the d20.js file somewhere in your HTML page.

<script src="path/to/d20.js"></script>

As a Node.js module

Install via npm.

npm install d20

require it in your app.

var d20 = require('d20');

As a standalone tool

Install it globally.

npm install -g d20

Run the d20 command with any number of desired dice rolls after.

d20 4d6
d20 d20 1d8+1 d4

Usage

As a library

Both methods of using the library provides a d20 object with the roll() method which is used to roll dice.

d20.roll(20); // roll a 20-sided die
d20.roll('4d6'); // roll four 6-sided dice
d20.roll('2d8+1'); // roll two 8-sided dice and add 1 to the result
d20.roll('1d8 +1 +2 -20'); // roll an 8-sided die with multiple modifiers

You can get the result as an array of values rather than a single result if you use the verboseRoll function. Note that the results will be sorted in ascending order except for the modifiers which will be in their order of apperance.

d20.verboseRoll(20);
d20.verboseRoll('4d6');
d20.verboseRoll('2d8+1');
d20.verboseRoll('1d8 +1 +2 -20');

Alternatively you can just pass true as the second paramenter to the roll function.

d20.roll(20, true);
d20.roll('4d6', true);
d20.roll('2d8+1', true);
d20.roll('1d8 +1 +2 -20', true);

As a standalone tool

The standalone tool takes any number of dice roll commands and will return each one separately.

d20 4d6 2d8 d10

If you want more verbose output (full list of results per dice), you can use the --verbose option.

d20 --verbose 3d12

If you add the --total option, it will return the sum of all the dice rolls.

d20 --total d20 1d8+1 d4

Testing

The library can be tested by installing the dependencies and running npm test:

npm install
npm test

Readme

Keywords

Package Sidebar

Install

npm i d20

Weekly Downloads

47

Version

1.4.1

License

MIT

Last publish

Collaborators

  • michaelenger