Settings

Access via Settings > Module Settings > Calendaria > Calendaria Settings.

Settings are split across tabs. GM-only tabs are marked below and are not shown to a player.

Settings Navigation

The sidebar lists Home on its own, then three groups. Calendar holds Notes, Time, Weather and Fog of War. Technical holds Macros, Chat, Permissions, Canvas, Module and Cinematics. Apps holds BigCal, MiniCal, HUD, Chronicle, Time Keeper, Stop Watch and Sun Dial.

The window header carries a Toggle Navigation control that collapses the sidebar to icons and restores it.

Searching settings

Search input at the top of the sidebar.

Type 2+ characters to see matching results
Results match setting labels, hints, and section headings
Click a result to switch tab, scroll, and highlight the target
Press Escape or click outside to dismiss

Per-section reset buttons

Most sections have a reset button in the fieldset legend. Clicking it shows a confirmation dialog listing the affected settings before resetting them to defaults. Sections on the Home, Notes and Macros tabs have no reset button, and on the Weather tab only Units does.

A section reset applies only settings the current user can change. For a player, the dialog lists only their per-user settings and world settings stay untouched.

Home

The first tab, visible to all users. Calendar-management buttons are GM only.

Recently Changed

Lists up to ten settings you changed in the past week, each with how long ago it was changed. Clicking an entry switches to that setting’s tab and scrolls to it. The section is hidden when nothing qualifies.

Active Calendar

Select which calendar system to use. Changing this requires a world reload.

Default: gregorian

On PF2E and SF2E worlds, the picker tags calendars lacking a metadata.luxonSync.theme with a “likely incompatible” suffix and shows a warning banner. The active calendar’s date theme syncs to the system World Clock when compatible. When it is not, the in-system Show Clock button is hidden.

Open Calendar Editor

GM only. Launches the Calendar Editor for creating and modifying calendars.

Open Importer

GM only. Opens the calendar importer for Simple Calendar, Fantasy Calendar, and other formats.

Set Date & Time

GM only. Opens a dialog to set the world date and time directly.

Equivalent Date Calendars

GM only. Select which loaded calendars display as cross-calendar equivalents in day tooltips, note sheets, and calendar headers. Leave the selection empty to disable cross-calendar display.

See Secondary Calendar for more on multi-calendar support.

Permissions (GM Only)

Configure which user roles can access Calendaria features.

Available permissions

Permission	Description
View BigCal	Can see the BigCal
View MiniCal	Can see the MiniCal widget
View HUD	Can see the HUD
View Time Keeper	Can see the Time Keeper
View Sun Dial	Can see the Sun Dial
View Chronicle	Can see the Chronicle
View Stopwatch	Can see the Stop Watch
View Note Viewer	Can open the Note Viewer
Add Notes	Can create own calendar notes
Delete Notes	Can delete own calendar notes
Change Date/Time	Can modify the world date and time
Change Weather	Can set weather conditions
View Weather Forecast	Can view weather forecasts and day-cell forecast icons
Change Active Calendar	Can switch the active calendar
Edit Calendars	Can access the Calendar Editor

See Permissions for detailed documentation.

Player Visibility

Hide Moons from Players

Hide all moon displays from players. Moon phase icons disappear from the MiniCal, BigCal, Chronicle, HUD dome, and Sun Dial. Moon icons are stripped from formatted dates. GMs always see moons.

Default: false

Notes (GM Only)

Manage Presets

Opens the Note Preset Editor for managing note presets.

Re-create Missing Festival Notes

Regenerates festival journal notes from the current calendar’s festival definitions. Creates missing festival notes or restores deleted ones. Existing notes are not duplicated.

Default Note Settings

Default Note Category

Category applied automatically to notes created from the UI. Choose “Ask Every Time” to open a category picker for each new note.

Default: none

Note Open Mode

Controls how existing notes open by default when clicked.

Options: Default, Edit, View
Default: Default

When set to Edit or View, notes always open in that mode. New notes always open in Edit mode regardless of this setting.

Show Secret Notes

Show notes with Secret visibility on your calendar views. Secret notes stay hidden from players either way.

Default: false

Enricher Reference

Button that creates a reference journal entry listing every text enricher with a live example, then opens it. Re-using the button re-opens the existing entry.

Time (GM Only)

Advance Time on Rest

Advance world time when players take short or long rests. Long rests use the Long Rest Advance Mode and Rest Hours settings; short rests use the Short Rest Advance Mode and Short Rest Minutes settings.

Advances run on the primary GM only
Default: false

Real-Time Clock Speed

Configure how fast the in-game clock advances in real-time mode.

World Time per Real Second: How many units pass per real second
Time Speed Unit: What time unit advances, from second through year
Default: 1 second per second

Setting the multiplier to 0 disables automatic time advancement. A lock icon with “Clock Disabled” tooltip appears on all play/pause buttons. Manual forward/reverse time jumps and rest-based advancement still work.

Update Interval

How frequently the time system processes updates, in seconds.

Range: 1 to 120
Default: 60

Long Rest Advance Mode

How long rests advance time. Short rests are governed by Short Rest Advance Mode below.

