⏱ Animated Timer (Plugin)

An animated, extensively configurable in-game timer for Paper servers.

This is a plugin port of the popular Animated Timer datapack by Tapir0. Everything the datapack does, now as a lightweight Paper plugin with a single /timer command, tab completion, permissions and an API for other plugins.

Perfect for speedruns, challenges, events and "how long have we been playing" servers.

✨ Features

• Timer in the actionbar that counts up or down, tick-accurate
• 29 color-gradient animations (blue-pink, rainbow, gold-fade, …) with adjustable speed and direction
• Static style with two freely chosen colors (named colors or #hex), bold and italic
• 5 render types: 01:05:09, 1h 5m 9s, 1h 9s, 1ʜ 5ᴍ 9ꜱ, 1ʜ 9ꜱ
• Render pattern, prefix and suffix with variables: %t (timer), %c (coordinates), %f (facing direction)
• Extra fields globally or per player
• Automatic pause on: advancement, credits, player death, mob kill, players leaving, item obtained
• 12 ready-made profiles (galaxy, emerald, candy, maritime, forest, motley, crimson, …) and your own
• Short commands /start, /pause and /reset next to the full /timer command
• Paused screen: while paused the actionbar shows a configurable text instead of the time
• Custom chat prefix with hex gradient support (&#rrggbb)
• Hooks: run console commands when the timer reaches zero, a full minute/hour/day, is paused, continued or reset
• Developer API with Bukkit events
• State survives restarts (data.yml)

Chat messages are in German; the text shown while paused and the chat prefix can be changed in the config.

📦 Installation

1. Drop AnimatedTimer-x.y.z.jar into your server's plugins/ folder.
2. Restart the server.
3. Type /timer help.

Requires Paper 26.1+ and Java 25 (or a Paper fork such as Purpur). Spigot is not supported.

🎮 Commands

Main command: /timer (aliases /at, /animatedtimer). Short commands: /start, /pause, /reset.

Timer control

Style

Render types

Pattern variables

Automatic pause

Run a command without a value to disable that pause event.

Profiles

Built-in: galaxy, emerald, candy, maritime, forest, secondary, explore, lavender, motley, crimson, aqua, labeled

Other

🔐 Permissions

⚙️ Configuration (config.yml)

messages:
  # chat prefix, supports &-codes and &#rrggbb hex colors
  prefix: "&8[&#00D6FFL&#00DBDFe&#01E0BFg&#01E59Fi&#02EB80T&#02F060i&#02F540m&#03FA20e&#03FF00r&8] "
  # chat reply to /pause, also shown in the actionbar while paused
  paused: "Der Timer ist pausiert"
  # true = actionbar shows only the paused text while paused; false = time + " (paused)"
  paused-actionbar: true
hooks:
  reach_zero:
    - "say The countdown is over!"
    - "title @a title {\"text\":\"Time's up!\"}"
  reach_full_minute: []
  reach_full_hour: []
  reach_full_day: []
  timer_pause: []
  timer_continue: []
  timer_reset: []
autosave-seconds: 60

Hooks are console commands executed on timer events. Placeholders: %days%, %hours%, %minutes%, %seconds%, %ticks%, %state%.

🧩 Developer API

AnimatedTimerAPI api = Bukkit.getServicesManager().load(AnimatedTimerAPI.class);
api.setTotalSeconds(600);
api.setMode(TimerMode.DOWN);
api.resume();

Events: TimerPauseEvent, TimerContinueEvent, TimerResetEvent, TimerReachZeroEvent, TimerReachFullUnitEvent

❤️ Credits

Original datapack Animated Timer by Tapir0 (MIT). Documentation of the original: animated-timer.gitbook.io/docs

Licensed under MIT.