StatesPlugin

States Plugin

This unofficial TaleSpire plugin is for adding lines of text above a mini

to provide visible information such a mini states (e.g. poisoned, frozen, etc).

Thanks to @AlbrechtWM for the latest States Plugin updates.

Change Log

3.5.0: Updated for compatibility with BR Slab Browser update

3.4.0: Added support for mass delete

3.4.0: Bug fix for BR Mass Move Update

3.3.1: Corrected AssetLoader and removed incorrect log message

3.3.0: Bug fix to address accessing assets before they are available.

3.2.0: Config now loads from any FAP location. Default color config provided by Tabletop Animated

3.1.0: Fix for Cyberpunk Update

3.0.0: Fix for BR HF Integration Update

2.5.1: Fixed bug with remaining text after creature is deleted

2.5.0: Fixed bug with vertial positioning.

2.4.0: Optimized handling.

2.4.0: Fixed bug preventing use with EAR spawned custom minis.

2.3.0: Added Effect prefix to states block objects to increase compatibility with other plugins

2.2.0: Improved text positioning and orientation

2.2.0: Uses FileAccessPlugin for icons and colorization file access

2.1.0: Added access to states from the mini radial menu. Select Info in the main menu and then states.

2.0.2: Fixed dependency in manifest

2.0.1: Plugin is now listed on the TaleSpire main page

2.0.1: Fixed bug which prevented modifying existing states unless the states were first removed

2.0.0: Rewrite to use Stat Messaging for higher compatibility with other plugins

1.1.0: Added support for rich text

1.1.0: Added keyword colorization json file

1.1.0: Added base text exposed in configuration

1.0.0: Initial release

Install

Install using R2ModMan or similar.

Configuration

The R2ModMan configuration provides a number of settings to customize the features of the plugin:

`Base Text Size` = Indicates the font size of the text above the asset. Data type: Float. Default: 2.0

`Height Offset Method` = Determines how the position of the text is calculated.

FixedOffset = Always at a specific height determined by the offsetValue value

BaseScaledFixedOffset = Always at a specific height determined by the offsetValue value scaled by the creature size

HeadHookMultiplierOffset = Takes the head hook position and multiplies it by the offsetValue

BoundsOffset = Takes the highest point of the asset and multiplies it by the offsetValue value

`Offset Value` = Values used by the offset method (see above).

Usage

Select a mini and then press the States shortcut keys (defaults to CTRL+S but can be changed in R2ModMan) to activate the Stats dialog.

Enter some text. If there are commas in the text, they will used to separate the text into multiple lines. The intention of this plugin

is to add information about the character states/conditions such as Poisoned, Exhausted, Unconcious, On Fire, etc. However, the plugin

can be used to display any text so it could be use for many other purposes.

Stealth Mode

The plugin synchronizes the text with the mini's stealth mode. When the mini is hidden due to Stealth, the text will also be hidden.

Three Ways To Color Your World

Base Text Color Configruation

In the States Plugin section of R2ModMan the base text color can be configured. When entering a number in R2ModMan for the color the

code needs to be a 8 digit code preceeded by a hash sign in the form of #RRGGBBAA. Each of the two characters represent the hex value

of the byte for the red color, green color, blue color and the alpha (FF=Opaque, 00=Full Transparent).

Colorization Keywords

Keywords can be colorized by providing a JSON colorization file. The JSON colorization file is expected in following folder with

the following file name:

\Steam\steamapps\common\TaleSpire\TaleSpire_CustomData\Config\org.lordashes.plugins.states\ColorizedKeywords.json

The contents of the file has the following format:

JSON

{

"Poisoned": "Poisoned",

"Frozen": "Frozen",

"Shocked": "Shocked",

"Exhausted": "Exhausted",

"On Fire": "On Fire",

"": ""

}

The first entry per line (the key) i