Legi Timer

插件

· 作者 Legicrafter

一个适用于 Paper 服务器的动画化、高度可配置的内置计时器。

0 本站下载 0 关注 更新于 2 个月前

最新 1.4.4 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

⏱ 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)

聊天消息为德语;暂停时显示的文本和聊天前缀可在配置文件中修改。


? 安装

  1. 将 AnimatedTimer-x.y.z.jar 放入服务器的 plugins/ 文件夹中。
  2. 重启服务器。
  3. 输入 /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[&#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.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源