DiceSelectionPlugin

Dice Selection Plugin

This unofficial TaleSpire plugin that allows you to open a generic or character specific menu with different roll combos

(different dice with different modifiers). Clicking any of the options in the menu will prepare the related dice in the

dice tray and display the result with the combo name and add/subtract any modifier.

Change Log

2.1.0: Fix after BR Update

2.0.0: Fix afetr BR HF Integration update

1.2.1: Added Beyond Link Server LinkData handler files to "teach" Beyond Link Server how to create DSM files from the

collected data. The additional files are only used if the user is using Beyond Link via Chrome plugin to get

character sheet data from a external source. No change to the actual plugin (remains at version 1.2.0)

1.2.0: Reloaded character data periodically to allow roll macros to be updated

in near real time. Ideal for use with plugins like the Beyond Link via

Chrome plugin.

1.1.0: Adds support for multiple columns when there are lots of roll macros

1.0.2: Support for the? formula which prompts the user for a roll formula

1.0.0: Initial release

Install

Use R2ModMan or similar installer to install this plugin.

Usage

Press the keyboard shortcut (default LCTRL+D) to open the dice roll menu. If no character is selected or the selected

character does not have a corresponding DSM dice selection file, the plugin will look for a `General.dsm` file. If

the `General.dsm` file does not exist, it will use hard coded default roll. If the selected character has a corresponding

DSM dice selection file (based on character name) then those roll macros will be used instead.

Clicking any of the menu selection will load those dice into the dice tray and when the dice are rolled the name of the

dice macro is displayed as well as any modifier is applied. Dice cleanup is manual.

Dice Selection Menu Files

Character specific dice selection menu files are created by creating a plain text file which has a `.dsm` extension.

Despite the extension, the file is still a plain text file. Each entry in the file represents an entry in the dice menu.

The syntax for the entries is: `name [roll]`. For example:

`Initiative [1D20+4]`

The menu entry can generate multiple dice rolls at once. For example:

`Claw Strike [1D20+3/Slashing:1d4]`

The roll `?` causes the plugin to prompt for a roll formula.

Two sample files are provided: `Jon.dsm and General.dsm`.

Configuration

The plugin has a few configurable parameters. This include the shortcut key to open the dice selection menu, the numeber

of menu entries per column, and the color of the title and roll text. The background of the title and roll can be modified

by editing the `org.lordashes.plugins.diceselection.title.background.png and/or org.lordashes.plugins.diceselection.roll.background.png`

files.

Beyond Link Server

The is no action needed to combine this plugin with the Beyond Link via Chrome plugin. When the Beyond Link via Chrome plugin

is started, it automatically starts the Beyond Link Sever which will find this plugin and automatically make DSM files for

the collected data.