Settings Backup & Transfer

You can export and import world settings, calendar data, and notes for backup or transfer between worlds.

Accessing Backup and Transfer

Open the settings panel and go to the Module tab, then the Backup & Transfer section.

Exporting

Open the Settings Panel
Go to the Module tab
Click Export Settings
Optionally check Include active calendar: {name} to embed the active calendar’s full definition
Save the JSON file

The exported file is named calendaria-settings-{timestamp}.json and includes:

Category	Examples
Display Formats	Date/time formats for HUD, MiniCal, BigCal, Time Keeper, Stop Watch, Chat
Time Settings	Real-time clock speed, multiplier, unit, sync-clock-pause
Weather	Current weather, history, forecast plans, intraday settings, inertia, custom presets
Fog of War	Enabled state, revealed ranges, start date, nav mode, reveal settings
Cinematic	Enabled, threshold, panel duration, per-element toggles, event weighting
Chronicle	Depth mode, view mode, visibility toggles, button visibility, combat mode
UI Visibility	Force settings for all 7 widgets; show settings for BigCal, HUD, MiniCal, Time Keeper, toolbar button, journal footer
Permissions	All role-based permissions
Categories	Custom note presets (bundled per-export only when referenced by included notes)
Custom Time Jumps	HUD, Time Keeper, MiniCal jump configurations
Macro Triggers	Season and moon phase trigger assignments
Theme	Theme mode, custom colors, forced theme colors
Scene Integration	Ambience sync, darkness sync, color shift sync, brightness multiplier
Equivalent Dates	Multi-calendar sync calendar list

Calendar data and notes (optional)

When Include active calendar: {name} is checked, the active calendar’s full definition is embedded in the export, including the current date. The active calendar’s notes are bundled automatically, along with any referenced festival seeds and the custom presets those notes reference. On import, this creates a new custom calendar in the target world.

Notes are serialized into the export. On import, notes are recreated and cross-references between notes are re-linked. Scene-specific, macro, and playlist references are cleared since they will not resolve in the target world.

Custom note presets referenced by the exported notes’ categories travel with the export and are restored on import before notes are processed. Presets whose ID already exists in the target world are skipped rather than overwritten.

What is not exported

These user-scoped (per-client) settings are not included:

Window positions (HUD, MiniCal, BigCal, Time Keeper, Stop Watch, Sun Dial)
Sun Dial sticky states (per-user). Note: HUD, MiniCal, Stopwatch, and TimeKeeper sticky states ARE included in the export.
Lock position states
Block visibility preferences
Combat behavior for the BigCal, MiniCal, Time Keeper, Stop Watch, and Sun Dial widgets (HUD and Chronicle combat behavior are exported).

Importing

Open the Settings Panel
Go to the Module tab
Click Import Settings
Select a previously exported JSON file
Review the confirmation dialog showing:
- Number of settings to import
- Source version
- Checkboxes for calendar data and notes (if present in the file)
- Option to set the imported calendar as active
Click Confirm to apply

Transferring between worlds

Export settings from the source world with the calendar checked
Open the target world
Enable Calendaria
Import the settings file
Check Set as active calendar to switch to the imported calendar

Version compatibility

Settings files include version metadata. When importing from a different version:

Settings that exist in both versions are imported
Settings only in the importing version keep their defaults
Settings removed from older versions are ignored

Troubleshooting

Import fails with an error

Verify the file is a valid Calendaria settings export (must contain a settings object)
Check that the file is not corrupted
Try exporting fresh settings to compare file structure

Settings do not apply after import

Refresh the page after importing
Check that all players have refreshed their browsers