Automatic (default): Advance by the duration the active system reports. PF1E uses the rest dialog hours, dnd5e uses the rest variant duration, PF2E uses 8 hours. If the system reports no duration, time does not advance.
8 AM: Skip to 8 AM the next day.
Sunrise: Skip to the zone’s sunrise hour, falling back to 8 AM if not configured.
Custom: Advance a fixed number of hours set via Rest Hours.

Rest Hours

Number of hours to advance on a long rest when Long Rest Advance Mode is set to Custom. Set to 0 to suppress time advancement entirely while still firing the rest hook.

Minimum: 0
Default: 8

Short Rest Advance Mode

How short rests advance time.

Automatic: Advance by the duration the active system reports for the short rest. If the system reports no duration, time does not advance.
Custom (default): Advance a fixed number of minutes set via Short Rest Minutes.

Short Rest Minutes

Number of minutes to advance on a short rest when Short Rest Advance Mode is set to Custom. Set to 0 to suppress time advancement entirely while still firing the rest hook.

Minimum: 0
Default: 60

Advance Bastion Orders (dnd5e only)

Automatically advance dnd5e bastion facility orders as world time passes. When enough days elapse since the last advance, using the duration configured in the dnd5e Bastion Configuration menu, every player character’s active facility orders tick forward. Large time jumps collapse into a single advance covering the full span.

While this setting is on, the dnd5e Advance Bastion Turn button advances the world clock by one turn’s duration after a confirmation prompt instead of only ticking progress.

Only visible in dnd5e worlds
Requires Bastion Configuration → Enabled on the dnd5e side
Default: true
Automatic advances run on the Primary GM only
Respects Clock Locked. Locked clocks block both automatic and button-triggered advances

Sync Clock with Game Pause

The clock stops when the game is paused and restarts when the game resumes. It also restarts the clock when combat ends. Combat itself stops the clock through Run Clock During Combat, independently of this setting.

Default: false

Run Clock During Combat

When enabled, the real-time clock continues running during active combat. The system’s per-round time delta is blocked to prevent double-advancement.

Default: false

When the active system sets combat round time to zero, the tab shows a warning that time will not advance automatically during combat. Round length comes from the system; Calendaria does not set it.

Weather (GM Only)

Weather Generation

Auto-Generate Weather

Generate weather on day change based on climate zone and season configuration. The toggle is a world setting. It is not stored on the calendar and it does not change when you switch the active calendar.

Default: false

Weather Inertia

Controls how strongly the current weather influences the next day’s generation. Higher values produce smoother transitions.

Range: 0 to 1
Default: 0.3

Weather History Days

Maximum number of days of weather history to retain.

Range: 0 to 3650
Default: 365

Sound Effects

Enable ambient weather sound loops tied to weather presets. Takes effect immediately.

Default: false

Sound Volume

Controls weather ambient sound volume. The playing loop fades to the new level as you move the slider.

Range: 0 to 1 (step 0.05)
Default: 0.5

Suppression Muffle

Fraction of the weather Sound Volume retained while the user’s controlled or owned token is inside a core Suppress Weather region. At 0 the ambient sound is silenced completely; higher values leave it audible but quieter.

Range: 0 to 1
Default: 0

Intraday Weather

4-period intraday weather system (Night, Morning, Afternoon, Evening). Each time-of-day period can have different weather, with transitions at sunrise, midday, sunset, and midnight.

Default: false

Period Carry-Over Chance

Controls how often weather persists unchanged between intraday periods. Higher values mean weather is more likely to stay the same across period transitions. Applies only when Intraday Weather is enabled.

Range: 0 to 100 (percentage)
Default: 50

Forecast

Forecast Accuracy

How accurately forecasts predict future weather for non-GM users. GMs always see the true forecast.

Range: 0 to 100
Default: 70

Forecast Days

Number of days to pre-generate in the forecast plan.

Range: 1 to 30
Default: 7

GM Override Affects Forecast

When enabled, manually setting weather via the Weather Picker clears and regenerates the forecast plan for that zone.

Default: true

Regenerate Forecast

Clears and rebuilds weather forecasts for all climate zones. Confirmation dialog shown before proceeding.

Climate Configuration

Climate zones are configured in the Calendar Editor; a button opens it here.

Active Climate Zone

Selects which climate zone drives weather generation. Only shown when the active calendar defines climate zones. Scenes with a Climate Zone Override use their own zone instead.

FXMaster Integration

The section is always listed. Without FXMaster installed and active it shows a notice in place of the settings.

Enable Weather FX

Global toggle for FXMaster particle weather effects. When disabled, stops all FXMaster weather effects unless a scene’s Weather FX Override is set to On.

Default: false

Top-Down Mode

Render FXMaster weather effects from a top-down perspective.

Default: false

Force Downward Weather

Clamps FXMaster weather particle angles to ±45° from vertical so weather always falls from above. Suits side-view scenes where diagonal particles look unnatural.

Default: false

Below Tokens

Render FXMaster weather effects below the token layer.

Default: false

Weather Effect Speed

Scale FXMaster particle speed for all Calendaria weather. A value of 1 preserves preset speeds, 0 freezes particles, 2 doubles speed. Changes apply to the active scene immediately without waiting for the next weather tick.

Range: 0 to 3 (step 0.1)
Default: 1

Below Tiles

Render FXMaster weather effects below the tile layer.

Default: false

Below Foreground

Render FXMaster weather effects below the foreground image.

