ChatRandomizerPlugin

Char Randomizer Plugin

This unofficial TaleSpire plugin for randomly determining items from a list.

Supports real time lists and named pre-configured lists.

This plugin, like all others, is free but if you want to donate, use:

Change Log

3.4.1: Fixed bug with custom headers

3.4.0: Addes constent text support allowing use of result with other chat services

3.3.0: Added optional prompts

3.3.0: Fixed issue where randomization occurs on all devices and thus produces different results

3.2.1: Fixed issue with result being chopped off

3.2.1: Fixed issue with sample RPS and RPSLS samples

3.2.0: Added configurable display options

3.1.0: Added tally (total) support

3.0.0: Added multiple randomization per request

3.0.0: Added optional named randomization

3.0.0: Added added soft dependency for chat whisper so result can be whispered

2.1.3: Initial release

Install

Use R2ModMan or similar installer to install this plugin.

Display Options

The display options can be configured using R2ModMan's Edit Config for the plugin or using Config Manager

from the Talespire Settings menu. Please note that not all combinations of settings will produce usable

results.

Show Roll Possibilities

This setting indicates if the possible outcomes are listed along with the roll. If so, the possible

outcomes are displayed, in brackets, after the roll name or the default roll name.

Show All Names Instead Of Just First

This setting indicates if `/cnr and /crnt` commands expect a single name or a name for each

roll in the sequence. This not only affects the display but also the interpretation of the roll request.

If this setting is set to false then only the first entry in a multi roll request is expected to have

a name. Providing names for the other roll request parts will cause errors since the name will get

interpeted as a roll possibility.

Example:

For Show All Names = True Use:

`/cnrt Name1 Roll1 / Name2 Roll2... such as /cnrt Attack 1 2 3 4 5 6 7 9 10 / Damage 1 2 3 4 5 6`

For Show All NAmes = False Use:

`/cnrt Name1 Roll1 / Roll2... such as /cnrt Attack 1 2 3 4 5 6 7 9 10 / 1 2 3 4 5 6`

Show Result On Same Line

This setting determines if the result is place on the same like as the roll (true) or on new line

(false) with the Default Result Prefix (see below).

Show Total On Same Line

This setting determines if the total is place on the same like as the roll (true) or on new line (false).

Default Roll Prefix

This setting determines the prefix for non name rolls.

Default Result Prefix

This setting determines the prefix for non name results.

Use Chat Header For First Name

This setting determines if the first roll name is place in the header of the chat message (along with the

player name) with the result in the body.

Usage

There are four types of rolls. Generic rolls, Named rolls, Generic Rolls with Tally and Named rolls with Tally.

Each of which can use pre-defined rolls (configured in a configuration file ahead of time) or real-time list

(specified when rolling).

To perform a generic roll, use the `/cr` (Custom Roll) function. For example:

`/cr RPS`

or

`/cr Rock Paper Scissors`

To perform a named roll, use the `/cnr` (Custom Named Roll) function. For example:

`/cnr Gesture RPS`

or

`/cnr Gecture Rock Paper Scissors`

When using the named functionality the first item in the list is treated as the name. This is what is displayed instead

of "Roll" when displaying the result. It should be noted that if the verbose setting is turned off the result is not

prefixed by the name but a cnr roll will still consume the first entry for the name.

To use the tally (total the value) version, add an `t` as the last letter of the command. When using the tally functions

the results need to be numeric. Non-numeric sides will be counted a 0.

`/crt 0 0 1 1 2 3`

or

`/cnrt Fluff 0 0 1 1 2 3`

Multiple Rolls

Multiple rolls can be requested in a single request by separating the rolls with a `/` character. Note