日期时间显示

⚠️ 重要：使用指南 如果你计划在服务器或整合包中使用此内容， 请参阅： https://gamedash43.github.io/dash-mcl-licenses/#usage

此附加组件通过一个精确映射现实世界日期的日期追踪器，显示游戏内时间、天气状况、星期几和日期。

📜 功能

• 真实日历复刻：
  • 精确追踪日、月、年、闰年和星期几，与现实世界完全一致。
  • 游戏内的 2025 年 4 月 6 日与现实中的 2025 年 4 月 6 日落在同一个星期几。
  • 日期每刻都会重新计算，因此 /time set 或延迟都不会使其出错。
• 节日准确性：
  • 使用与天文软件相同的公式计算复活节、农历新年和感恩节等浮动节日。
  • 预制的钩子让附加包可以在任何节日触发事件。
• 维度感知 Boss栏：
  • 主世界： 标准日期 + 天气摘要。
  • 下界： 距入口传送门的距离。
  • 末地： 实时鞘翅飞行时间估算，直到下次修复（已计入耐久）。
  • 每个栏都是按玩家独立的，因此你看到的内容永远不会与朋友看到的内容冲突。
• 时钟+潜行切换：
  • 手持时钟直视下方时潜行，即可立即显示/隐藏你的 boss栏——无需命令。
• 实时天气、生物群系与光照检测：
  • 显示晴朗/下雨/雷暴、生物群系温度类别。
• 每日公告：
  • 在黎明时（以及加入时），你会收到一行包含完整日期、总天数和任何节日表情符号的信息。
• 显示选项：
  • 可选资源包皮肤会隐藏 boss栏边框，适合喜欢极简外观的玩家。

⚙️ 配置

• 对于新世界：
  • 使用位于 data/dash.date/function/config.mcfunction 的配置文件来设置你的初始日期。在开始新世界之前，请仔细遵循文件中的说明。
• 对于现有世界：
  • 使用以下记分板变量设置日期（全部在记分板 dash.date_arc 中）：
    • %start.year 和 %display.year 用于年份。
    • %ani.month 和 %display.month 用于月份。
    • %ani.date 和 %display.date 用于日期。
  • 更新这些值后，运行 /function dash.date:update 让系统自行校正。
• 注意： 如果你计划修改配置文件，请在创建新世界之前仔细阅读其中的说明。
• 玩家生日事件：
  • 使用以下命令设置你的生日以触发特殊事件：
    • /scoreboard players set @s dash.date_bd.month [birthday month]
    • /scoreboard players set @s dash.date_bd.date [birthday date]

🌟 计划详情

• 此附加组件被设计为一个极其精确的日历系统基础，未向游戏中添加任何额外物品。
• 正在开发中的此包附加组件将添加一个可放置的日历方块，以原版风格显示当前月份、日期和即将到来的节日。
• 未来计划包括此包附加组件中的圣诞节礼物、动态复活节彩蛋寻宝以及其他节日主题活动。

❓ 常见问题

用技术宅的话来解释。

通过使用除法和取模运算，此数据包将游戏刻转换为 12 小时制时钟，同时通过累加每月偏移量并使用标准的 4-100-400 规则调整闰年来计算一年中的第几天。星期几通过蔡勒公式的变体确定，而天数计数器算法通过累加整年贡献（含闰日调整）和当前年内天数，再减去定义的起始日期，来计算绝对天数值。此外，复活节通过一个经典算法确定，该算法应用取模和向下取整除法运算来计算正确的月份和日期，农历新年则通过从 1900 年偏移年份、对 19 取余并将结果映射到特定年内天数来近似计算。

有哪些可用的特殊事件？

特殊事件包括：

• 新年前夜： 午夜时的聊天消息和烟花秀（如果在户外）。

• 农历新年： 加入和起床时出现萤火虫。

• 情人节： 加入和起床时出现爱心。

• 圣帕特里克节： 加入和起床时出现绿色粒子。

• 复活节： 加入和起床时出现绿色和白色粒子。

• 感恩节： 加入和起床时出现秋叶。

• 冬季假日： 加入/起床时出现雪花。

• 生日： 向所有玩家播放生日快乐歌和消息。

• 世界周年纪念： 在世界创建日期举行烟花秀和纪念消息。 其他事件，如元旦和愚人节，计划在未来更新中加入。

  剧透

  • 万圣节： 白天随机出现惊吓。

此附加组件会追踪现实世界时间吗？

不，它使用基于现实世界日历逻辑的游戏内日期追踪器。

我可以隐藏 boss 栏吗？

可以，你可以使用可选资源包隐藏 boss 栏，并在屏幕顶部显示文本。

如何设置生日事件？🎂

使用提供的命令设置你的生日：

• 设置月份：/scoreboard players set @s dash.date_bd.month [birthday month]
• 设置日期：/scoreboard players set @s dash.date_bd.date [birthday date]
  之后每位玩家都会收到一个特殊的生日事件。

如何卸载此附加组件？

只需运行命令 /function dash.date:uninstall。

我正在从旧版本更新。我需要做什么？

如果你从之前的版本更新，你必须使用此命令设置起始年份：
/scoreboard players set %start.year 0 和 /function dash.date:update