⏱ Animated Timer (插件)
一款适用于 Paper 服务器的动画式、高度可配置的游戏内计时器。
这是由 Tapir0 制作的流行 Animated Timer 数据包 的插件移植版本。
现在,数据包的所有功能都作为一个轻量级的 Paper 插件提供,包含单一的 /timer 命令、Tab 补全、权限系统以及供其他插件调用的 API。
非常适合速通、挑战活动、赛事以及“我们玩了多久”类型的服务器。
✨ 特性
- 动作栏中的计时器,支持向上或向下计数,精确到刻(tick)
- 29 种颜色渐变动画(
blue-pink、rainbow、gold-fade 等),可调节速度和方向
- 静态样式,使用两种自由选择的颜色(命名颜色或
#hex 色值),支持粗体和斜体
- 5 种渲染类型:
01:05:09、1h 5m 9s、1h 9s、1ʜ 5ᴍ 9ꜱ、1ʜ 9ꜱ
- 带有变量的渲染模式、前缀和后缀:
%t(计时器)、%c(坐标)、%f(朝向方向)
- 额外字段支持全局或按玩家设置
- 自动暂停触发条件包括:达成进度、播放制作人员名单、玩家死亡、击杀生物、玩家离开、获得物品
- 12 种预设配置文件(
galaxy、emerald、candy、maritime、forest、motley、crimson 等)以及自定义配置文件
- 除了完整的
/timer 命令外,还提供简短命令 /start、/pause 和 /reset
- 暂停屏幕:暂停时,动作栏显示可配置文本而非时间
- 自定义聊天前缀,支持十六进制渐变 (
&#rrggbb)
- 挂钩功能:当计时器归零、整分/整小时/整天、被暂停、继续或重置时,执行控制台命令
- 基于 Bukkit 事件的开发者 API
- 状态持久化保存(
data.yml)
聊天消息为德语;暂停时显示的文本和聊天前缀可在配置文件中修改。
? 安装
- 将
AnimatedTimer-x.y.z.jar 放入服务器的 plugins/ 文件夹中。
- 重启服务器。
- 输入
/timer help。
需要 Paper 26.1+ 和 Java 25(或 Purpur 等 Paper 分支)。不支持 Spigot。
? 命令
主命令:/timer(别名 /at、/animatedtimer)。快捷命令:/start、/pause、/reset。
计时器控制
| 命令 |
描述 |
/timer continue 或 /start |
继续计时(别名:start、resume) |
/timer pause 或 /pause |
暂停计时(别名:stop) |
/timer reset 或 /reset |
重置并启动。UP 模式:从 0 开始,DOWN 模式:从上次的设定时间开始 |
/timer reboot |
设置为 UP 模式,已暂停,时间为 0 |
/timer set <seconds|minutes|hours|days> <value> |
设置单个时间单位 |
/timer set <[[dd:]hh:]mm:ss> |
设置完整时间,例如 /timer set 10:00 |
/timer set time <d> <h> <m> <s> |
通过单独的值设置完整时间 |
/timer mode [up|down] |
切换/设置计数方向 |
/timer visibility [shown|hidden] |
显示/隐藏动作栏 |
样式
| 命令 |
描述 |
/timer style [static|animated] |
切换样式类型 |
/timer render [caz|saz|snz|taz|tnz] |
切换/设置渲染类型 |
/timer animation list |
列出所有动画及颜色预览(点击加载) |
/timer animation load <name> |
激活一种动画 |
/timer speed <ticks> |
每个动画步骤所需的刻数 |
/timer direction [l2r|r2l] |
动画方向 |
/timer bold [1|2] |
切换粗体(1 = 主色,2 = 辅色) |
/timer italic [1|2] |
切换斜体 |
/timer color <1|2> <color> |
静态颜色:red、gold、#1ef9ca 等 |
/timer pattern <text> |
渲染模式,例如 ⌛ %t · %f ⚓ |
/timer prefix [text] |
计时器前的灰色文本 |
/timer suffix [text] |
计时器后的灰色文本 |
/timer extra [global|individual] |
额外字段,适用于所有人或按玩家区分 |
/timer show |
打印当前的样式配置 |
渲染类型
| 类型 |
示例 |
caz |
01:05:09 |
saz |
1h 5m 9s |
snz |
1h 9s |
taz |
1ʜ 5ᴍ 9ꜱ |
tnz |
1ʜ 9ꜱ |
模式变量
| 变量 |
含义 |
%t |
计时器的位置(仅在模式中有效;若无此变量则仅显示文本) |
%c |
观看玩家的坐标 |
%f |
玩家面朝的方向(N、NE 等) |
%% |
字面量 % |
自动暂停
| 命令 |
描述 |
/timer autopause achieve [advancement] |
当玩家达成进度时暂停,例如 minecraft:end/kill_dragon |
/timer autopause credits |
当玩家看到制作人员名单时暂停 |
/timer autopause death |
当玩家死亡时暂停 |
/timer autopause defeat [mob] |
当玩家击杀生物时暂停,例如 ender_dragon |
/timer autopause leave [disabled|single|all] |
当一名/所有玩家离开时暂停(默认:all) |
/timer autopause obtain [item] |
当玩家获得物品时暂停,例如 nether_star |
/timer behavior |
打印当前的行为配置 |
运行不带值的命令以禁用该暂停事件。
配置文件
| 命令 |
描述 |
/timer profile list |
列出所有配置文件(点击加载) |
/timer profile load <name> |
加载一个配置文件 |
/timer profile save <name> |
将当前样式保存为配置文件 |
/timer profile view <name> |
查看配置文件的内容 |
/timer profile delete <name> |
删除一个配置文件 |
内置配置:galaxy、emerald、candy、maritime、forest、secondary、explore、lavender、motley、crimson、aqua、labeled
其他
| 命令 |
描述 |
/timer help |
命令概览 |
/timer info |
版本、当前时间及链接 |
? 权限
| 权限 |
默认值 |
授予 |
animatedtimer.view |
everyone |
info, show, behavior, animation & profile lists |
animatedtimer.control |
OP |
continue, pause, reset, reboot, set, /start, /pause, /reset |
animatedtimer.configure |
OP |
style, behavior, auto-pause, profiles |
animatedtimer.individual |
everyone |
own pattern/prefix/suffix in individual mode |
animatedtimer.* |
OP |
everything |
⚙️ Configuration (config.yml)
messages:
# chat prefix, supports &-codes and &#rrggbb hex colors
prefix: "&8[�D6FFL�DBDFeE0BFgE59FiEB80TF060iF540mFA20eFF00r&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.
⏱ 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
- Drop
AnimatedTimer-x.y.z.jar into your server's plugins/ folder.
- Restart the server.
- 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
| Command |
Description |
/timer continue or /start |
Continue the timer (aliases: start, resume) |
/timer pause or /pause |
Pause the timer (alias: stop) |
/timer reset or /reset |
Reset & start. UP mode: from 0, DOWN mode: from the last set time |
/timer reboot |
Mode UP, paused, time 0 |
/timer set <seconds|minutes|hours|days> <value> |
Set a single unit |
/timer set <[[dd:]hh:]mm:ss> |
Set the whole time, e.g. /timer set 10:00 |
/timer set time <d> <h> <m> <s> |
Set the whole time with separate values |
/timer mode [up|down] |
Toggle / set the counting direction |
/timer visibility [shown|hidden] |
Show / hide the actionbar |
Style
| Command |
Description |
/timer style [static|animated] |
Toggle the style type |
/timer render [caz|saz|snz|taz|tnz] |
Toggle / set the render type |
/timer animation list |
List all animations with a color preview (click to load) |
/timer animation load <name> |
Activate an animation |
/timer speed <ticks> |
Ticks per animation step |
/timer direction [l2r|r2l] |
Animation direction |
/timer bold [1|2] |
Toggle bold (1 = primary, 2 = secondary) |
/timer italic [1|2] |
Toggle italic |
/timer color <1|2> <color> |
Static colors: red, gold, #1ef9ca, … |
/timer pattern <text> |
Render pattern, e.g. ⌛ %t · %f ⚓ |
/timer prefix [text] |
Gray text in front of the timer |
/timer suffix [text] |
Gray text after the timer |
/timer extra [global|individual] |
Extra fields for everyone or per player |
/timer show |
Print the current style configuration |
Render types
| Type |
Example |
caz |
01:05:09 |
saz |
1h 5m 9s |
snz |
1h 9s |
taz |
1ʜ 5ᴍ 9ꜱ |
tnz |
1ʜ 9ꜱ |
Pattern variables
| Variable |
Meaning |
%t |
Position of the timer (pattern only; without it only the text is shown) |
%c |
Coordinates of the viewing player |
%f |
Direction the player is facing (N, NE, …) |
%% |
A literal % |
Automatic pause
| Command |
Description |
/timer autopause achieve [advancement] |
Pause when a player gets the advancement, e.g. minecraft:end/kill_dragon |
/timer autopause credits |
Pause when a player sees the credits |
/timer autopause death |
Pause when a player dies |
/timer autopause defeat [mob] |
Pause when a player kills the mob, e.g. ender_dragon |
/timer autopause leave [disabled|single|all] |
Pause when one / all players leave (default: all) |
/timer autopause obtain [item] |
Pause when a player has the item, e.g. nether_star |
/timer behavior |
Print the current behavior configuration |
Run a command without a value to disable that pause event.
Profiles
| Command |
Description |
/timer profile list |
List all profiles (click to load) |
/timer profile load <name> |
Load a profile |
/timer profile save <name> |
Save the current style as a profile |
/timer profile view <name> |
Show a profile's contents |
/timer profile delete <name> |
Delete a profile |
Built-in: galaxy, emerald, candy, maritime, forest, secondary, explore, lavender, motley, crimson, aqua, labeled
Other
| Command |
Description |
/timer help |
Command overview |
/timer info |
Version, current time and links |
? Permissions
| Permission |
Default |
Grants |
animatedtimer.view |
everyone |
info, show, behavior, animation & profile lists |
animatedtimer.control |
OP |
continue, pause, reset, reboot, set, /start, /pause, /reset |
animatedtimer.configure |
OP |
style, behavior, auto-pause, profiles |
animatedtimer.individual |
everyone |
own pattern/prefix/suffix in individual mode |
animatedtimer.* |
OP |
everything |
⚙️ Configuration (config.yml)
messages:
# chat prefix, supports &-codes and &#rrggbb hex colors
prefix: "&8[�D6FFL�DBDFeE0BFgE59FiEB80TF060iF540mFA20eFF00r&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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