https://github.com/morinted/plover_roll_the_dice

Plover text macros to roll dice, flip a coin, and take chances.
https://github.com/morinted/plover_roll_the_dice

plover

Last synced: about 10 hours ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/morinted/plover_roll_the_dice
• Owner: morinted
• Created: 2021-04-13T20:27:32.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-04-15T17:28:57.000Z (over 3 years ago)
• Last Synced: 2024-09-18T17:46:11.399Z (9 days ago)
• Topics: plover
• Language: Python
• Homepage:
• Size: 7.81 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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.

```json

{

  "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}"

}

```