Architects Time

模组

· 作者 TheBarracksRat

适用于 NeoForge 的可配置日历、季节系统、时钟 HUD 以及季节性作物生长框架。

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

最新 0.1.1 · 1.21.1 · NeoForge

一键开服(送7天)

Architects Time

Architects Time 是适用于 NeoForge 1.21.1 的可配置日历、季节、时钟及季节性生长框架。

它为玩家提供同步的游戏内日历和可自定义的时钟 HUD,同时为整合包创作者和开发者提供一个可复用的、数据驱动的基础设施,用于构建季节性机制、进度系统、作物系统、任务、活动及其他与时间相关的内容。

Architects Time 设计为一个独立框架。无需依赖 Architects Core 或其他 Architects 模块即可运行。

Architects Time 不会改变天气或添加视觉上的季节性效果。

日历与季节

Architects Time 包含一个开箱即用的标准日历,具备以下特性:

  • 春季
  • 夏季
  • 秋季
  • 冬季
  • 每个季节 28 个 Minecraft 日
  • 每个季节包含四个为期七天的周
  • 每年 112 个 Minecraft 日

该标准日历还支持“季初”和“季末”阶段。

这仅是内置的默认设置。整合包创作者不受限于仅使用四季或此日历结构。

日历由数据包定义,可提供自定义内容:

  • 季节
  • 月份或日历周期
  • 周期长度
  • 周的长度
  • 星期名称
  • 季节阶段
  • 显示名称
  • 符号和图标
  • HUD 布局

日历与时钟 HUD

Architects Time 包含一个可配置的 HUD,可直接在游戏内显示同步的日历和 Minecraft 时钟信息。

根据所选布局,HUD 可以显示:

  • 季节
  • 季节阶段
  • 日历周期
  • 周
  • 星期几
  • 季节中的第几天
  • 一年中的第几天
  • 年份
  • Minecraft 游戏时间
  • 季节图标
  • 周期图标
  • Minecraft 时钟图标

支持 12 小时制和 24 小时制两种时钟格式。

HUD 布局可以组合普通文本、支持的布局标记(tokens)、图标和多行内容。

玩家可以配置 HUD 的可见性、位置、偏移量、缩放比例、文字阴影、时钟格式以及自定义布局。

时钟显示每 10 分钟更新一次。

游戏内配置

Architects Time 包含原生的 NeoForge 配置界面。

打开路径:

Mods > Architects Time > Config

以配置可用的客户端和服务端设置。

配置界面包含易于理解的设置名称、描述和工具提示,例如:

  • HUD 可见性与定位
  • HUD 缩放
  • 时钟格式
  • 文字阴影
  • 自定义 HUD 布局
  • FTB Chunks 集成
  • Jade 作物信息
  • 日历进度
  • 季节性生长行为

布局设置还包含对支持的标记(tokens)和有效资源 ID 格式的指引。

服务端拥有的设置继续遵循正常的 NeoForge 服务端配置规则。

服务器同步时间

日历由服务器权威控制,并在连接的玩家之间保持同步。

Architects Time 将日历进度与单纯读取 Minecraft 的天体时钟分离开来,允许整合包创作者围绕稳定的日历构建系统,而不是直接依赖原始的世界时间。

正常的时间流逝、睡眠以及支持的时间推进都会在日历中体现。

管理命令和公共 API 也可以检查或修改日历时间。

FTB Chunks 集成

FTB Chunks 是可选的。

当安装了 FTB Chunks 时,Architects Time 可以在 FTB Chunks 小地图下方显示同步的日历信息。

默认布局使用三行独立居中的文本:

<season_icon> Early Spring
Week 1 | Monday
<clock_icon> 2:30 PM

显示的阶段、季节、周、星期几和时间均使用实时的同步 Architects Time 日历数据。

小地图组件支持:

  • 季节着色
  • 季节图标
  • Minecraft 时钟图标
  • 自定义布局标记(tokens)
  • 多行显示
  • 独立的启用设置
  • 独立的布局覆盖

独立的 Architects Time HUD 和 FTB Chunks 组件可以独立启用或禁用。

FTB Chunks 仍负责组件排序、可见性、小地图放置和字体缩放。