Default: false

FXMaster Sound Effects

Play the sound attached to the active FXMaster weather effect.

Default: false

Particle Splash

Render a ground splash where rain and snow particles land. Disable for scenes with no ground plane.

Default: true

Activate by Darkness

Show FXMaster weather effects only when scene darkness falls within the Darkness Minimum to Darkness Maximum range.

Default: false

Darkness Minimum

Lowest scene darkness at which weather effects appear. The slider appears only while Activate by Darkness is checked.

Range: 0 to 1 (step 0.05)
Default: 0

Darkness Maximum

Highest scene darkness at which weather effects appear. The slider appears only while Activate by Darkness is checked.

Range: 0 to 1 (step 0.05)
Default: 1

Units

Temperature

Choose temperature display format.

Options: Celsius, Fahrenheit
Default: Celsius

Show Both Temperature Units

Display both Celsius and Fahrenheit side by side in weather pills and tooltips.

Default: false

Precipitation

Choose precipitation display format.

Options: Millimeters/Hour, Inches/Hour
Default: Millimeters/Hour

Wind Speed

Choose wind speed display format.

Options: Kilometers/Hour, Miles/Hour
Default: Kilometers/Hour

Weather Editor

Button to open the Weather Editor for customizing preset visuals, sounds, and FXMaster mappings.

Weather Probabilities

Button to open the Weather Probability dialog. Only visible when climate zones are configured. Shows effective weight breakdown per preset for the selected zone and season.

Canvas (GM Only)

Scene Integration

Sync Scene Darkness with Time

Adjust scene darkness based on time of day.

Default: false

Sync All Scenes

Sync darkness across all scenes, not only the active one.

Default: false

Weather Affects Darkness

Adjust scene darkness based on current weather conditions.

Default: false

Sync Scene Ambience with Weather

Update scene environment lighting (hue/saturation) based on weather and climate zone.

Default: false

Sync Scene Ambience with Time of Day

Shift scene ambient color based on time of day, with warm tones at dawn and dusk and cool blue at night. Requires “Sync Scene Ambience with Weather” to be enabled.

Default: false

Moon Illumination

Allow moon phases to reduce nighttime darkness. Per-moon brightness is configured in Calendar Editor.

Default: false

Default Brightness

Global brightness multiplier for scene ambience.

Range: 0.5 to 1.5
Default: 1.0

Time of Day Hue Intensity

Multiplier for dawn, dusk, and night hue strength applied to scene environment lighting. 1 keeps the subtle baseline; higher values produce stronger sunsets and bluer nights. Applies to synced scenes immediately.

Range: 0 to 6 (step 0.25)
Default: 1

Weather Hue Override

How strongly weather hue overrides time-of-day hue. 1 lets weather hue fully replace time-of-day hue; 0 keeps dawn and dusk hue visible underneath weather; intermediate values blend the two. Applies to synced scenes immediately.

Range: 0 to 1 (step 0.1)
Default: 1

Sticky Zones

Enable Sticky Zones

Allow draggable windows (HUD, MiniCal, Time Keeper) to snap to predefined positions:

top-center: Centered at top of viewport
above-hotbar: Above the macro hotbar
above-players: Above the players list
below-controls: Below the scene controls
Default: true

Let snapped windows overlap the sidebar instead of stopping at its edge.

Default: false

Chronicle

Visible to any user with the View Chronicle permission.

Chronicle timeline viewer settings.

Open / Close / Reset

Buttons to open or close the Chronicle directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Show Chronicle on Load

Show the Chronicle on world load.

Default: false

Force Display for All (GM Only)

Prevents players from closing the Chronicle. Turning it on also shows the Chronicle for everyone.

Default: false

Chronicle Buttons (GM Only)

Three toggles that add a Chronicle button to BigCal, MiniCal, and the HUD.

Default: all false

Entry Detail Level

Controls how much content is shown for each entry in the Chronicle.

Title Only: Only note titles
Excerpts: Title with a short text preview
Full: Title with full note content
Collapsible: Title that expands to full content on click
Default: Excerpts

Content

Toggle which content types appear in the Chronicle:

Show Weather: Display historical weather entries
Show Season Changes: Display season transition banners

Weekly Almanac (GM Only)

Publish an almanac page to a shared journal at the start of each in-world week. The page covers the past week’s weather, the coming forecast, moon phases, and scheduled notes. See Weekly Almanac.

Default: false

Show Empty Days

Include days with no entries in the Chronicle timeline.

Default: false

Count as Not Empty

Multi-select setting controlling which banner types count as content when determining whether a day has entries. When Show Empty Days is toggled off, days with only unchecked banner types are treated as empty. The selection is greyed out while Show Empty Days is on.

Weather: Weather history banners
Moon Phases: Moon phase milestone banners
Season Changes: Season transition banners

By default, all banner types count as content.

Combat Behavior

Controls Chronicle behavior during combat. See HUD > Combat Behavior for option details.

Default: None

The Chronicle toolbar’s active category selection is stored per-client in the chronicleCategoryFilter setting as a set of preset IDs. The selection persists across sessions.

Fog of War (GM Only)

Fog of War progressive calendar revelation system.

Enable Fog of War

Master toggle. When enabled, players only see dates the GM has explicitly revealed.

