TimeLib

数据包

· 作者 SilicatYT

获取真实世界的日期和时间,精准高效!

0 本站下载 0 关注 更新于 1 年前

最新 2.3.1 · 1.21.8 · 数据包

一键开服(送7天)

⚠ 注意 ⚠

(2025年9月27日)我发现 TimeLib 存在几个严重问题,使其在某些用例中不可靠。请仔细阅读以下内容并自行评估是否要使用 TimeLib。一旦 Mojang 找到或添加了修复这些问题的方法,我将再次继续支持 TimeLib。截至我撰写本文时,TimeLib v2.3.1 是最新版本。

TimeLib 并未永久停更,待所有问题解决后它将回归!
我会在此处以及 MinecraftCommands Discord 服务器(在 #resources 频道)发布有关该情况的更新。

根本性(目前)无法修复的问题:

由于这些问题,为了让 TimeLib 按预期工作,用户需要每次世界重新加载时都手动确认/调整日期。这违背了 TimeLib 的初衷,因此我需要时间思考/等待 Mojang 使缓解这些问题成为可能。

  • ⚠ 如果玩家头颅档案(包含时间戳)超过 24 小时(可能因缓存导致且无法检测),则无法准确自动检测日期
  • ⚠ 自 1.21.9 版本起,Unix 时间戳只能从在线玩家处获取,这意味着当没有玩家在线时 TimeLib 无法更新日期,可能会破坏依赖它的整合包(注:只需要玩家在初始阶段同步一次日期即可。只要时间不同步发生,即使没有玩家在线它也能继续工作)
  • 包含游戏暂停/冻结期间刻数的 PausedTicks 计分板仅在从头到尾至少有一名玩家在线时才有效。如果所有人在游戏冻结时离开(不必同时),或者一开始就没有人在线,那么 PausedTicks 中存储的值是不可靠的
    • 同样的问题导致将游戏冻结 24 小时以上会使天数不增加(因为如果没有人在线,就无法判断过去了多少时间)
  • 由于夏令时的原因,Unix 时间戳(预期应单调递增)可能会倒退 1 小时,从而破坏那些严格依赖单调性的整合包。由于无法自动检测时区和夏令时,在没有玩家手动输入的情况下无法对此进行补救

其他已知的可修复漏洞/疏忽:

一旦我有空处理,我会修复这些问题。 在此期间,我将它们列在这里以便你知晓。虽然并非所有已知问题都已列出,但这些都是主要问题。

  • ⚠ 一个疏忽导致在极少数情况下日期可能比实际日期提前 1 天
  • ⚠ 一个疏忽导致在服务器/客户端连续运行超过 1 天后日期不再增加
  • ⚠ 当时间不正确(因为检索必要数据需要一点时间)时,TimeLib 不会指示时间尚未同步,这可能会破坏那些试图在未准备好时获取数据的整合包

TimeLib

一个 Minecraft 数据包库,让你在游戏中获取现实世界的日期和时间。如有咨询,请在 Discord 上联系 @silicatYT。

下载:Modrinth
报告错误:GitHub

功能

  • 提供具有刻级精度的现实世界日期和时间:
    • 年、月、日、星期几、小时、分钟、秒及 Unix 时间戳
  • 提供当前刻率
  • 检测游戏暂停及暂停时长(例如 /tick freeze 或单人模式)
  • 将任何 Unix 时间戳转换为日期和时间
  • 支持不同时区及夏令时
  • 支持延迟、不同的刻率及暂停
  • 高效率

使用方法

TimeLib 会自动为你跟踪日期和时间。为此,你需要首先根据个人喜好配置设置。要访问设置,请点击重新加载后出现在聊天栏中的消息,或手动运行 /function timelib:util/settings。

→ 设置

  • Command Block Offset(命令方块偏移量):这是必需的,用于抵消 UTC 时区与你的系统时间之间的差异。如果夏令时发生变化,需要调整此设置以确保日期计算正常工作。
    • 示例: UTC(晚上 7 点),系统时钟(晚上 8 点)→ 使用 1h
  • Timezone Offset(时区偏移量):使用此项更改显示的时间。
    • 示例: 晚上 8 点 + 1h 偏移 → 晚上 9 点

→ 获取现实世界的日期和时间

年、月、日、星期几、小时、分钟、秒及 Unix 时间戳的值都存储在玩家 #TimeLib 中,每个值都有自己独立的计分板目标:

  • TimeLib.Year, TimeLib.Month, TimeLib.Day, TimeLib.WeekDay, TimeLib.Hour, TimeLib.Minute, TimeLib.Second & TimeLib.UnixTime

此外,日期和时间的字符串版本(带有前导零)存储在 timelib:date 和 timelib:daytime 数据存储中。

→ 事件

  • #timelib:date_changed:每当日期更改时执行的函数标签
  • #timelib:daytime_changed:每当白天时间更改时执行的函数标签
  • #timelib:game_unpaused:每当游戏取消暂停时执行的函数标签
    • #TimeLib TimeLib.PausedTicks 计分板保存游戏被暂停的刻数

→ 获取刻率

刻率每秒更新一次,可以从 TimeLib.Tickrate 计分板目标中读取。

→ 将任何 Unix 时间戳转换为日期和时间

注意: 输出的日期和时间位于 UTC 时区,因为夏令时无法得到适当考虑。

  • 将 #TimeLib.Input TimeLib.UnixTime 分数设置为输入值。
  • 运行 /function timelib:util/unix_timestamp_to_date。
  • 输出值将存储在 #TimeLib.Output TimeLib.? 分数中,以及 timelib:output 数据存储中。

工作原理

  • TimeLib 将玩家头颅内 Base64 编码的 Unix 时间戳与命令方块输出中的白天信息相结合,以计算当前的日期和时间。
  • 为了获取刻率(tickrate),TimeLib 会统计每次白天变化之间的刻数。
  • 暂停检测使用 minecraft.custom:minecraft:total_world_time 记分板目标,该目标即使在游戏暂停时也会每刻递增。

此外还使用了其他逻辑来确保最佳结果、良好的性能和准确性。

致谢

来自 CMDred:

  • SilicatYT: TimeLib
  • BananaRedPanda: Base64 解码器 & 协助开发

注意事项

  • TimeLib 需要互联网连接。
  • 获取刻率并未利用世界边界(worldborder)的非常规手段。
  • 如果你的数据包在超世界(overworld)的 29999999 29999999 处使用了强制加载区块,可能会发生冲突。
  • TimeLib(2.3.0 及更高版本)使用了 lantern load 库,允许你检查依赖项。如果你遵循其约定:
    • #TimeLib load.status:如果安装了 TimeLib 则为 1,否则未设置
    • #TimeLib.Version load.status:特定发布版本的编号
  • 升级到新版本:
    • 对于 2.3.0 之前 的 TimeLib 版本:执行 /function timelib:uninstall,然后用新版本替换当前的 TimeLib,最后执行 /reload 安装新版本
    • 从 2.3.0 或更高版本 升级到更新版本,只需将旧的数据包替换为新的即可
  • (v2.3.0+)如果同时安装了多个不同版本的 TimeLib,TimeLib 会抛出错误并停止工作。这也适用于尝试调用实用函数的情况。
    • 在运行 /function timelib:uninstall 后尝试运行实用函数时,也会出现类似行为

许可证

根据 MIT 许可证,只要对原作署名,你就有权重新分发、修改和使用 TimeLib。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源