针对 Minecraft 1.21.1 的兼容性是在 NeoForge 2101.1.22 系列上开发和测试的。

季节性作物生长

Architects Time 包含一个数据驱动的季节性生长框架,适用于作物和其他支持的生长方块。

生长规则可以将作物分类为:

  • Preferred(适宜)
  • Tolerated(耐受)
  • Out of Season(非适宜)
  • Protected(受保护)
  • Unconfigured(未配置)

已配置的作物在其适宜季节生长更快,在非适宜季节生长较慢,但不会被摧毁或永久阻止生长。

未配置的作物保留正常的 Minecraft 行为。

季节性生长规则可以针对单个方块或标签,并可通过数据包进行自定义。

作物保护与兼容性

Architects Time 不实现自己的温室系统。

相反,它提供了一个保护 API,允许其他模组和整合包特定系统告知 Architects Time 何时应保护作物免受季节性惩罚。

这使得温室系统、机器、魔法生长区域及其他机制能够集成,而无需 Architects Time 自行提供这些系统。

Jade 集成

Jade 是可选的。

当安装了 Jade 时,支持的作物可以显示:

  • 季节性分类
  • 当前生长倍率
  • 预计成熟时间

生长估计可以使用 Minecraft 日历时间或近似实时参考。

由于正常的 Minecraft 作物生长使用随机刻(random ticks),成熟信息显示为估计值而非精确倒计时。

KubeJS 集成

KubeJS 是可选的。

Architects Time 向 KubeJS 暴露日历和时间功能,以便进行整合包脚本编写。

这可用于:

  • 季节性事件
  • 任务要求
  • 计划进度
  • 基于时间的解锁
  • 自定义季节性机制

正常运行 Architects Time 功能不需要 KubeJS。

致整合包创作者

Architects Time 被构建为可复用的基础设施,而非绑定于某个特定整合包的日历。

日历定义从以下路径加载:

data/<namespace>/architectstime/calendars/<name>.json

季节性生长规则从以下路径加载:

data/<namespace>/architectstime/seasonal_growth/<name>.json

内置的标准日历提供了一个完整且可运行的示例。

日历周期可以使用自定义资源包图标,也可以使用现有的 Minecraft 原版或模组物品图标来显示在 HUD 中。

开发者 API

Architects Time 提供了受支持的 Java 集成 API,位于:

com.silentvector.architectstime.api

该 API 包含以下内容:

  • 日历快照
  • 日历过渡
  • 时间推进
  • 持续时间格式化
  • 季节性生长适配器
  • 生长估算
  • 季节保护提供者
  • 日历事件

公共 API 之外的实现包被视为内部实现,可能会在版本之间发生变化。

命令

只读的 Architects Time 命令可供玩家使用,而修改日历时间的命令需要操作员权限。

示例包括:

  • /architectstime date
  • /architectstime time
  • /architectstime season
  • /architectstime calendar
  • /architectstime add days <value>
  • /architectstime add ticks <value>
  • /architectstime set date <year> <period> <day>
  • /architectstime set time <HH:MM>
  • /architectstime set season <season> [day]

对于 season 命令,可选的 day 参数表示所选季节内的第几天(从 1 开始计数)。

例如:

/architectstime set season winter

以及

/architectstime set season winter 1

两者都选择冬季的第一天。

此外,还为整合包开发者和服务器管理员提供了额外的调试命令。

要求与兼容性

  • Minecraft: 1.21.1
  • 加载器: NeoForge 21.1+
  • Java: 21
  • 环境: 客户端和服务器
  • 可选: FTB Chunks
  • 可选: Jade 15+
  • 可选: KubeJS 2101.7+

Architects Time 必须安装在服务器和连接的客户端上。

FTB Chunks、Jade 和 KubeJS 是可选集成项,并非 Architects Time 核心功能所必需。

Architects Time 不依赖 Architects Core 或其他 Architects 模块。

Architects

Architects Time 是 Architects 项目家族的一部分,这是一组可重用的工具、框架和集成方案,旨在帮助模组开发者和整合包创建者连接并扩展 Minecraft 系统,而无需将所有内容强制塞入一个庞大的单体模组中。

许可证

Architects Time 根据 GPL-3.0-only 许可证发布。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源