Default: false

Campaign Start Date

Set the year, month and day. Dates before the start date are always fogged. Setting a start date creates an initial revealed range from that date to the current date. Leave the fields blank to disable the start date.

Auto-Reveal Current Day

Reveal dates as the calendar advances forward.

Default: true

Reveal Radius

Number of days to reveal around the current date when auto-reveal triggers.

Range: 0 to 30
Default: 0

Reveal Intermediate Days

When advancing multiple days at once, reveal all intermediate days between the previous and new date, not only the landing date.

Default: true

Controls how players move through fogged calendars.

Skip Fogged Months (skip, default): Previous and next buttons skip over fully-fogged months and are disabled at fogged boundaries when no revealed month exists in that direction
Free Navigation (normal): Players move freely without fog-based restrictions

Clear All Revealed Ranges

Clears all revealed ranges and re-creates the initial range from the campaign start date. Asks for confirmation first. Clearing cannot be undone.

Cinematics (GM Only)

Cinematic Time Skip fullscreen animation overlay.

Enable Cinematic Time Skip

Master toggle for the cinematic time skip overlay. The Threshold, Trigger on Rest, Animation and Content controls stay inert until this toggle is on.

Default: false

Threshold

Number of threshold units a time advance must reach to trigger the cinematic. Smaller advances play without it.

Minimum: 1
Default: 1

Threshold Unit

Unit for the threshold value.

Options: Hour, Day, Week, Month, Season, Year
Default: Week

Panel Duration

How long each intermediate day panel shows during the animation.

Range: 1000 to 6000 (milliseconds)
Default: 3000

Content Toggles

Toggle which content the animation includes. The sky, stars, sun, and shooting star animation elements always render.

Show Weather: Weather and season visual transitions. Default: false
Show Moon Phases: Moon phase orbs with trailing arcs. Default: false
Show Events: Note title cards displayed during the animation. Default: false

Event Weighting

Controls how prominently events are featured in the cinematic display.

Options: All Events (all), Festivals Only (festivals-only), Weighted (Festivals First) (weighted)
Default: All Events

Max Event Cards

Maximum number of note title cards shown during the animation. Applies only when Show Events is enabled.

Range: 1 to 20
Default: 8

Trigger on Rest

When enabled, rest-based time advances trigger the cinematic regardless of the threshold setting. Disabled unless Advance Time on Rest is enabled on the Time tab.

Default: false

Rest integration supports D&D 5e long and short rests, Pathfinder 2e rests, and Pathfinder 1e long rests.

Preview

Button at the bottom of the tab that plays the cinematic overlay with the current settings.

Module

Visible to all users. Players see the UI Integration and About sections; other sections are GM only.

The primary GM is set in 3DS:ATLAS. Calendaria has no primary GM setting of its own.

UI Integration

Visible to all users. Every setting except Enricher Click Target is GM only. Changing Show Toolbar Buttons, Toolbar Apps or Show Journal Footer prompts for a world reload.

Master toggle for toolbar button visibility.

Default: true

Icon checkboxes for which apps appear in the toolbar. Every checkbox is greyed out while Show Toolbar Buttons is off.

BigCal
MiniCal
HUD
Time Keeper
Sun Dial
Stop Watch
Chronicle
Default: MiniCal only

Replaces Journal sidebar footer with app toggle buttons.

Default: false

Enricher Click Target

Per-user setting controlling which calendar view opens when clicking a date link created by a text enricher. Auto-Detect opens MiniCal only when MiniCal is open and BigCal is not. In every other case it opens BigCal.

Options: Auto-Detect, MiniCal, BigCal
Default: Auto-Detect

Debugging

GM only.

Developer Mode

Enable developer features such as calendar journal deletion and sticky zone visualization.

Default: false

Console logging level and the bug-report export live in the 3DS:ATLAS troubleshooter.

Backup & Transfer

GM only.

Export Settings

Downloads all settings as JSON for backup or transfer between worlds. The export dialog offers one option when a calendar is active:

Include active calendar: When checked, exports the active calendar data, its festival seeds, and any custom note presets it references, along with settings. The exported file can then be used with the Calendar Importer or Import Settings.

Import Settings

Opens a file picker, then shows an import dialog with options (when the file contains calendar data or notes):

Import calendar: Import the embedded calendar data as a custom calendar
Set as active calendar: Automatically switch to the imported calendar
Import notes: Import the embedded calendar notes

Print / Export

GM only. Opens the browser print dialog. Save as PDF to export.

Print Current Month prints a full-page month grid.
Print Current Year prints every month, one page each.

About

Module version, author, and translator credits, plus links to Ko-fi, Discord, GitHub, Report Bug, and this wiki.

Macros (GM Only)

Add Trigger appends a row to a trigger list; the trash button removes one.

Time-Based Triggers

Assign macros to run at specific times:

Dawn: Sunrise
Dusk: Sunset
Midday: Noon
Midnight: Midnight
New Day: Day change

Season Triggers

Assign macros to run when specific seasons begin. Supports “All Seasons” for any season change. When the active calendar defines no seasons, the section reads “No seasons configured in the active calendar.”

Moon Phase Triggers

Assign macros to run on specific moon phases. Configure by moon and phase, or use “All Moons”/“All Phases” wildcards. When the active calendar defines no moons, the section reads “No moons configured in the active calendar.”

Chat (GM Only)

Chat Message Timestamps

How to display in-game time on chat messages.

Disabled: No in-game timestamps
Replace Real Time: Replace real-world time with in-game time
Augment (Show Both): Add the in-game date as a banner below the message
Default: Disabled

Display Formats

Format for the in-game timestamp shown on chat messages. Separate GM and player formats with live preview. Whether the timestamp includes a time of day depends on the tokens you put in the format.

Text Enrichers

Opens the same enricher reference journal entry as the Notes tab.

HUD

Visible to any user with the View HUD permission.

Open / Close / Reset Position

Buttons to open or close the HUD directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Display Options

Show HUD on Load

Show the HUD on world load.

Default: true

Force Display for All (GM Only)

Prevents players from closing the HUD. Turning it on also shows the HUD for everyone.

Default: false

Lock HUD Position for Players (GM Only)

Lock every player’s HUD in place and hide their move and reset controls. GM HUDs are unaffected.

Default: false

Force HUD Dock for Players (GM Only)

Docks every player’s HUD into a fixed zone. Your own HUD is unaffected.

Options: Not Forced, Top Center, Above the Hotbar, Below the Scene Controls
Default: Not Forced

Calendar HUD Display Mode

Fullsize: Full HUD display with dome/slice dial
Compact: Condensed bar display (forces slice dial)
Default: fullsize

Calendar Button

Choose which calendar the HUD button opens.

Options: BigCal, MiniCal
Default: bigcal

Sun/Moon Dial Style

Choose how the sun and moon are displayed:

Dome: Semi-circular dome above the bar with sun/moon arc
Slice: Horizontal strip in the bar with sun/moon traveling left-to-right
Default: dome

Weather Effects

Controls weather particle effects in the HUD dome and Sun Dial. Sky, sun, moon, and stars are unaffected. This is a per-client setting.

Full: All weather particle effects at normal density
Reduced: Lower particle density for better performance
Off: No weather particle effects
Default: Off

Event Border Glow (GM Only)

Glow effect around the HUD border when events exist on the current day. Disabling removes only the glow; event icons, tooltips, and note actions remain.

Default: false

Dome Below Bar

Render the dome visual below the info bar instead of above it.

Default: false

Tray Open Direction

Direction the time controls tray expands when opened.

Below: Tray opens below the HUD bar
Above: Tray opens above the HUD bar
Default: Below

Combat Behavior

Controls HUD behavior during combat. This is a per-user setting.

None: No change during combat
Compact on Combat Start: Switch to compact mode when combat begins
Compact on Encounter Creation: Switch to compact mode when a combat encounter is created
Hide on Combat Start: Automatically hide when combat begins
Hide on Encounter Creation: Automatically hide when a combat encounter is created
Default: Compact on Combat Start

Widgets automatically restore when combat ends. Manually calling show() is blocked while the hide mode is active.

Dome Auto-Hide

Fade and hide the sundial dome as the HUD approaches the top of the viewport.

Default: true

Show All Moons

Display all configured moons in the HUD dome. Secondary moons trail with size scaling.

Default: true

HUD Width Scale

Scale HUD width from 0.5x to 2.0x of the 800px base, spanning 400px to 1600px. Only applies in fullsize mode.

Range: 0.5 to 2.0
Default: 1.0

Auto-Fade When Idle

Enable opacity fade when mouse leaves the HUD.

Default: false

Idle Opacity %

Opacity level when HUD is faded (when Auto-Fade is enabled). Use the slider or enter a value directly in the number input.

Range: 0 to 100 %
Default: 40

Block Visibility

Toggle indicator blocks in the HUD bar. Hiding blocks shrinks HUD width. User-scoped (each player sets their own view).

Show Weather

Display weather indicator.

Default: true

Weather Display Mode

Full: Icon + label + temperature
Icon + Temperature: Icon and temp only
Icon Only: Just the weather icon
Temperature Only: Just the temperature
Default: full

Show Season

Display season indicator.

Default: true

Season Display Mode

Icon + Text: Both icon and season name
Icon Only: Just the season icon
Text Only: Just the season name
Default: icon + text

Show Era

Display era indicator.

Default: true

Era Display Mode

Full: Icon + name + abbreviation
Icon: Just the era icon
Text: Just the era name
Abbreviation: Just the era abbreviation
Default: full

Show Cycles

Display cycle indicators.

Default: true

Cycles Display Mode

This is a per-user setting.

Name: Cycle entry name
Icon: Just the cycle icon
Number: Numeric value
Roman Numeral: Roman numeral value
Default: icon

Custom Time Jumps (GM Only)

Configure custom time jump buttons per increment. Each increment can have its own jump values.

Sticky States

Zone snapping is controlled by the Canvas tab’s Enable Sticky Zones setting. Position is preserved when switching display modes (dome/slice/compact). Bottom-anchored zones such as above-hotbar maintain position relative to bar bottom across mode changes.

Sticky Tray

Remember tray open/closed state between sessions.

Default: false

Lock Position

Prevent dragging the HUD.

Default: false

MiniCal

Visible to any user with the View MiniCal permission.

Open / Close / Reset Position

Buttons to open or close the MiniCal directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Show MiniCal on Load

