Skip to content

A simple tool designed to roll dices, of any side d2 (flip coin), d3, d4, d6, d8, d12, d20, d30, d60, d100, d1000, and jan-ken-po.

Notifications You must be signed in to change notification settings

marcosem/rolld20

Repository files navigation

Roll d20 🎲

A simple tool designed to roll dices, of any side: d2 (flip coin), d3, d4, d6, d8, d12, d20, d30, d60, d100, d1000, and jan-ken-po.

npm i rolld20
yarn add rolld20

Usage

Pick a Dice

2 sides dice (d2) / flip a coin

import { d2, flipCoin } from 'rolld20'

// Rolling d2 πŸŽ²πŸ‘‹
d2(); // return a random number between 1-2;
d2(10); // return an array of 10 elements with random numbers between 1-2;

flipCoin(); // return a string: 'heads' or 'tails" at random;

3 sides dice (d3)

import { d3 } from 'rolld20'
 // Rolling d3 πŸŽ²πŸ‘‹
d3(); // return a random number between 1-3;
d3(10); // return an array of 10 elements with random numbers between 1-3;

4 sides dice (d4)

import { d4 } from 'rolld20'

 // Rolling d4 πŸŽ²πŸ‘‹
d4(); // return a random number between 1-4;
d4(10); // return an array of 10 elements with random numbers between 1-4;

6 sides dice (d6)

import { d6 } from 'rolld20'

// Rolling d6 πŸŽ²πŸ‘‹
d6(); // return a random number between 1-6;
d6(10); // return an array of 10 elements with random numbers between 1-6;

8 sides dice (d8)

import { d8 } from 'rolld20'

// Rolling d8 πŸŽ²πŸ‘‹
d8(); // return a random number between 1-8;
d8(10); // return an array of 10 elements with random numbers between 1-8;

10 sides dice (d10)

import { d10 } from 'rolld20'

// Rolling d10 πŸŽ²πŸ‘‹
d10(); // return a random number between 1-10;
d10(10); // return an array of 10 elements with random numbers between 1-10;

12 sides dice (d12)

import { d12 } from 'rolld20'

// Rolling d12 πŸŽ²πŸ‘‹
d12(); // return a random number between 1-12;
d12(10); // return an array of 10 elements with random numbers between 1-12;

20 sides dice (d20)

import { d20 } from 'rolld20'

// Rolling d20 πŸŽ²πŸ‘‹
d20(); // return a random number between 1-20;
d20(10); // return an array of 10 elements with random numbers between 1-20;

30 sides dice (d30)

import { d30 } from 'rolld20'

// Rolling d30 πŸŽ²πŸ‘‹
d30(); // return a random number between 1-30;
d30(10); // return an array of 10 elements with random numbers between 1-30;

60 sides dice (d60)

import { d60 } from 'rolld20'

// Rolling d60 πŸŽ²πŸ‘‹
d60(); // return a random number between 1-60;
d60(10); // return an array of 10 elements with random numbers between 1-60;

100 sides dice (d100)

import { d100 } from 'rolld20'

// Rolling d100 πŸŽ²πŸ‘‹
d100(); // return a random number between 1-100;
d100(10); // return an array of 10 elements with random numbers between 1-100;

1000 sides dice (d1000)

import { d1000 } from 'rolld20'

// Rolling d1000 πŸŽ²πŸ‘‹
d1000(); // return a random number between 1-1000;
d1000(10); // return an array of 10 elements with random numbers between 1-1000;

Rolling Jan-ken-po

import { janKenPo } from 'rolld20'

// Rolling jan-ken-po βœŠβœ‹βœŒοΈ
janKenPo(); // return a string: 'rock', 'paper', or 'scissors' at random;

// Rolling jan-ken-po with bomb allowed βœŠβœ‹βœŒοΈπŸ‘
janKenPo(true); // return a string: 'rock', 'paper', 'scissors', or 'bomb' at random;

Comparing Jan-ken-po

import { compareJanKenPo } from 'rolld20'

// Compare two jan-ken-po βœŠβœ‹βœŒοΈπŸ‘ x βœŠβœ‹βœŒοΈπŸ‘
compareJanKenPo('paper', 'bomb'); // return 1 (bomb beats paper)
compareJanKenPo('scissor', 'paper'); // return -1 (scissors beats papaer)
compareJanKenPo('rock', 'rock'); // return 0 (it's a tie)

Source code

See the source code here.

About

A simple tool designed to roll dices, of any side d2 (flip coin), d3, d4, d6, d8, d12, d20, d30, d60, d100, d1000, and jan-ken-po.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published