See my other modules in the Boneyard Collection.
- Simple and easy to use turn timer
- Timer alerts
- Timer bar popout
- Automatic turn passing
- Quick toggle timers on and off
- Appearance customization
- Known Issues
- TODO
A new timer bar is added to the combat tracker visible to all users that displays how much time is left for the current acting player to take their turn. Timers use a configurable default duration with options for per-user custom turn durations. The timer bar shows how many seconds are left as a whole number, truncating any decimal portion before displaying.
Timers are only attached when a token controlled by a player is acting. If a token is controlled by multiple players, the timer duration uses the longest of all players who control the token. If a token is only controlled by the GM, no timer is attached.
Various alerts can be configured to help players be prepared for their turn in combat. The timer can be configured to start to flash when a certain percentage of their time has run out. A warning sound can also be configured to play at this point, as well as a different sound played at the start of a player's turn. A whispered chat message and sound alert can also be configured to occur when a player's turn is coming up next.
A new control button is added to the Token Controls that creates a draggable popout timer bar. The popout's position is remembered so that opening a popout again will place it in the same location. The popout timer has two control buttons that appear when hovered over, one to end the current turn if the user is allowed to and one to close the popout.
Settings are provided to configure the width of the popout timer as well as whether to automatically create the popout when a combat starts and close the popout when a combat ends. These are both client settings.
The timer can be configured to automatically continue to the next turn when the timer's duration has elapsed. This can also be disabled, allowing the timer to simply function as a reminder without forcing a player to end their turn early if they happen to need a little extra time. The timer will still be visible and give alerts while turn passing is disabled, but will halt at 0 seconds left once the timer's duration has elapsed.
A GM must be online for automatic turn passing.
GMs have a new combat tracker control with an hourglass icon that toggles timers on and off. When toggled off, timers are not attached when player turns occur in combat and no alerts are given. The hourglass icon has a blue glow when timers are enabled and no glow when timers are disabled.
Both the timer bar and warning glow have configuration fields for changing their color.
When loading into Foundry while a combat is active, the client won't create a timer bar for the current turn. This is because timer bars are created at turn start and aren't synchronized across all clients.
- Add options to color timer per user, as well as options to get the user's chosen color for use in their timer bar.
- Add better alert customization. Perhaps a sub menu that defines alerts per user, with the ability to define any number of alerts at any threshold, both message and sound?
- Add more styles of timer bar. (more detailed CSS options? Radial timer?)
-
Add popout timer bar / alert window. - Add option for timers on GM turns. (If desired, I don't think this is particularly useful)