Data Packs Game Mechanic

Animated Timer

  • 19.5k views 6 today
  • save_alt 6.5k downloads 4 today
Compatibility
Minecraft 1.21
to version
Minecraft 26.1
Changes include
  • Functions
  • Loot Tables
  • 30
  • 29
  • 19
Tapir0
Lvl 33Artisan Toast
6

Introduction

Animated Timer (AT) data pack adds an in-game timer via the actionbar field of Minecraft’s HUD. A wide range of functions ensures a simple yet versatile configuration, allowing you to customize your timer according to your likings and needs.

Features

In its original and unmodified state, features include:
  • Count-up & count-down
  • Multiple render (display) types
  • Both static (never changing) and animated (always changing) color configuration
  • General style configuration (bold & italic text)
  • Pre-built animations
  • Profiles (ability to save current configuration & load at a later time)
  • Trigger scoreboards for complete configuration & interaction even if cheats are disabled
  • Advanced features for map makers (facilitated embedding into external projects)

Controlling the timer

AT can be controlled the following way:

Description
Cheats enabled
Without cheats
Start / resume the timer/function at:continue/trigger continue
Pause the timer/function at:pause/trigger pause
Set timer to its initial value and start it/function at:reset/trigger reset
Set timer to zero and stay paused/function at:reboot/trigger reboot

Controlling the timer

Manually setting time

In some situations, you may want to alter the current time manually. This can be done either with a function in the at-time namespace or with /trigger:

Description
Cheats enabled
Without cheats
Configure seconds/function at-time:add/second
/function at-time:remove/second
/function at-time:set/seconds/10
/trigger seconds set 10
Configure minutes/function at-time:add/minute
/function at-time:remove/minute
/function at-time:set/minutes/15
/trigger minutes set 15
Configure hours/function at-time:add/hour
/function at-time:remove/hour
/function at-time:set/hours/3
/trigger hours set 3
Configure days/function at-time:add/day
/function at-time:remove/day
/function at-time:set/days/7
/trigger days set 7

Note: The above functions that include at-time:set are just examples. In fact, a multitude of set functions are available for use.

Manually setting time

Timer modes

AT is counting up by default but count-down is also available. You can toggle between both count modes with a single command:

Description
Cheats enabled
Without cheats
Switch between timer modes/function at-conf:mode/trigger mode

Timer modes

How to upgrade

  1. Download latest data pack version
  2. In your datapacks directory, replace old version with new one
  3. Reload your game, either with /reload or through re-joining your world

Are you interested?

If you would like to find out more about configuration or how to integrate this timer into your projects, please check out the AT Docs site.

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

References

Changelog
The full changelog can be found here.

Inspiration
This project was inspired by German content creator BastiGHG who often uses a similar version of this timer in his videos.

10 Update Logs

v1.3.3 : by Tapir0 04/04/2026 1:51:01 pmApril 4 @ 5:51 pm UTC

Features

  • Add animation

Technical

  • Minor changes & bug fixes
  • Data pack compatibility (Minecraft 26.1 & 26.1.1)

The full changelog can be found at AT's documentation.
LOAD MORE LOGS

More like this

  Have something to say?

Schmuvius
08/30/2025 4:47 pm
Level 1 : New Miner
Is it possible to detect the paused state of the timer using /data get?
1
Tapir0
08/31/2025 4:23 pm
Level 33 : Artisan Toast
This is possible using the timer API that was introduced in v1.3.0. I haven't had the time to document it yet, but you could get the paused state as follows:

Run » /function at-tapi:get/timer_state « to extract the timer state and write it to NBT storage. You can then read the API result via » /data get storage animated-timer:data at.api.result « to get some information about the request context and return value.

Result data is generally accessible through the NBT path at.api.result.data - the integer value "numerical" has three possible values:
  • 0: timer is paused
  • 1: counting up
  • 2: counting down
Hope this helps
1
Schmuvius
09/02/2025 12:32 pm
Level 1 : New Miner
Aha, thanks for the anwser! However, I did not manage to work with /data get, but I found a different solution that works.
1
User5917129G
07/30/2025 8:19 am
Level 1 : New Miner
Hey the commands arent working does annyone knows why?
1
Tapir0
08/03/2025 7:53 am
Level 33 : Artisan Toast
Hey, it may be possible that AT isn't installed correctly. Please check your version of Minecraft (1.21 or higher) and follow the instructions described in this article. If installed correctly, the timer should be visible above your hotbar.
1
User5778439G
05/21/2025 5:09 am
Level 1 : New Miner
is there any chance to start/pause/reset without cmds?
1
Tapir0
05/22/2025 1:17 pm
Level 33 : Artisan Toast
Hey, this is currently not possible, except that the timer pauses as soon as it counts down to zero. Could you please elaborate on what you are trying to accomplish?
1
NoVelo
03/09/2025 10:42 am
Level 1 : New Miner
Hello,
with this command:
/function at-anim:load {name:blue-fade}
What colors can you enter?
2
Tapir0
03/09/2025 5:14 pm
Level 33 : Artisan Toast
Hey, you can use /function at-anim:list or alternatively /trigger list-animations to print out a list of available animations (colors). Simply left-click on the one you would like to use to suggest the corresponding load command. For more information regarding this topic, please read the docs.
2
Zwerg2012
02/26/2025 7:52 am
Level 1 : New Miner
Hello,


i want a green timer like BastiGHG. Is that possible in this timer?
2

Welcome