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.