原创 闭源 工具 [原创|工具] 零之时间戳 (ZeroTime) - 正计时与倒计时双模式，开服天数/节日倒数一句话搞定 | 1.12.2 1.0.1 1.0.1

零之时间戳 (ZeroTime) - 一款极简的时间占位符插件

填个日期就能用：config.yml 里写个日期，立刻拥有一个计时器或倒计时，想加几个加几个。
正计倒计双模式：算「已经过了多久」，也算「还剩多久」，一个插件全包。
年月日精确拆分：不是简单除以 365，而是按日历真实拆分，闰年闰月都对。

点击展开...

该插件为免费插件！
获取方式：请加交流群或联系作者获取
交流群：739322295
联系QQ：1904476689

---

插件核心亮点​

两种模式，一套配置​

• timers (正计时)：算「从某天到现在过了多久」——开服天数、活动开启时长、版本上线多久。
• countdowns (倒计时)：算「从现在到某天还剩多久」——节日倒数、新版本上线倒计、活动结束提醒。
  两边写法完全对称，都是 yyyy-MM-dd HH:mm:ss，学会了计时就会倒计时。

倒计时支持「每年重复」​

倒计时的年份写 #，就会自动指向每一年的同一个时刻，而且会自己往前找。
今年元旦过了，它自动指向明年的元旦，不需要你每年手动改配置。做「距离下次周年庆还有 X 天」这类功能非常省事。
年份写具体数字则是一次性倒计时，到点后所有占位符统一返回 0。

按日历真实拆分，不是简单除法​

正计时的 _all 是真正按 Period 计算的年月日差值，剩余不足一天的部分再精确换算成时/分/秒。2 月 29 日、大小月这些都不会算错。
倒计时的 _day / _hour / _minute / _second 是剩余总量的不同单位，_all 则是 X天Y时M分S秒 的完整拆分。

玩家注册天数​

%zerotime_played% 自动读取玩家的首次进服时间，输出该玩家在本服注册至今的天数。适合做「老玩家认证」「注册满 X 天解锁」这类玩法。

全场景可用​

聊天、物品 Lore、计分板、菜单标题、Tab 列表、全息投影——只要支持 PlaceholderAPI 的地方，这些变量就能用。

---

配置示例​

整个插件只要这么几段：

正向计时（从起始日期到现在）：

yaml
timers:
# 服务器开服至今
server:
start-date: "2023-01-01 12:00:00"

# 某活动开启至今
activity:
start-date: "2024-06-15 00:00:00"
倒计时（从现在到目标日期）：

yaml
countdowns:
# 一次性：倒到 2027-01-01，到点后返回 0
newyear2027:
target-date: "2027-01-01 00:00:00"

# 每年重复：年份写 #，过了今年自动指向明年
newyear:
target-date: "#-01-01 00:00:00"

# 每年 12 月 25 日 20:00
christmas:
target-date: "#-12-25 20:00:00"
占位符对照：

---

安装说明​

1. 将 ZeroTime-1.0.x.jar 放入服务器 plugins 目录。
2. 确保服务器已安装 PlaceholderAPI（本插件硬依赖，没有它无法加载）。
3. 重启您的服务器。
4. 编辑 plugins/ZeroTime/config.yml，按你服务器的实际日期配置计时器与倒计时。
5. 在菜单、计分板等处填入 %zerotime_<id>_day% / %zerotime_cd_<id>_day% 等变量即可。

---

指令与权限​

本插件没有任何指令和权限。 全部逻辑通过配置文件 + PlaceholderAPI 变量完成。

---

重要提示​

PlaceholderAPI 是硬依赖。 没装 PAPI 插件时 ZeroTime 会直接加载失败（depend 而非 softdepend）。请先装好 PAPI 再装本插件。

正计时与倒计时的占位符前缀不同。 正计时是 %zerotime_<id>_<类型>%，倒计时多一个 cd_：%zerotime_cd_<id>_<类型>%。两者 id 可以重名，不会冲突。

_month 是总月数不是月份。 1 年 2 个月会输出 14。如果你想要「显示为 1 年 2 个月」，用 _all 或组合 _year 与 _month 自行拼接。

起始日期不能填未来、目标日期不能填已过。 起始日期在未来时正计时返回 0；目标日期已到或已过时倒计时返回 0。都不会输出负数。

id 不要包含下划线。 插件按 _ 切分占位符识别 id 与类型，写成 season_2 会导致解析失败、永远返回 0。用 season2 或 season-2 都可以。

闰日会自动跳到下一个闰年。 如果配了 #-02-29，在非闰年会自动指向下一个能过 2 月 29 日的年份，不会变成 2 月 28 日。

---

Zerith-零之系列 理念：拒绝高价插件垄断，让每一位服主都能低成本开好服。群内还会不定期免费抽送付费插件，欢迎各位服主加群交流！

点击展开...