Status Icon Counters

Status Icon Counters allows setting and displaying a counter on any token's status effects.

The module has several options. The font size and color should be self-explanatory.

The mouse rebind option changes the click behavior as follows:

• Left click on a status icon (in the token HUD) increases the stack count by 1. If it wasn't active before, it is added.
• Right click on a status icon decreases the stack count by 1. If it reaches 0, the effect is removed. If it is already inactive, the overlay effect is toggled instead.
• Shift + left click on a status icon always toggles the overlay effect.

The number key rebind behaves as follows:

• Pressing any number key while hovering an effect sets the stack count to that number. If it wasn't active before, it is added.
• Pressing 0 removes the effect.

Holding the Alt key during any bind modifies the effect's duration instead of the counter value (or vice versa, if the counter uses the duration by default).

Using Ctrl + Left click on an active status effect opens its advanced counter configuration. The following options are available:

• The amount allows you to set an arbitrary stack count. This is useful if your system uses large values that would take a lot of clicks to enter.
• The duration can be set to display the effect's remaining duration in any unit that FoundryVTT provides. It is possible to display both an amount and a duration at the same time.
• The hide duration toggle prevents the display of the effect's duration, even when it is temporary.
• The modify duration toggle is used to change the keybinds (both mouse and number keys) to affect the duration instead of the counter's value. The Alt key can then be used to invert this behavior temporarily.
• The multiply effect setting enables the modification of any underlying active effect changes with the stack count. For example, if an effect would decrease your health by 4, its value will be increased to 8 for 2 stacks, 12 for 3 stacks, etc. For effects that are already multipliers, the change is modified additively (e.g. 0.8 for 1 stack becomes 0.6 for 2 stacks, not 0.64).

Saving the configuration as default will reapply these settings (except for the value) every time an effect for that status is created. Otherwise, the settings are only applied to this specific effect and will be reset when it is removed.

System developers can define their own counter types and defaults for each effect. Read the development section on the project repository to find out how.