Skip to content
3 Death Saves

Calendaria

Calendaria gives your world a calendar and a clock. An animated HUD tracks the sun and moons and dims scenes at night. Schedule notes that fire on conditions like "every full moon", roll weather across seasons and climate zones, and play large time jumps as a table-wide cinematic.
Get started View on Foundry Support on Patreon

Start here

Section titled “Start here”

Getting started covers installation and setup.

Importing calendars brings your data over from Simple Calendar, Seasons & Stars, Fantasy-Calendar.com, and more.

Highlights

Section titled “Highlights”

Animated time display

Section titled “Animated time display”

The HUD is a draggable bar showing the date, time, weather, and events. The sun and the visible moons arc across a sky that changes color with the hour. That sky is drawn as a curved dome outside the bar or as a flat slice inside it.

Calendar views

Section titled “Calendar views”

BigCal is a floating window with month, week, and year views. MiniCal packs a month grid and the time controls into a smaller widget. The Note viewer searches and filters notes in a window of its own.

Custom calendars

Section titled “Custom calendars”

Use a bundled calendar or build your own in the Calendar editor. Define custom months, weekdays, leap years, intercalary days, and year-zero handling.

Notes and events

Section titled “Notes and events”

Schedule notes and events with daily, weekly, monthly, or yearly recurrence. A note can also repeat on a moon phase, on a season, relative to another note, or on a computed rule.

Cinematic time skip

Section titled “Cinematic time skip”

A large time advance can play as a fullscreen overlay on every connected client. The sky runs through the skipped days and events appear as cards. You can pause, resume, or abort it while it plays.

Moons

Section titled “Moons”

Track multiple moons with independent cycle lengths, phases, and colors. Trigger events on specific lunar phases.

Weather and ambience

Section titled “Weather and ambience”

Generate weather by climate zone and season. Scene ambience follows the time of day, with transitions at sunrise and sunset. With VGMusic installed, night and weather select scene playlists.

Eras and cycles

Section titled “Eras and cycles”

Define historical eras with custom year formatting and repeating cycles.

For developers

Section titled “For developers”

Calendaria has an API for module integration:

  • API reference: the CALENDARIA.api methods
  • Hooks: hooks for time, calendar, note, and weather events
  • Widgets: inject custom UI into Calendaria applications
  • Macros: run macros on times of day, seasons, and moon phases

Support

Section titled “Support”