Chronicle
A vertical timeline viewer for calendar notes, festivals, season changes, moon phases, and weather history. It scrolls, respects fog of war, and updates live as state changes.
Opening the chronicle
Section titled “Opening the chronicle”- BigCal header button (if enabled in settings)
- MiniCal header button (if enabled in settings)
- HUD bar button (if enabled in settings)
- Right-click context menu on any widget (Open submenu)
- Scene controls toolbar button (if Chronicle is added to toolbar apps)
- Journal sidebar footer button
- Keybind (configurable, no default; see Keybinds)
- Automatically on world load (if “Show Chronicle” is enabled)
View modes
Section titled “View modes”Switch layouts using the view mode dropdown in the toolbar.
Scroll
Section titled “Scroll”Entries appear as a continuous vertical list. Each day with content shows its date, weekday, notes, and banners. Entries load as you scroll.
Timeline
Section titled “Timeline”A vertical spine layout with cards alternating left and right. Today’s entry is highlighted.
Entries
Section titled “Entries”Each entry represents a single day and can contain:
| Element | Description |
|---|---|
| Date | Formatted date and weekday name |
| Notes | Calendar notes with icon, color, title, and content |
| Festivals | Festival-linked notes highlighted with a festival indicator |
| Banners | Season changes, moon phase milestones, and weather history (see below) |
Banners
Section titled “Banners”Banners appear as inline markers within day entries:
- Season. Marks season transitions with the season’s icon and color.
- Moon Phase. Shows mid-phase milestones for each moon.
- Weather. Summarizes weather for past and current days.
Banners are hidden while the Category Filter is active.
Fog of war
Section titled “Fog of war”When Fog of War is enabled, unrevealed dates display as fogged placeholders. You always see full content regardless of fog state.
Depth modes
Section titled “Depth modes”Controls how much note content is shown. Set it via the depth dropdown in the toolbar or in settings. A user with note-creation permission sees an Add Note button on each entry when hovering.
| Mode | Description |
|---|---|
| Title Only | Note icon, color, and title only |
| Excerpts | Title plus a plain-text excerpt |
| Full | Title plus full rendered content |
Toolbar
Section titled “Toolbar”| Control | Description |
|---|---|
| Today | Reset date range and scroll to today’s entry |
| Show Empty Days | Toggle display of days with no notes or banners |
| Category Filter | Toggle visibility by note preset |
| Depth Dropdown | Switch between depth modes |
| View Mode | Switch between Scroll and Timeline layouts |
| Close | Close the Chronicle |
Right-click the toolbar to access:
| Option | Description |
|---|---|
| Settings | Opens the Chronicle settings tab |
| Open | Submenu to open other Calendaria widgets |
| Show to All / Hide from All | Toggle Chronicle visibility for all players (GM only) |
| Close | Close the Chronicle |
Live updates
Section titled “Live updates”The Chronicle refreshes when notes change, weather updates, the day advances, fog of war shifts, the active calendar switches, or settings change.
See API Reference for developer methods.