Auto Roll Plugin

This unofficial TaleSpire mod that automatically spawns, rolls and cleans up any dice introduced into the dice tray via the talespire://dice protocol. This includes, but is not limited to, the Dice Selection plugin and the Beyond The Spire Chrome Extension (which allows you to make rolls from your D&D Beyond character sheets).

Change Log

1.0.0: Initial release

Install

Use R2ModMan or similar installer to install.

Usage

Use any program or plugin (e.g. Dice Selection plugin, Dice Macros app, Beyond the Spire Chrome Extension, Webbrowser) to send a talespire://dice request to the OS or TaleSpireURLRelay. Instead of just loading the dice tray with the specified dice (as what happens in core TS), the dice will be placed on the board and rolled. After a specified time the dice will be cleared (unless the setting is changed to keep them).

In R2ModMan there is a setting for this plugin which dictates how long after the roll is completed the dice remain before being cleared. Normally the dice can be cleared immeidately because the dice being cleared has not effect on the result message that indicates the roll result. However, in some cases players like to see the actual dice in which case this setting allows some time for that before the dice are cleared.

A negative value for this setting means the dice are not cleared (i.e. the dice need to be cleared manually). A positive value indicates the number of seconds that the dice exist after finishing the roll in before being cleared.

Note: If the setting is negative then the dice will remain but will not be reused. The dice can be reused manually but a tilespire://dice request for the same roll will always generate a new die or dice.

2.0.1: Fixed issue causing patching exception in logs
2.0.0: Updated for compatibility with BR Dice update
1.4.0: Fixed compatibility with latest BR update. Migrated to Logging Plugin.
1.3.0: Fix bug with no dice cleanup setting.
1.3.0: Added diagnostic levels to logs.
1.2.0: Fix for BR update.
1.1.0: Bug fix causing some auto rolls to generate multiple copies of the dice.
1.1.0: Reworked the code to eliminate one of the previously added patches.
1.0.7: Updated documentation. No plugin change.
1.0.6: Fixed issue with always rolling the same number
1.0.6: Modified code to eliminate patch that replaces Die Spawn code
1.0.5: Fixed compatibility with latest BR update
1.0.5: Fixed bug causing exception when a dice roll cannot be cleared
1.0.3: Fixed multi dice set spawn when adding different dice groups.
1.0.2: Randomized the starting orientation of dice adding even more randomness.
1.0.1: Added more randomization to the roll.
1.0.1: Bug Fix: Manually added dice are ignored (work the same as core TS).
1.0.0: Initial release