TurnCountersPlugin
Provides custom turns increasing and decreasing counters
About this mod Author’s original text
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
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: