Notes and Events
Calendar notes are journal entry pages attached to specific dates, with rich text content, custom icons, recurrence patterns, categories, and macro triggers.
Note storage
Section titled “Note storage”Notes are stored as journal entries within a folder per calendar. These folders are hidden from the Journal sidebar. Access notes through the calendar UI or the Note Viewer.
Creating a note
Section titled “Creating a note”- Click a date on the calendar grid
- Click Add Note to open the note editor
- Pick a category in the preset selection dialog, or skip it
- Configure title, icon, dates, times, and content
- Close the window to save
Editing and deleting
Section titled “Editing and deleting”Edit a note
Section titled “Edit a note”- Click the note to open it in view mode
- Click the edit icon in the header to switch to edit mode
- Make changes
- Switch to view mode or close the window; changes save automatically
Delete a note
Section titled “Delete a note”- Open the note in edit mode
- Click the trash icon in the header
- Confirm deletion
Note sheet
Section titled “Note sheet”The note editor has three tabs: Content, Schedule, and Settings. Edits save when you switch tabs, return to view mode, or close the sheet.
Content tab
Section titled “Content tab”- Title: Note name
- Emblem: FontAwesome class or image file (right-click to switch modes)
- Color: Note color via color picker
- Content: Rich text editor for the note body
Festival notes display an info banner on each tab, linking to the calendar editor (GM-only).
Schedule tab
Section titled “Schedule tab”The top of the tab has a Schedule Mode toggle with two options: One-time Event and Recurring Event. The controls below change based on the selected mode.
Switching from Recurring to One-time prompts a confirmation because it clears the condition tree.
One-time mode
Section titled “One-time mode”- Start Date / End Date: Click to open a date picker. The two pickers sit side by side and set the event’s span directly.
- Time: Hour and minute inputs for start and end time (hidden when All Day is checked)
- All Day: Checkbox to hide time fields. When checked, end date fields are disabled and synced to match the start date.
Recurring mode
Section titled “Recurring mode”- Anchor Date: Click to open a date picker for the base date the recurrence pattern is anchored to
- Repeats Until: Optional date picker that caps the recurrence. Click the x button to clear.
- Time: Hour and minute inputs (hidden when All Day is checked)
- All Day: Checkbox to hide time fields.
- Duration: Number of days each occurrence spans (minimum 1)
- Condition Presets: A select that reflects your calendar’s weekdays, months, seasons, and moon phases. Choosing a preset opens a confirmation dialog with a merge checkbox to merge the preset into existing conditions instead of replacing them.
- Open Builder: Opens the visual condition builder with the note’s current conditions loaded
- Condition Summary: Displays the note’s recurrence rules as pills. Right-click a pill to delete it.
- Max Occurrences: Limit how many times a recurring note appears. Leave blank for unlimited.
- Occurrence Preview: Read-only list of the next upcoming dates
Show Bookends lives on the Settings tab under Display Style.
Settings tab
Section titled “Settings tab”Display
Section titled “Display”- Visibility: Visible, Hidden, or Secret (GM only)
- Silent: Suppress reminders and event announcements
- Display Style: Icon, pip, or banner
- Show Bookends: Start/end markers on the first and last days. Enabled only when the event spans more than one day.
- Macro: Select a macro to execute when the event triggers
Reminders
Section titled “Reminders”- Reminder Type: None, Toast, Chat, or Dialog
- Reminder Targets: All, GM, Author, Viewers, or Specific users
- Reminder Offset (labeled “Notify Before”): Hours before the event to fire the reminder. 0 fires at event start.
- Reminder Users: User list, shown only when the target is Specific
Categories
Section titled “Categories”- Select from existing categories
- Add new categories inline
- Categories with the player-usable flag disabled are hidden from non-GM users unless already assigned to the note
- The Default preset does not appear as a selectable category. It acts as a fallback for uncategorized notes and is hidden from category pickers and badge displays
Ownership
Section titled “Ownership”Per-user permission dropdowns. Each user can be set to None, Observer, or Owner. GM and note author are fixed at Owner.
Per-user grants layer on top of the visibility default and are editable in every visibility mode. Grant a player Observer on a Hidden note to add them alongside the GM and author. Grant a player None on a Visible note to exclude them. Flipping visibility updates the default tier. Visible raises it to Observer; Hidden and Secret drop it to None. Existing per-user grants are untouched.
Only GMs can manage note permissions. Non-GM users see a disabled ownership fieldset with a tooltip explaining that permission management is restricted to the GM.
Condition engine
Section titled “Condition engine”Rule-based scheduling for notes. Conditions check date, weekday, season, moon phase, and more to decide whether a note shows on a given day.
Condition fields
Section titled “Condition fields”Conditions check:
- Date fields: year, month, day, day of year, full date comparison, and more
- Weekday fields: weekday, week number in month (e.g., “3rd Tuesday”), inverse week number
- Season fields: current season, percentage through the season, season day, solstices, equinoxes
- Moon fields: moon phase, named phase (New, Full, etc.), sub-phase (Rising, True, Fading), phase occurrence counts
- Cycle and Era fields: current cycle entry and era (when the calendar defines them)
- Other fields: intercalary days, leap years, weather, eclipses, random values, event references
See API Reference for the complete field list.
Condition operators
Section titled “Condition operators”- Comparison: equals, not equals, greater than, less than, greater or equal, less or equal
- Modulo: repeating intervals like “every 4th year” with an optional offset
- Event-relative: days ago, days from now, within the last N days, within the next N days
See API Reference for the complete operator list.
Condition groups
Section titled “Condition groups”Organize conditions into groups with boolean logic:
- AND: All conditions must pass (default)
- OR: At least one condition must pass
- NAND: Passes when not all conditions pass (negated AND)
- XOR: Passes when exactly one condition passes
- COUNT: Passes when a specific number of conditions pass
Groups nest inside other groups for complex rules.
Example: “Every 3rd Tuesday in winter during a full moon” uses an AND group with conditions for weekday, week number, season, and moon phase.
Event-based conditions
Section titled “Event-based conditions”A note’s schedule can depend on another note’s occurrences: “3 days after Festival X” or “within 5 days of Event Y”.
- Select the target note using the note picker in the condition builder
- Use event-relative operators: days ago, days from now, within last, within next
- Circular references are prevented
Condition builder
Section titled “Condition builder”Visual editor for condition trees.
- Open a note in edit mode
- Go to the Schedule tab
- Click Open Builder
In the builder:
- Select a field, grouped by category
- Choose an operator for the field type
- Enter a value using the field-specific input
- Add conditions and nested groups with the Add Condition and Add Group buttons
- Remove a condition or group by clicking its X (remove) icon
The builder has no reorder controls and only edits the condition tree. The preset dropdown and merge option live on the Schedule tab, next to the Open Builder button. Its optgroups are Basic, Weekly, Monthly, Yearly, Every Nth, Seasons, Moons, and Eclipses. Right-click-to-delete applies to the condition-summary pills on the Schedule tab, not to the builder.
Categories
Section titled “Categories”Organize notes by type. Every world starts with built-in presets, and you can create your own.
Open the Note Preset Editor from the Settings Panel to create, edit, delete, and reorder presets.
Defaults and overrides
Section titled “Defaults and overrides”Categories define defaults that auto-apply when creating a note: display style, visibility, reminder settings, and duration.
Categories also define overrides that force specific values on all notes in the category. Overridden fields are locked in the note editor. Use the lock toggle in the Note Preset Editor to promote a field from default to override.
Player-usable flag
Section titled “Player-usable flag”Each category has a player-usable flag. When disabled, non-GM users don’t see that category when creating or editing notes.
Visibility
Section titled “Visibility”Three visibility levels:
| Level | Icon | Who Can See |
|---|---|---|
| Visible | (none) | All users with journal permissions |
| Hidden | Eye-slash | GM only |
| Secret | Lock | GM only, and only when “Show Secret Notes” is enabled |
- Hidden notes are always visible to GMs
- Secret notes are hidden from everyone by default, including GMs. Enable Show Secret Notes in the Settings Panel to see them.
- The Silent flag suppresses reminders and announcements independently
- Non-GM users need at least Observer permission on the parent journal entry to see a visible note
Duration and display styles
Section titled “Duration and display styles”Duration
Section titled “Duration”Duration is a number-of-days field. Its visibility on the Schedule tab depends on the Schedule Mode:
- One-time: the Start Date / End Date pickers control the span directly. Duration is derived on save from the date range.
- Recurring: Duration is the primary control for per-occurrence length.
Multi-day events render as continuous bars across calendar days in BigCal.
- Show Bookends: Start/end markers on the first and last days. Configured on the Settings tab.
Display styles
Section titled “Display styles”| Style | Description |
|---|---|
| Icon | Default inline icon next to the note name |
| Pip | Compact dot indicator with minimal footprint |
| Banner | Full-width bar spanning the event’s duration across days |
Notes sort by display priority: banner > icon > pip, with festivals first.
Festival notes
Section titled “Festival notes”Calendar festivals are created as journal notes using the condition engine. Festivals act as templates that produce independent notes.
- After creation, festival notes are independent. Editing a festival note does not change the template.
- An info banner on the note editor links to the calendar editor (GM-only)
- Reminder settings are preserved across festival updates
- Festivals support leap-year-only scheduling via the Is Leap Year condition field
- Non-GM users cannot delete festival notes
- GMs can re-sync festival notes from Settings Panel > Notes tab
Player permissions
Section titled “Player permissions”Players create and edit notes based on Calendaria permissions, combined with Foundry document permissions.
What players can do
Section titled “What players can do”- Create notes using the Add Note button
- Edit notes they created
- Edit another user’s note when granted Foundry Owner permission on it
- Delete notes they created
- View notes with appropriate permissions
What players cannot do
Section titled “What players cannot do”- View hidden or secret notes
- Delete others’ notes or festival notes
- Modify time, date, or weather
There is no “Edit Notes” Calendaria permission. Editing another user’s note requires Foundry Owner permission on that note, set through the note’s visibility tier or a per-user Ownership grant. Edit mode in the note sheet is gated on document ownership. Calendaria’s note permissions are limited to “Add Notes” for creation and “Delete Notes” for bulk deletion.
For developers
Section titled “For developers”See API Reference and Hooks.