Architects Time

Architects Time is a configurable calendar, season, clock, and seasonal-growth framework for Minecraft 1.21.1 on NeoForge.

It provides players with a synchronized in-game calendar and customizable clock HUD while giving modpack creators and developers a reusable, data-driven foundation for seasonal mechanics, progression, crop systems, quests, events, and other time-aware content.

Architects Time is designed as a standalone framework. It does not require Architects Core or another Architects module.

Architects Time does not change weather or add visual seasonal effects.

Calendar and Seasons

Architects Time includes a ready-to-use standard calendar with:

• Spring
• Summer
• Autumn
• Winter
• 28 Minecraft days per season
• Four seven-day weeks per season
• 112 Minecraft days per year

The standard calendar also supports Early and Late season phases.

This is only the included default. Modpack creators are not limited to four seasons or this calendar structure.

Calendar definitions are data-driven and can define custom:

• Seasons
• Months or calendar periods
• Period lengths
• Week lengths
• Weekday names
• Season phases
• Display names
• Symbols and icons
• HUD layouts

Calendar and Clock HUD

Architects Time includes a configurable HUD that can display synchronized calendar and clock information directly in-game.

Depending on the selected layout, the HUD can display information such as:

• Season
• Season phase
• Calendar period
• Week
• Weekday
• Day of the season
• Day of the year
• Year
• Minecraft time
• Season icons
• Period icons
• Minecraft clock icons

Both 12-hour and 24-hour clock formats are supported.

HUD layouts can use normal text, supported layout tokens, icons, and multiple lines.

The clock display updates in 10-minute increments.

Players can configure client-side HUD options such as visibility, position, scale, text shadow, clock format, and layout.

In-Game Configuration

Architects Time includes a native NeoForge configuration screen.

Open:

Mods > Architects Time > Config

to configure available client and server settings.

The configuration screen provides readable setting names, descriptions, and tooltips for options including:

• HUD visibility
• HUD position and offsets
• HUD scale
• Clock format
• Text shadow
• Custom HUD layout
• FTB Chunks minimap integration
• Jade crop information
• Calendar progression
• Seasonal growth settings

Layout fields also provide guidance for supported layout tokens and valid resource-ID formats.

Server-owned settings continue to follow normal NeoForge server configuration rules. Remote clients cannot use the screen to modify settings owned by a dedicated server.

Server-Synchronized Time

The calendar is server-authoritative and synchronized between connected players.

Architects Time keeps calendar progression separate from simply reading Minecraft's celestial clock, allowing pack creators to build systems around a stable calendar rather than relying directly on raw world time.

Normal progression, sleeping, and supported time advancement are reflected by the calendar.

Administrative commands and the public API can also explicitly inspect or modify calendar time.

FTB Chunks Integration

FTB Chunks is optional.

When FTB Chunks is installed, Architects Time can provide synchronized calendar information beneath the FTB Chunks minimap.

The default minimap display uses three independently centered lines:

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

The displayed phase, season, week, weekday, and time use the same live synchronized calendar data as the standalone HUD.

The FTB Chunks component supports:

• Season coloring
• Season icons
• Minecraft clock icons
• Custom layout tokens
• Multiple lines
• Its own enable setting
• Its own layout override

The standalone Architects Time HUD and FTB Chunks minimap component can be enabled or disabled independently.

FTB Chunks remains responsible for component ordering, visibility, minimap placement, and font scaling.

Compatibility for Minecraft 1.21.1 was developed and tested against the NeoForge 2101.1.22 series.

Seasonal Crop Growth

Architects Time includes a data-driven seasonal growth framework for crops and other supported growing blocks.

Growth rules can classify crops as:

• Preferred
• Tolerated
• Out of Season
• Protected
• Unconfigured

The included recommended behavior allows crops to grow faster during their preferred season and more slowly outside it without destroying crops or permanently preventing progression.

Unconfigured crops retain their normal Minecraft behavior.

Seasonal growth rules can target individual blocks or tags and can be customized through datapacks.

Crop Protection and Compatibility

Architects Time does not implement its own greenhouse or crop-protection structure.

Instead, it exposes a protection API that other mods and pack-specific systems can use to tell Architects Time when a crop should be treated as protected from seasonal penalties.

This allows greenhouse systems, magical growing areas, machines, or other mechanics to integrate without Architects Time needing to own those systems itself.

Jade Integration

Jade is optional.

When Jade is installed, supported crops can display additional information such as:

• Seasonal classification
• Current growth multiplier
• Estimated time until maturity

Growth time can be displayed using Minecraft calendar time or an approximate real-time reference.

Because normal Minecraft crop growth uses random ticks, maturity information is presented as an estimate rather than an exact countdown.

KubeJS Integration

KubeJS is optional.

Architects Time exposes calendar and time functionality to KubeJS so modpack creators can use the active calendar in scripts and progression systems.

This can be used for systems such as:

• Seasonal events
• Quest requirements
• Scheduled progression
• Time-based unlocks
• Custom seasonal mechanics

KubeJS is not required for normal Architects Time functionality.

For Modpack Creators

Architects Time is built primarily as reusable infrastructure rather than as a calendar tied to one specific modpack.

Calendar definitions load from:

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

Seasonal growth rules load from:

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

The included standard calendar provides a complete working example.

Calendar periods can use custom resource-pack icons or existing Minecraft and modded item icons for HUD presentation.

Both the standalone HUD and FTB Chunks integration support customizable layout tokens.

Developer API

Architects Time exposes a supported Java integration API under:

com.silentvector.architectstime.api

The API includes systems for:

• Calendar snapshots
• Calendar transitions
• Time advancement
• Duration formatting
• Seasonal growth adapters
• Growth estimates
• Season protection providers
• Calendar events

Implementation packages outside the public API are considered internal and may change between releases.

Commands

Read-only Architects Time commands are available to players, while commands that modify calendar time require operator permissions.

Examples include:

• /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 names can be entered directly, such as:

/architectstime set season winter

This selects the first day of Winter.

An optional numeric argument selects a 1-based day within that season, so:

/architectstime set season winter 1

also selects the first day of Winter.

Additional debug commands are available for pack developers and server administrators.

Requirements and Compatibility

• Minecraft: 1.21.1
• Mod Loader: NeoForge 21.1 or newer
• Java: 21
• Environment: Client and Server
• Optional: FTB Chunks
• Optional: Jade 15 or newer
• Optional: KubeJS 2101.7 or newer

Architects Time must be installed on both the server and connecting clients.

FTB Chunks, Jade, and KubeJS are optional integrations and are not required for core Architects Time functionality.

Architects Time does not require Architects Core or another Architects module.

Updating from 0.1.0

Architects Time 0.1.1 is a direct compatible update from 0.1.0.

Existing:

• Public APIs
• Config keys
• Datapack formats
• Saved calendar data
• Network protocol
• Standalone HUD behavior

remain compatible with 0.1.0.

About the Project

Architects Time is developed by Silent Vector Studios.

The project is open source and is intended to provide a reusable time and season framework that mod developers and modpack creators can build on rather than requiring every pack to create its own calendar implementation.

Feedback, bug reports, integration ideas, and examples of unusual modded crops or time systems are especially useful as the public API and compatibility surface continue to grow.

Architects

Architects Time is part of the Architects family of projects, a collection of reusable tools, frameworks, and integrations intended to help modders and modpack creators connect and extend Minecraft systems without forcing everything into a single monolithic mod.

License

Architects Time is released under GPL-3.0-only.