AgeService

AgeService — a Resource that advances an AgeState as game time progresses. Bound to a GameClock; the scene-tree AgeComponent reads its progress. Drive modes (see AgeSettings.UpdateTime):

• GAME_TIME_ELAPSED — advance per clock.signal_bus.game_seconds_advanced (sum of game seconds the clock moved).
• DATE_CHANGED — advance once per day boundary crossed, by the full day's game seconds (so day-aligned ageing doesn't drift from sub-day frames).
• REAL_TIME_ELAPSED — not supported on a Resource service. A scene-tree wrapper would be required to drive a per-frame tick. Configuring this mode produces a validation error and the service stays idle. Use GAME_TIME_ELAPSED or DATE_CHANGED instead. Owned by the clock (clock.age_service). One age service per clock.

Source: addons/calendar_time/ageing/age_service.gd

Syntax

class AgeService extends Resource

Members

Name	Kind	Summary
service_id	Property	Unique identifier for this service instance. Used for serialization (see Keys.SERVICE_ID) and for routing debug output. Setter re-registers the AgeState in `clock.age_registry` under the new key (and rebinds `main_age_id`) so changing the id post-construction keeps the registry in sync. Set BEFORE passing the service to consumers to avoid two services with the same default id colliding on a single clock's registry.
registry	Property
old_state_id	Property
old_state	Property
new_state	Property
starting_age	Property	Where the age service tells about changes to the age
age_settings	Property	Defines how ageing operates inside the service
clock	Property	The clock the service ages with. Subscribes to its bus for time_elapsed / date_changed. Set by the clock (clock.age_service setter wires `clock = self`). Setter also ensures the state is registered in `clock.age_registry` under `service_id`. This handles the `.tres`-load case where _init runs without a clock (the .tres has no clock ref), then the GameClock.age_service setter wires `clock = self` — at which point we register the state in the just-assigned clock's registry.
registry	Property
age_state_id	Property
seconds_change	Property
progress_age	Method
change_in_units	Property
change_in_age	Property
registry	Property
state	Property
scale	Property
seconds_to_game_units	Method
validate	Method
ok	Property
to_dict	Method
from_dict	Method
data	Property
SCHEMA_VERSION	Field	Bumped when an on-disk key changes shape. v2 stored service identity under the key "id"; v3 stores it under "service_id".
SERVICE_ID	Field	Schema v3 key. Written by to_dict().
AGE_STATE_ID	Field
LEGACY_ID	Field	Legacy v1/v2 key. Read-only — from_dict() auto-migrates it to SERVICE_ID when no SERVICE_ID is present. See MIGRATION.md §5.
get_keys	Method