Show the MiniCal on world load.

Default: true

Force Display for All (GM Only)

Prevents players from closing the MiniCal. Turning it on also shows the MiniCal for everyone.

Default: false

Compact Mode (MicroCal)

Reduce the MiniCal to a compact size with circular day cells and icon-only indicators. Weekday headers and the time display are hidden.

Default: false

Compact Mode Header

Display format for the compact mode header text.

Default: Approximate Date & Time (approxDateTime)

Confirm Set Current Date (GM Only)

Show a confirmation dialog before changing the world date via the Set Current Date button.

Default: true

Auto-Open Notes Panel

Open notes panel when selecting a day that has notes.

Default: false

Block Visibility

Toggle indicator blocks in the MiniCal. User-scoped (each player sets their own view).

Show Time

Display the current time in the MiniCal.

Default: true

Show Weather

Display weather indicator.

Default: true

Weather Display Mode

Full: Icon + label + temperature
Icon + Temperature: Icon and temp only
Icon Only: Just the weather icon
Temperature Only: Just the temperature
Default: full

Show Season

Display season indicator.

Default: true

Season Display Mode

Icon + Text: Both icon and season name
Icon Only: Just the season icon
Text Only: Just the season name
Default: icon + text

Show Era

Display era indicator.

Default: true

Era Display Mode

Full: Icon + name + abbreviation
Icon: Just the era icon
Text: Just the era name
Abbreviation: Just the era abbreviation
Default: full

Show Cycles

Display cycle indicators.

Default: true

Cycles Display Mode

Name: Cycle entry name
Icon: Just the cycle icon
Number: Numeric value
Roman Numeral: Roman numeral value
Default: icon

Show Selected Date in Header

Show the selected date instead of the current date in the MiniCal header.

Default: false

Custom Time Jumps (GM Only)

Configure custom time jump buttons using a grid layout with four columns:

Major Decrement: Large backward time jump
Minor Decrement: Small backward time jump
Minor Increment: Small forward time jump
Major Increment: Large forward time jump

Each row represents a time unit (seconds, minutes, hours, etc.). Leave a field blank to hide that button.

Controls Auto-Hide Delay

Seconds before auto-hiding controls after hover.

Range: 1-10 seconds
Default: 3

Sticky Time Controls

Remember time controls visibility state.

Default: false

Remember sidebar visibility state.

Default: false

Lock Position

Prevent dragging the MiniCal.

Default: false

Auto-Fade When Idle

Enable opacity fade when mouse leaves the MiniCal.

Default: false

Idle Opacity

Opacity level when MiniCal is faded (when Auto-Fade is enabled).

Range: 0 to 100 (percentage)
Default: 40

Combat Behavior

Controls MiniCal behavior during combat. See HUD > Combat Behavior for option details.

Default: None

BigCal

Visible to any user with the View BigCal permission.

Open / Close / Reset Position

Buttons to open or close BigCal directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Show BigCal on Load (GM Only)

Show BigCal on world load.

Default: false

Force Display for All (GM Only)

Prevents players from closing BigCal. Turning it on also shows BigCal for everyone.

Default: false

Auto-Fade When Idle

Enable opacity fade when mouse leaves BigCal.

Default: false

Idle Opacity

Opacity level when BigCal is faded (when Auto-Fade is enabled).

Range: 10 to 100 (percentage, step 5)
Default: 40

Block Visibility

Toggle indicator blocks in BigCal. User-scoped (each player sets their own view).

Show Weather

Display weather indicator.

Default: true

Weather Display Mode

Full: Icon + label + temperature
Icon + Temperature: Icon and temp only
Icon Only: Just the weather icon
Temperature Only: Just the temperature
Default: full

Show Season

Display season indicator.

Default: true

Season Display Mode

Icon + Text: Both icon and season name
Icon Only: Just the season icon
Text Only: Just the season name
Default: icon + text

Show Era

Display era indicator.

Default: true

Era Display Mode

Full: Icon + name + abbreviation
Icon: Just the era icon
Text: Just the era name
Abbreviation: Just the era abbreviation
Default: full

Show Cycles

Display cycle indicators.

Default: true

Cycles Display Mode

Name: Cycle entry name
Icon: Just the cycle icon
Number: Numeric value
Roman Numeral: Roman numeral value
Default: icon

Show Selected Date in Header

Show the selected date instead of the current date in the BigCal header.

Default: false

Combat Behavior

Controls BigCal behavior during combat. See HUD > Combat Behavior for option details.

Default: None

Time Keeper

Visible to any user with the View Time Keeper permission.

Open / Close / Reset Position

Buttons to open or close the Time Keeper directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Show Time Keeper on Load (GM Only)

Show the Time Keeper on world load.

Default: false

Force Display for All (GM Only)

Prevents players from closing the Time Keeper. Turning it on also shows the Time Keeper for everyone.

Default: false

Custom Time Jumps (GM Only)

Custom time jump buttons per increment, each with its own forward/reverse values.

Sticky States

Sticky Tray

Keep the time controls visible instead of auto-hiding when the mouse leaves. Also toggled from the Time Keeper context menu.

Default: false

Lock Position

Prevent dragging the Time Keeper.

Default: false

Auto-Fade When Idle

Enable opacity fade when mouse leaves the Time Keeper.

