Sun Dial
Circular floating clock with an animated sky. GMs 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 > Advanced > Toolbar Apps)
- Journal footer button (if enabled)
- Settings Panel > Calendar tab
- On world load (if “Show Sun Dial on Load” is enabled)
- Use the API:
CALENDARIA.api.showSunDial()
Display
Section titled “Display”Animated sky inside a circular frame with hour markers around the edge. Sky reflects 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 time. Time updates as you drag and applies on release.
Time Input
Section titled “Time Input”Time input below the dial shows current time. Edit 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 over 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”Fast multi-day time changes by dragging the sun handle past midnight.
- Each time you drag past midnight, a day is added (or subtracted when dragging counterclockwise)
- Day-offset indicator above the time input shows the total (e.g., “+2 days”)
- On release, accumulated days and final time apply together
- Right-click while dragging to cancel the adjustment
- Enable via the context menu or Settings Panel > Sun Dial tab
Context Menu
Section titled “Context Menu”Right-click the Sun Dial to access:
| Option | Description |
|---|---|
| Settings | Opens the Settings Panel to the Sun Dial tab |
| Show/Hide to All Players | Toggle visibility for all players (GM only) |
| Enable/Disable Crank Mode | Toggle Crank Mode for this user |
| Lock/Unlock Position | Toggle position locking |
| Reset Position | Reset to default position and clear sticky zone |
| 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”Snaps to predefined screen positions when dragged nearby. See HUD > Sticky Zones for zone locations.