Cloudy Time

Cloudy Time is a configurable game clock and calendar system for Unity. Developers define their own time units, months, weekdays, and seasons, and Cloudy Time runs the resulting calendar as a hybrid real-time and manual clock with built-in event and scheduling support.

Features:

- Configurable calendar with custom unit hierarchies, variable-length months, custom weekdays, optional seasons, and custom starting dates and era labels.

- Hybrid clock supporting real-time advancement with adjustable time scale, pause and resume, manual jumps, and advancement by days, hours, or arbitrary durations.

- Full arithmetic engine including AddDays, AddMonths, AddYears, AddHours, AddTicks, date subtraction returning durations, and comparison operators. Variable month lengths are handled correctly, and AddMonths clamps to the target month length.

- Boundary events for minute, hour, day, week, month, season, and year transitions. Each event fires at most once per clock advancement regardless of how many units are crossed.

- Scheduler for one-shot callbacks at any future GameDateTime. Callbacks are cancellable by handle, fire on both real-time and manual advancement, and use callback-safe iteration.

- Multi-clock support with multiple named clocks per scene and a default clock for the static CloudyTime facade.

- Custom editor tools including a Calendar Definition inspector with paged month preview, weekday alignment, season tinting, click-to-inspect day cells, validation panel, and test-date resolver. The Cloudy Clock inspector includes a live readout, time scale presets, and manual advance buttons.

- Save and restore support via a serializable ClockState struct compatible with any save system.

- Three sample calendars included: Earth standard, 13-month fantasy, and centisecond-based sci-fi.

Requirements:

- Unity 6 or higher.

- No third-party dependencies.

Cloudy Time is the first module of the Cloudy Suite by Clouds of Steel Studios. It is fully standalone and runs independently in any project. Other Cloudy modules integrate with Cloudy Time automatically when both are present.