Cinematic Time Skip
Large time advances can play a fullscreen animated overlay that runs through the days being skipped.
What it looks like
Section titled “What it looks like”The overlay fills the screen with an animated sky that tracks the in-world time of day across the skipped range. The sun sits where it belongs for the hour on screen. The opening frame matches the hour the skip started, and the closing frame matches the hour it ended. Stars twinkle, and shooting stars streak past at night. A date and time counter climbs toward the destination, and a progress bar at the bottom tracks how much of the skip has played.
The cinematic plays one panel per sampled date, so the more dates it samples the longer it runs. Short skips sample every day. The interval widens to weeks, then months, then seasons, then years as the skipped range grows, and the panel count is capped. Festival days get a panel of their own when event cards are turned on.
Weather, moon phases, and event cards are optional layers, each switched on separately on the settings page. The sky, sun, stars, and shooting stars always render.
The page card, season pill, moon strip, event cards, festival highlight, and progress bar take their colors from the active 3DS:ATLAS theme.
Triggers
Section titled “Triggers”The overlay plays when the cinematic system is on and a forward advance meets the threshold. The time jump buttons on the HUD and the Time Keeper run through that check, as does the /advance chat command. The MiniCal time jump buttons advance world time without it. Set the threshold on the settings page.
The Set Date dialog’s Cinematic Advance button plays the overlay without checking the threshold. That button appears only while the cinematic system is on.
Rest advances are governed by Trigger on Rest, not the threshold. With it on, any forward advance during a rest plays the overlay. Switched off, a rest never plays the cinematic, however far it pushes time. Trigger on Rest is disabled while Advance Time on Rest is off.
Rest integration covers the system’s long and short rests, Pathfinder 2e rests, and Pathfinder 1e rests.
Preview
Section titled “Preview”The Cinematics tab of the settings panel has a Preview Cinematic button. It plays a short skip forward from the current date on your screen only. World time does not move, and no other client sees the overlay.
Multiplayer
Section titled “Multiplayer”The animation plays on every connected client at once. A player can skip their own view with Escape or the Skip button. When you abort, all clients stop, and pausing and resuming reach every client too.
A player only sees cards for notes whose source page grants them OBSERVER permission or higher.
Playback controls
Section titled “Playback controls”Press Escape or click Skip to stop the cinematic. The time advance has already been applied, so aborting only skips the remaining animation.
You can hold the cinematic in place from a macro. CALENDARIA.api.pauseCinematic() freezes the animation with the overlay still on screen, and CALENDARIA.api.resumeCinematic() continues from the same point. See the API reference.