Sun Dial
A circular floating clock with an animated sky. You drag the sun to set the time of day.
Opening the sun dial
Section titled “Opening the sun dial”- Click the HUD dome (closes when clicking outside the dial)
- Toolbar button (if enabled in Settings Panel > Module tab > Toolbar Apps)
- Journal footer button (if enabled)
- Settings Panel > Sun Dial tab (click the “Open Sun Dial” button)
- On world load (if “Show Sun Dial on Load” is enabled)
- The API:
CALENDARIA.api.showSunDial()
Display
Section titled “Display”An animated sky sits inside a circular frame with hour markers around the edge. The sky matches the current time of day: blue sky and sun during the day, stars at night.
A draggable sun handle sits on the dial edge at the current hour. Drag clockwise or counterclockwise to change the time. Time updates as you drag and applies on release.
Time input
Section titled “Time input”The time input below the dial shows the current time. Edit it directly to set a specific time.
Resize
Section titled “Resize”Drag the bottom-right handle to resize the Sun Dial.
Hover controls
Section titled “Hover controls”Hovering the Sun Dial reveals control buttons:
| Button | Action |
|---|---|
| Play/Pause | Toggle the real-time clock |
| Create Note | Create a note at the current date and time |
| Settings | Open the Settings Panel |
Crank mode
Section titled “Crank mode”Drag the sun handle past midnight for fast multi-day time changes.
- Each pass over midnight adds a day, or subtracts one when dragging counterclockwise
- A day-offset indicator above the time input shows the total
- On release, accumulated days and final time apply together
- Right-click while dragging to cancel the adjustment
- Enable it from the context menu or Settings Panel > Sun Dial tab
Context menu
Section titled “Context menu”Right-click the Sun Dial to access:
| Option | Description |
|---|---|
| Enable/Disable Crank Mode | Toggle Crank Mode for this user |
| Reset Position | Reset to default position and clear sticky zone |
| Lock/Unlock Position | Toggle position locking |
| Show to All / Hide from All | Toggle forced visibility for all players (GM only) |
| Open | Submenu to open any of the other Calendaria apps |
| Close | Close the Sun Dial |
Positioning
Section titled “Positioning”Dragging
Section titled “Dragging”Drag the Sun Dial by its frame to reposition it.
Sticky zones
Section titled “Sticky zones”The Sun Dial snaps to predefined screen positions when dragged nearby. See HUD > Sticky Zones for zone locations.