# Development

## Roadmap

* Add option to trigger a pause at specific game events (player dies, dragon defeated, ...)
* Add gradient generator for custom animations
* Implement timer modes / render patterns "realtime" & "in-game time"
* Add display option (show timer in bossbar or scoreboard title)
* Implement timer configuration UI using new dialog feature

## AT v1.3.3 - 2026-04-04

### Features

**Add animation**

* aqua-fade

### Technical

**Minor changes & bug fixes**

Individually configured extra fields are now displayed correctly when new players join the game.

**Data pack compatibility**

AT is now compatible with Minecraft 26.1 & 26.1.1.

## AT v1.3.2 - 2026-01-24

### Features

**Extend prefix & suffix fields to support variables**

In short, variables enable depicting dynamic content, including player coordinates and viewing direction. This mechanism was previously only accessible through the render pattern field but can now also be used via timer prefix and suffix.

**Implement "extra fields config" setting**

In previous releases, the configuration of so-called extra fields (prefix, suffix & render pattern) always happened on a global scope. Beginning with this version, players can now configure individual extra fields according to their own preferences, further extending AT's configuration options.

The way extra fields behave may be toggled using one of the following commands:

`/function at-conf:extra`

`/trigger extra`

### Technical

**Major re-writes of actionbar & pattern systems**

In order to enable AT's configuration changes regarding individual extra fields, both actionbar and pattern systems had to be re-written from scratch, resulting in optimizations (fewer lines of code) and improved overall code readability.

