Chris' Tutorials
Docs/Calendar Time

Class

ClockGroup

Generated GDScript class reference for CalendarTime.ClockGroup.

StatusCurrent
Versionv2.0
UpdatedGenerated from GDScript addon source
Source note:This page rendered plugin-owned docs or generated metadata inside unified Astro docs shell.

ClockGroup — internal scaffolding for save/load coordination across multiple clocks. Owned by the TimeHost (constructed in _enter_tree from the host's clocks : Array[GameClock] export); not a separately-authored .tres. Holds an Array[GameClock] and provides:

  • save_all() / load_all(data) — namespaced save/load under save_key
  • advance_all(delta_microseconds) — pump engine delta into every clock each frame (the host calls this in _process) Not a save/load target itself: there's no advance_all_to_next_day() because "next day" is per-clock semantics — see GameClock.advance_to_next_day. Each clock defines its own "day" via its calendar; forcing independent timelines to share a "day" is the coupling multi-clock exists to avoid.

Source: addons/calendar_time/game_time/state/clock_group.gd

Syntax

class ClockGroup extends RefCounted

Members

NameKindSummary
clocksPropertyThe clocks this group aggregates. Order is preserved in save/load.
save_keyPropertyThe key under which this group's clock dicts are namespaced in the save dict. Defaults to `"clocks"` so a single-group game gets correct namespacing by default. Set to a per-group unique string when you have multiple `ClockGroup`s whose save dicts might be merged.
save_allMethod
nestedProperty
clockProperty
idProperty
id_strProperty
load_allMethod
nestedProperty
clocks_by_idProperty
clockProperty
advance_allMethod

Source

addons/calendar_time/game_time/state/clock_group.gd

Plugin docs root:gdscript/plugins/calendar_time_dev/docs