Default: true

Idle Opacity

Opacity level when Time Keeper is faded (when Auto-Fade is enabled).

Range: 0 to 100 (percentage)
Default: 40

Combat Behavior

Controls Time Keeper behavior during combat. See HUD > Combat Behavior for option details.

Default: None

Stop Watch

Visible to any user with the View Stop Watch permission.

Open / Close / Reset Position

Buttons to open or close the Stop Watch directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Show Stop Watch on Load (GM Only)

Show the Stop Watch on world load.

Default: false

Force Display for All (GM Only)

Prevents players from closing the Stop Watch. Turning it on also shows the Stop Watch for everyone.

Default: false

Auto-Start World Time (GM Only)

Starts the world-time stopwatch automatically when world time begins advancing.

Default: false

Auto-Fade When Idle

Enable opacity fade when mouse leaves the Stop Watch.

Default: false

Idle Opacity

Opacity level when the Stop Watch is faded (when Auto-Fade is enabled).

Range: 0 to 100 (percentage)
Default: 40

Display Formats

Display format for stopwatch time. Live preview next to GM/Player format labels.

Elapsed Time (Real Time)

Format for real-time stopwatch display.

Options: Full, No Milliseconds, Minutes:Seconds, Seconds Only, Custom

Elapsed Time (World Time)

Format for world-time stopwatch display.

Options: Full, Minutes:Seconds, Seconds Only, Custom

Stop Watch Format Tokens

Applies to the Custom option.

Token	Description	Example
`HH`	Hours (2-digit)	01
`mm`	Minutes (2-digit)	05
`ss`	Seconds (2-digit)	30
`SSS`	Milliseconds (3-digit)	250

Sticky States

Lock Position

Prevent dragging the Stop Watch.

Default: false

Combat Behavior

Controls Stop Watch behavior during combat. See HUD > Combat Behavior for option details.

Default: None

Sun Dial

Visible to any user with the View Sun Dial permission.

Open / Close / Reset Position

Buttons to open or close the Sun Dial directly, and to reset it to its default position. A hint under the buttons names the other ways to open the app: the Journal sidebar footer, Scene Controls → Journal Notes, and a keybind assigned in the core Configure Controls menu.

Options

Show Sun Dial on Load (GM Only)

Auto-open the Sun Dial when the world loads.

Default: false

Force Display for All (GM Only)

Prevents players from closing the Sun Dial. Turning it on also shows the Sun Dial for everyone.

Default: false

Crank Mode

Enable cumulative day advancement by rotating the sun handle past midnight.

Default: false

Auto-Fade When Idle

Enable opacity fade when mouse leaves the Sun Dial.

Default: true

Idle Opacity

Opacity level when Sun Dial is faded.

Range: 0 to 100 (percentage)
Default: 40

Display Formats

Time-only format presets for the Sun Dial time display. Separate GM and player formats with live preview.

Sticky States

Lock Position

Prevent dragging the Sun Dial.

Default: false

Combat Behavior

Controls Sun Dial behavior during combat. See HUD > Combat Behavior for option details.

Default: None

Settings handled elsewhere

Theming

Calendaria’s visual theme is managed by 3DS:ATLAS, the shared theme engine used across 3DS modules. Theme presets and custom colors are configured there.

Primary GM

The GM that runs time saves, sync, seeding, and macro triggers is set in 3DS:ATLAS.

Display formats reference

Format settings appear across app tabs, as well as Notes and Cinematics tabs. Each location supports separate GM and player formats. Fresh worlds seed display formats from the active calendar’s authored defaults.

Format Preview

Live preview next to GM/Player format labels shows how the format renders with the current date. Invalid custom formats show an error message. A format containing letters that match no token shows a warning, with the unrecognized letters named in the preview tooltip.

Token Reference Dialog

Click the help icon (?) next to Display Formats headings for an interactive reference of all format tokens organized by category with examples.

Format Presets

Utility

off: Hide the element entirely (available for HUD Date and Time Keeper Date formats)
calendarDefault: Uses the active calendar’s built-in format for that location
custom: User-defined format string

Approximate

approxDate: Approximate date
approxTime: Approximate time of day
approxDateTime: Approximate date and time combined

Standard Dates

dateShort: Short date format
dateMedium: Medium date format
dateLong: Long date format
dateFull: Complete date with all details

Regional Dates

dateUS: US-style date
dateUSFull: Full US-style date
dateISO: ISO 8601 date format
dateNumericUS: Numeric US format (MM/DD/YYYY)
dateNumericEU: Numeric EU format (DD/MM/YYYY)

Ordinal/Fantasy

ordinal: Day with ordinal suffix
ordinalLong: Long ordinal format
ordinalEra: Ordinal with era
ordinalFull: Complete ordinal format
seasonDate: Season-based date format

Headers

weekHeader: Week + Month + Year
yearOnly: Year Only
yearEra: Year + Era

Time

time12: 12-hour time with AM/PM
time12Sec: 12-hour time with seconds
time24: 24-hour time
time24Sec: 24-hour time with seconds

DateTime

datetimeShort12: Short date with 12-hour time
datetimeShort24: Short date with 24-hour time
datetime12: Date with 12-hour time
datetime24: Date with 24-hour time

Format Tokens

Year