Additionally, these re-writes allow AT to target individual players when parsing variables such as player coordinates, thus finally completing the changes made in [v1.2.1](#at-v1.2.1-2025-07-04).

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.11.

## AT v1.3.1 - 2025-10-25

### Features

**Implement new API function**

You are now able to retrieve AT's locally installed version by using the following API Get function:

`/function at-tapi:get/local_version`

When executed, both the numerical patch number (e.g. 103010) as well as the verbose one (e.g. 1.3.1) are written to the [default API output path](https://animated-timer.gitbook.io/docs/advanced/api-reference#result-values).

### Technical

**Enhance input verification of several functions**

Static style type: Primary & secondary colors are now properly validated, allowing either Minecraft color code names or HEX colors. Animated style type: Both animation name & speed configuration functions now feature improved error handling when invalid input values are specified.

Additionally, profile & API Trap related functions now validate and resist against empty values, which was previously not possible.

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.9 & 1.21.10.

## AT v1.3.0 - 2025-08-17

### Major (breaking) changes

**Implement AT API**

The new application programming interface enables direct interaction with AT's timer and configuration systems, allowing external projects to:

* Read the full configuration, current timer values & state (up / down / paused), pre-rendered actionbar string, ...
* Change current time & modify any configuration setting
* Get notified when timer continues, pauses, reaches full minute / hour / zero, ...

As a consequence, all functions originally located in at-dcfg or at-dext were moved to at-tapi.

**Add new default profiles**

Beginning with this release, AT will be shipped with a total of twelve default profiles to further represent its versatile configuration options. If you are upgrading from a previous version of AT, run this command to replace all profiles with the new defaults:

`/function at-misc:profile/init`

WARNING: This will erase all profiles, including those you have created yourself.

### Features

**Re-color all chat messages**

All tellraw messages generated by AT have been re-designed to follow a more unified color scheme.

**Add two animations**

* pink-green
* yellow-indigo

### Technical

**Minor changes & bug fixes**

Some functions in the at-conf namespace were modified to not rely on the use of /return during execution. AT's render pattern is now parsed immediately after loading a profile or enabling actionbar visibility, thus preventing the sudden change of player coordinates or viewing direction.

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.8.

## AT v1.2.1 - 2025-07-04

### Features

**Extend pattern engine to display player coordinates and viewing direction**

By using the two new variables %c and %f, you are now able to reference the player's X, Y & Z values as well as viewing direction. Note that because AT's actionbar is rendered globally, only values of one player can be displayed at a time.

**Implement two new render types**

These render types, namely TAZ and TNZ, utilize ꜱᴍᴀʟʟ ᴄᴀᴘɪᴛᴀʟ letters to indicate the individual timer units. You can switch to them as you would do with any other render type:

`/function at-conf:render`

`/trigger render`

**Enhance configuration show command**

To increase usability (and to avoid having to memorize many different commands), you can now click directly on the output of the configuration show command. Doing so will reveal the command required to alter a specific configuration setting.

### Technical

**Pattern engine overhaul**

The pattern engine now dynamically calculates its maximum length, allowing you to insert up to 40 characters. Repetitive rendering has been introduced to continuously update each player's position.

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.6 & 1.21.7.

## AT v1.2.0 - 2025-04-25

### Features

**Implement option to modify timer pattern**

To further extend the configuration possibilities of AT, you can now alter the timer actionbar string. Using a single command, any text may be inserted directly before and / or after the timer:

`/function at-conf:pattern {text:""}`

The string between the two quotes will be considered part of the final actionbar. The timer itself may or may not be referenced with %t, potentially allowing you to replace it completely.

**Implement timer prefix & suffix preference**

Changing the timer pattern always results in the custom text being displayed with the timer's original style settings. If this is not desired, the custom text may also be prepended or appended in a static gray tone, depending on which command is used:

`/function at-conf:prefix {text:""}`

`/function at-conf:suffix {text:""}`

**Add five animations**

* purple-orange
* white-green
* bronze-fade
* silver-fade
* gold-fade

**Add ability to check AT version in-game**

When executed, the following commands reveal some useful information about AT, such as a general description, the currently installed version and relevant links to project pages.

`/function at:info`

`/trigger info`

### Technical

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.5.

## AT v1.1.2 - 2025-02-22

### Features

**Add two animations**

* light-blue
* white-aqua

### Technical

**Partial re-write of actionbar engine**

AT now renders animation colors per charater instead of per actionbar component. This improves the visual quality of AT and at the same time facilitates the implementation of new features. (preparation for v1.2.0)

## AT v1.1.1 - 2025-01-11

### Features

**Implement player requirement option**

Pauses the timer when no one is currently in the game. This setting is disabled by default but may be controlled via one of two commands:

`/function at-conf:online`

`/trigger online`

**Remove profile count limitation**

The previously existing limitation of 64 profiles is now gone due to major re-writes of some profile functions.

### Technical

**Listing function overhaul**

Both animation and profile list functions have been completely re-designed to follow a more dynamic tick-based rendering approach. This reduces overall function size and should cause less lag spikes on slower hardware.

**Data pack compatibility**

AT is now compatible with Minecraft 1.21.4.

## AT v1.1.0 - 2024-10-27

### Major (breaking) changes

**Rename several trigger scoreboards**

All profile- and some animation-related trigger scoreboards have been renamed. This will allow for easier addition of features in future releases.

**Move animation function**

The primary function for configuring animations has been moved to a new namespace.

From:\
`/function at-conf:animation`

To:\
`/function at-anim:load`

**Remove animation**

red-dark has been consolidated to a new animation that looks very similar. The migration takes place automatically during update procedure.

**New form of documentation**

Beginning with v1.1.0, any documentation will be done primarily within the new AT Docs site. As a consequence, the manual document will no longer be shipped directly with the data pack.

### Features

**Add six animations**

* red-fade
* orange-fade
* blue-fade
* pink-fade
* green-fade
* yellow-fade

**Implement option to list animations**

Existing animations may now be displayed in-game using:

`/function at-anim:list`

`/trigger list-animations`

**Extend functionality of profile list command**

As with the new animation list command, profiles can now be clicked directly within the chat window to suggest the corresponding load command.

### Technical

**Re-order animation trigger values**

They are now grouped according to color themes.

**Add namespace at-anim**

It contains animation-related controls and is used for user input.

**Update pack.mcmeta**

AT is now compatible with Minecraft 1.21.2 & 1.21.3.

## AT v1.0.1 - 2024-08-10

### Features

**Implement uninstall function at-main:uninstall**

This removes all scoreboards and NBT storages used by AT:

`/function at-main:uninstall`

**Add timer visibility setting**

The timer output (actionbar field) can now be hidden / shown using one of two functions to toggle between both states:

`/function at-conf:visibility`

`/trigger visibility`

**Add option to disable / enable trigger scoreboards**

In some of your projects, you might want to remove all trigger scoreboards. This can now be achieved easier than ever using a new function in the at-conf namespace:

`/function at-conf:triggers`

**Add three animations**

* red-yellow
* white-purple
* white-gray

### Technical

**Re-organize some functions through new namespace**

Migrate some functions from at-abar to at-misc as at-abar should only contain actionbar-related functions

**Animations are now reloaded at every load of data pack**

This was previously only done at init phase.

**Enhance timer correctness in DOWN mode**

Timer mode DOWN now pauses a second later when reaching zero.

**Update manual**

New manual version: 240810