[CGMZ] Timer (Patreon)

Completely customize the timer and add some new timer mechanics to your game.

! SEE BOTTOM OF POST FOR UPDATES !

Hi all, introducing [CGMZ] Timer!

This plugin allows you to customize the timer in the game. You can freely swap between various timer presets. See below gif for a preview of some of the features this plugin is capable of:

Customization

 The plugin comes with many customization options. You can change the timer color, add a label to it including text code support, and change the opacity of the timer. The timer can be swapped at any time to another customization preset.

You can also change the format of the timer. Typically it shows a clock format, where 1min 30sec would be represented as 1:30. However, with this plugin you can change that to show the number of seconds without formatting as a clock time, or 90 seconds in the above example.

Mechanics

This plugin also adds a bunch of new mechanics to the timer. You can have a timer that counts up instead of down. You can add/subtract time from the timer. You can run a common event or custom javascript when the timer expires (hits 0 time left). With these features, you should have nearly endless possibilities for when the timer ends without complicated eventing.

You can also change the timer speed. This could be useful if you want to simulate time moving faster or slower in your game. It could also be useful if you want to re-create a more retro timer that typically counted faster than once per second.

Convenience Features

You can choose to run the default timer stop functions when the timer expires, leading to high compatibility with other plugins that use the timer. You can also prevent these default functions from running, in case you want to disable those functions in some cases but not all.

When the timer expires, you can optionally have it reset to the default timer or default speed. This can make it easier for you to event different timers without needing to constantly clear the settings of the previous timer.

The timer still uses built-in event commands to control and stop the timer, so it will be very familiar and easy to learn how to use this plugin.

Roadmap

This plugin is already very usable in its current form, though of course I have some planned features to be added in future updates to make it even better. These include, in no particular order:

Multiple timers active at once

Positioning for the timer

Effects every x seconds

Animations

Background Images

Do you have any ideas you'd like to see added to the plugin not already listed above? Let me know in the comments or in my Discord's #suggestion channel! I appreciate all suggestions I get and add them all to my to-do list.

Happy RPG Making!

This version adds x and y offsets to your timer. These are available both to your presets and to the default timer.

This update also added an integration with [CGMZ] Toast Manager, so you can now show a toast preset when the timer expires.

It also fixes a bug with the timer showing NaN in saved games from before this plugin was added. This plugin should no longer crash the game if you try to swap to a timer preset that does not exist (for example, if you make a type). Instead, it will just use the default timer.