TurnCountersPlugin

Turn Counters Plugin

This unofficial TaleSpire plugin provides custom turn counters which can be used to track effects that last a set

number of turns. Predefined counters can be added and removed from the CCM menu but ad-hoc counters can be added

and removed using the radial menu. Supports either seeing all counters or seeing just the counters for the selected

mini. Also supports GM counters which can be put on player minis but will show only to the GM.

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

Install

Use R2ModMan or similar installer to install this plugin.

Counter Configuration

To create counters that can be added and remove though the Common Custom Menu (CCM):

• Create text file with the name `org.lordashes.plugins.turncounter.Counters.Name.txt where Name` is replaced

with a unique name for the counter.

• Insinde the file write a one line in the format: `Name|start|stop or Name|start|stop|version` for example a

counter called Haste which goes from 10 down to 0 would be: `Haste|10|0 or Haste|10|0|1.0.0`

• Save the file in any File Access Plugin legal location.
• Run Talespire and the counter will appear in CCM under a Counter type.

Display Configuration

The configuration file for the plugin has many configurable parameters that defined the starting point of the turn

counter display (`Left, Top`), the offset to each displayed item (name, start, current, end), and the Y offset

for each item.

The background for the legend and each entry is contained in: `org.lordashes.plugins.turncounters.legend.png` and

`org.lordashes.plugins.turncounters.background`. You can edit these PNG files to change the appearance of the item

entries. There are similar icons for CCM and the radial menu which can be customized.

The `Counters To Display allows the user to select between all and forMiniOnly`. When the setting is set to

all, all turn tokens will be displayed regardless which mini is selected and regardless which mini is in the turn

order. If forMiniOnly is selecetd, only the turn tokens for the selected mini are displayed. It should be noted that

this uses the selected mini and not the mini in the current turn order.

Usage

Common Customs Menu

• Select a mini
• Open CCM
• Select Counter as type
• Select a counter from the available options

If the selected mini already has that counter, it is removed. If not, it is added.

Ad-Hoc Radial Menu Counters

To add a counter:

• Select a mini
• Right click the mini to open the radial menu
• Select Counters
• Select Add Counter
• Enter the counter specs in the format `name|start|end` were start and end are integer numbers.

Note: If the name ends with a `*` the turn counter will be visible to GM only.

To remove a counter:

• Select a mini
• Right click the mini to open the radial menu
• Select Counters
• Select Remove Counter
• Enter the counter name

To edit a counter's value:

• Select a mini
• Right click the mini to open the radial menu
• Select Counters
• Select Edit Counter
• Enter the counter name and value in the format `name|value`

Limitations

• Ad-hoc counters will not be added to CCM automatically