LordAshes-TurnTimerPlugin icon

TurnTimerPlugin

Implements a configurable timer with color and audio.

Last updated 3 months ago
Total downloads 174
Total rating 0 
Categories Integration Tweaks Tools
Dependency string LordAshes-TurnTimerPlugin-1.1.0
Dependants 0 other mods depend on this mod

This mod requires the following mods to function

bbepisTaleSpire-BepInExPack-5.4.10 icon
bbepisTaleSpire-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.10
brcoding-SetInjectionFlagPlugin-2.3.0 icon
brcoding-SetInjectionFlagPlugin

Allows players to flag mods are installed

Preferred version: 2.3.0
LordAshes-FileAccessPlugin-1.4.1 icon
LordAshes-FileAccessPlugin

Provides standardized methods for accessing both local file and url resources. Automatically handles searching local folders for assets.

Preferred version: 1.4.1

README

Turn Timer Plugin

This unofficial TaleSpire plugin adds a configurable timer typically used for combat turns.

This plugin, like all others, is free but if you want to donate, use: http://LordAshes.ca/TalespireDonate/Donate.php

Change Log

1.1.0: Added support for countdown timer
1.1.0: Added diagnostic configuration
1.1.0: Bug fix for pause when timer is finished
1.1.0: Bug fix for expire when timer is paused
1.0.0: Initial release

Install

Use R2ModMan or similar installer to install this plugin.

Note: Shortcut key can be configured in the R2ModMan config for the plugin.

Usage

Use the keyboard shortcut (default RCTRL+T) to open the timer.

The Play button (triangle icon) starts and restarts the timer. The Pause button (double lines icon) toggle timer pause mode. The Expire button (red X) causes the time to trigger its end event. The Close button (box) causes the timer to disapper (and reset).

R2ModMan Plugin Settings

Timer Vertical Offset = Pixel offset from the top of the screen to the timer's position. Auto Advance Initiative On Timout = If true will automatically advance the initiative when timer expires. Auto Restart Timer On Initiative To Player Character = If true will restart the timer if the new initiative creature is a player control creature. Auto Restart Timer On Initiative To GM Character = If true will restart the timer if the new initiative creature is a GM control creature.

Custom Timer Configuration

The timer is highly configurable. The configuration is stored in a file called TurnTimer.json and has the following format:

{
  "sequence": [
    {
      "time": 0,
      "color": "Green",
      "audioSource": "tick.mp3"
    },
    {
      "time": 60,
      "color": "Yellow",
      "audioSource": "tick.mp3"
    },
    {
      "time": 120,
      "color": "Orange",
      "audioSource": "tick.mp3"
    },
    {
      "time": 180,
      "color": "Magenta",
      "audioSource": "tick.mp3"
    },
    {
      "time": 240,
      "color": "Red",
      "audioSource": "buzzer.wav"
    }
  ]
}

Where:

time is the number of seconds after which the "event" occurs. color is the color that the timer text changes to when the "event" occurs. audioSource is the name of a audio file to be played. Keep empty string to not play audio (MP3 and WAV supported).

Countdown Or Countup Timer

The plugin supports both countdown and countup timers. If the first time entry in the timer configuration is 0 then a countup timer is used. All successive time entries should be incrementally larger. If the first time entry is a positive value (greater than 0) then a countdown time is used. All successive time entries should be decrementally smaller.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-9-24 1.1.0 158 Version 1.1.0 Install
2022-9-24 1.0.0 16 Version 1.0.0 Install