Token	Description	Example
`YYYY`	4-digit year	1492
`YY`	2-digit year	92
`Y`	Unpadded year	1492

Month

Token	Description	Example
`MMMM`	Full month name	Flamerule
`MMM`	Abbreviated month name	Fla
`MM`	2-digit month	07
`M`	Unpadded month	7
`Mo`	Month with ordinal	7th

Day

Token	Description	Example
`DD`	2-digit day	05
`D`	Unpadded day	5
`Do`	Day with ordinal	5th
`DDD`	Day of year	186

Weekday

Token	Description	Example
`EEEE`	Full weekday name	Sunday
`EEE`	Abbreviated weekday	Sun
`E`, `EE`	Numeric weekday	1
`e`	Local numeric weekday	0

Time

Token	Description	Example
`HH`, `H`	24-hour (padded/unpadded)	14, 14
`hh`, `h`	12-hour (padded/unpadded)	02, 2
`mm`, `m`	Minutes (padded/unpadded)	05, 5
`ss`, `s`	Seconds (padded/unpadded)	09, 9
`A`, `a`	AM/PM (upper/lower)	PM, pm

Era

Token	Description	Example
`GGGG`, `GGG`	Full era name	Dale Reckoning
`GG`	Abbreviated era	DR
`G`	Narrow era	D

Season

Token	Description	Example
`QQQQ`	Full season name	Summer
`QQQ`	Abbreviated season	Sum
`QQ`, `Q`	Numeric season	2

Week

Token	Description	Example
`ww`, `w`	Week of year	27, 27
`W`	Week of month	1

Climate Zone

Token	Description	Example
`zzzz`	Full climate zone name	Temperate Forest
`z`	Abbreviated climate zone	Temp

Fantasy

Token	Description	Example
`[approxTime]`	Approximate time of day	Afternoon
`[approxDate]`	Approximate date	Midsummer
`[moon]`	Current moon phase name	Full Moon
`[moonIcon]`	Moon phase icon (rendered as image)	(moon icon)
`[moonIcon='name']`	Specific moon by name	Moon phase for named moon
`[moonIcon=0]`	Specific moon by index	Moon phase for first moon
`[ch]`	Current canonical hour	Vespers
`[chAbbr]`	Abbreviated canonical hour	Ves
`[cycle]`	Current cycle value	3
`[cycleName]`	Current cycle entry name	Gemini
`[cycleRoman]`	Cycle value as roman numeral	III
`[yearInEra]`	Year within current era	5

Per-scene settings

Override global settings on individual scenes via Scene Configuration > Calendaria tab. The tab reuses the global setting names. Each override offers Use Global Setting, Enabled, Disabled unless noted.

Sync Darkness with Time

Override the global Sync Scene Darkness with Time setting for this scene.

Default: Use Global Setting

Brightness Multiplier

Override the global Default Brightness for this scene.

Range: 0.5 to 1.5
Default: Uses global setting

Weather Affects Darkness

Override the global Weather Affects Darkness setting for this scene.

Default: Use Global Setting

Moon Illumination

Override the global Moon Illumination setting for this scene.

Default: Use Global Setting

Sync Scene Ambience with Weather

Override the global Sync Scene Ambience with Weather setting for this scene.

Default: Use Global Setting

Sync Scene Ambience with Time of Day

Override the global Sync Scene Ambience with Time of Day setting for this scene.

Default: Use Global Setting

Hide HUD for Players

Hide the Calendaria HUD from players when this scene becomes active. Navigating to a non-hidden scene restores HUD visibility for users with Show HUD on Load enabled.

Default: false

Climate Zone Override

Override the calendar’s default climate zone for this scene. Affects weather generation, darkness calculations, and environment lighting. Leave the dropdown on “Use Calendar Default” to follow the calendar’s own zone. When the calendar defines no climate zones the dropdown is disabled and shows a note.

To switch the scene to “No Zone”, use the Scene Zone dropdown in the Weather Picker.

Default: Use Calendar Default

Weather FX Override

Force FXMaster weather particle effects on or off for this scene, or inherit the global Enable Weather FX setting. Takes effect immediately. Ambient weather sound is not affected.

Inherit (Global Setting): Follow the global Enable Weather FX toggle
On: Force weather FX active on this scene
Off: Force weather FX off on this scene
Default: Inherit (Global Setting)

Weather FX View Mode

Override the global Top-Down Mode setting for FXMaster effects on this scene.

Use Global Setting: Follow the module setting
Top-Down: Force top-down rendering on this scene
Side View: Force side-view rendering on this scene
Default: Use Global Setting

Weather FX Splash

Override the global Particle Splash setting for FXMaster effects on this scene.

Use Global Setting: Follow the module setting
Show Splash: Force the ground splash on for this scene
No Splash: Force the ground splash off for this scene
Default: Use Global Setting

Disable Weather Sound

Suppress weather ambient sounds on this scene without affecting visual effects. The Weather FX Override does not affect ambient sound. Sounds fade out while the user’s controlled or owned token is inside a Foundry scene region carrying the core Suppress Weather behavior, unless the Suppression Muffle setting keeps a fraction of the volume.

Default: false

Weather Effect Levels

Restrict FXMaster weather effects to selected scene levels. Only shown when the scene defines levels.

Default: all levels