plover-roll-the-dice 0.1.0

Plover text macros to roll dice, flip a coin, and take chances.

Roll the Dice

Plover text macros to roll dice, flip a coin, and take chances.

Installation

Install from the Plover plugins manager.

Usage

Meta / Macro Name	Description
{:roll:range:1:100}	Get a random integer in the provided range (in this example, from 1 to 100, inclusive).
{:roll:choice:option1:option2:etc}	Randomly write a choice from the options provided (in this example, option1, option2, and etc). Spaces are allowed and the word will respect the current capitalization state.
{:roll:d6}	Roll a six-sided die. You can replace "6" with any positive whole number. Equivalent to {:roll:range:1:6}.
{:roll:d10}	Roll a 10-sided die. Equivalent to {:roll:range:0:9}.
{:roll:d20}	Roll a 20-sided die. Equivalent to {:roll:range:1:20}.
{:roll:coin}	Flip a coin. Equivalent to {:roll:choice:heads:tails}.
{:roll:8ball}	Ask the Magic 8-Ball a question.

Examples

You can mix these metas into your text.

{
  "RO*L": "I roll a d20... the result is {:roll:d20}",
  "KO*EUPB": "Heads or tails{?}{:roll:coin}{!}",
  "SAO*UR": "{:roll:choice:yep:sure:okay:fine by me}"
}