HUD

The HUD is a draggable bar showing the date, time, weather, and today’s events, with an animated sky drawn above or inside it.

Opening the HUD

Press Alt+C. Rebind it from Keybinds.
The HUD opens on world load when enabled in settings.
A HUD button in the Notes scene-controls toolbar toggles the HUD when the toolbar settings include it.
Double-click the bar to switch between fullsize and compact.

Options named on this page live on the Settings HUD tab unless another tab is given.

Modes

Mode	Bar
Fullsize	Holds a set width. Hiding a block frees space inside the bar.
Compact	Sizes to its contents. Hiding a block narrows the HUD.

Compact renders every indicator as an icon alone, whatever the display modes are set to. The display-mode dropdowns disappear from the settings tab while the HUD is compact.

Right-click the bar:

HUD Settings - Opens the HUD settings tab.
Show to All / Hide from All - GM only. Forces the HUD open for every player. The label reads “Show to All” while the HUD is not forced.
Reset Position - Returns the HUD to its default spot, centered near the top of the viewport.
Lock/Unlock Position - Toggles position locking.
Switch to Compact/Fullsize - Toggles between modes.
Open - Submenu listing the Calendaria widgets. Entries the user lacks view permission for are omitted.
Close - Closes the HUD.

Players lose Reset Position and Lock/Unlock Position while Lock HUD Position for Players is enabled. They lose Close while the HUD is forced.

Dial styles

Style	Description
Dome	Semi-circular sky above the bar, with the sun and moons riding an arc
Slice	Horizontal sky strip inside the bar, with the sun and moons traveling left to right

Compact mode always uses the slice.

Combat behavior

The HUD reads a per-user Combat Behavior dropdown. It adds two options beyond the set the other widgets share.

Option	Effect
None	No change during combat
Compact on Combat Start	Swap the dome for the slice dial when combat starts
Compact on Encounter Creation	Swap the dome for the slice dial when a combat encounter is created
Hide on Combat Start	Hide the HUD when combat starts
Hide on Encounter Creation	Hide the HUD when a combat encounter is created

The two compact options change the dial only. The HUD Mode setting is untouched, so the bar keeps its fullsize layout and returns to the dome when combat ends.

“On Encounter” modes fire when an encounter is created in the tracker, before Start Combat is pressed, and “On Combat” modes only when combat starts.

Other widgets share None, Hide on Combat Start, and Hide on Encounter Creation. All of them restore when combat ends.

Sky display

Sky, sun, moons, stars, and weather particles draw in one animated canvas.

The sky crossfades through color keyframes over the day. The sun arcs across during daylight with a corona pulse, and the moons take over at night. Stars twinkle and fade around twilight.

Moons

Moons render their current phase with a curved terminator, and each takes its color glow from the calendar configuration. With Show All Moons enabled the extra moons trail behind the leading one at a reduced size; otherwise only the leading moon draws.

Weather particles

Weather conditions render as particles over the sky. Each weather preset maps to its own particle behavior; see Weather Presets for the list. Wind speed and direction steer the particles, and a weather effect can override the sky gradient.

The Weather Effects dropdown thins or removes the particles without touching the sky, sun, moons, or stars.

Particle rendering also follows Foundry’s core performance mode:

Performance mode	Result
Low	No weather particles
Medium	Reduced particle count
High / Maximum	Full particle count

Star twinkle and the sun’s corona pulse render only on High or Maximum.

Dome placement

Dome Below Bar draws the dome under the info bar instead of above it. Dome Auto-Hide fades the dome as the HUD nears the top of the viewport and hides it once the space runs out.

Sun Dial

Click the dome or slice to open the Sun Dial. This needs the Change Date/Time permission; for everyone else the dome is view-only. Opened this way, a click outside the dial closes it. Escape closes the dial however it was opened.

Non-standard time

The Sun Dial and hour markers scale to the calendar’s hours per day.
Sunrise and sunset positions come from the calendar’s daylight settings.
Time displays respect the calendar’s minutes per hour and seconds per minute.
On a monthless calendar the increment dropdown omits Month.

Info bar

Bar contents, left to right:

Note Viewer button - Opens the Note Viewer. Hidden without the View Note Viewer permission.
Add Note button - Creates a note at the current game time.
Chronicle button - Opens Chronicle. Hidden unless enabled on the Settings Chronicle tab.
Events - Icons for today’s notes; click one to open the note. At most five icons appear. Days with more notes show the first five; the rest are reachable from the Note Viewer.
Date - Click to open the Set Date dialog (Change Date/Time permission). With secondary calendars configured for equivalent dates, hovering the date shows the same day in each of them.
Time - Current time. Hovering reveals a play/pause button (Change Date/Time permission).
Weather - Current weather; click to open the weather picker (Change Weather permission). A “click to generate” prompt stands in when no weather is set. With Intraday Weather enabled, hovering shows a per-period breakdown with the active period highlighted.
Season - Current season name and icon.
Era - Current era.
Cycle - Current cycle value.
Open Calendar - Opens BigCal or MiniCal per the Calendar Button setting. Hidden when the user lacks view permission.
Settings - Opens the settings panel.

Weather, season, era, and cycle each have their own visibility toggle in settings.

With Event Border Glow enabled, the bar border takes the color of the first event on the current day. Disabling it removes the glow and leaves the event icons, tooltips, and note actions.

Time controls

Hover the HUD to reveal the tray. It renders only for a user with the Change Date/Time permission.

Button	Action
Sunrise	Advance to the next sunrise
Midday	Advance to solar noon
Custom Dec 2, Dec 1	Jump backward by a custom amount
Reverse	Step backward by one increment
Increment dropdown	Set the step size: second, round, minute, hour, day, week, month, season, year
Forward	Step forward by one increment
Custom Inc 1, Inc 2	Jump forward by a custom amount
Sunset	Advance to the next sunset
Midnight	Advance to the next midnight

Scroll the mouse wheel over the dropdown to cycle increments. Scrolling over the time display does the same in the opposite direction. The increment you pick is saved for your user and restored on the next load.

Custom jump buttons carry their own values per increment type, two backward and two forward. A button with no value set does not render.

The tray opens above or below the bar, set by Tray Open Direction.

Play and pause

Hover the time display to reveal the play/pause button; the time dims behind it. In slice mode, hovering anywhere on the slice reveals it. The button stops the real-time clock without disabling the feature.

Clock lock

Shift-click the play/pause button on the HUD, MiniCal, Time Keeper, or Sun Dial to lock the clock. While locked:

Time advancement is blocked, including the manual toggle, real-time sync, combat time, and rest advancement.
The button shows a lock icon.
The lock persists across a page refresh as a world setting.

Shift-click again to unlock. Locking needs the Change Date/Time permission.

Clock sync

The real-time clock follows game state:

Pause - The clock stops when the game is paused and resumes when the game resumes.
Combat - The clock stops while combat is running, and time advances per turn through the system.

Starting the clock by hand while pause or combat is blocking it shows a warning. Both behaviors are configured on the Settings Time tab.

Positioning

To move the HUD, drag the info bar. Position is saved per user.

Sticky zones

Drag the HUD near one of these zones to snap it into place:

Zone	Location
Top Center	Centered at the top of the viewport
Above the Hotbar	Above the macro hotbar
Above the Players list	Above the players list
Below the Scene Controls	Below the scene controls

The bar wobbles while a zone is in range; release to snap. Position survives a switch between display modes. The above-hotbar zone tracks the hotbar’s current position. Sticky zones are toggled on the Settings Canvas tab.

Locking and docking

Enable Lock Position in settings, or use Lock/Unlock Position in the context menu, to stop the HUD being dragged. Reset Position also appears on the settings HUD tab.

Lock HUD Position for Players stops players dragging or unlocking their HUD. Force HUD Dock for Players docks every player’s HUD into one zone and overrides their saved position. It offers Top Center, Above the Hotbar, and Below the Scene Controls, so the above-players zone stays reachable only by dragging. Neither setting touches your own HUD.

Auto-fade

With Auto-Fade When Idle enabled, the HUD fades to the idle opacity a short while after the pointer leaves and returns to full opacity on hover.

Player permissions

A player with the View HUD permission sees the date, time, weather, and today’s events.

Without Change Date/Time, the tray does not render, the date is not clickable, and the play/pause button is absent.
Without Change Weather, the weather block is not clickable.
Without Add Notes, the Add Note button still renders and shows a permission warning when clicked.

See Permissions for role defaults.

Per-scene visibility

Scene Configuration > Calendaria tab > Hide HUD for Players closes the HUD for players when that scene becomes active. Moving to a scene without the flag restores it for players who have the HUD enabled on load. Your own HUD is unaffected.