BigCal
A borderless floating calendar window with month, week, and year views.
BigCal sizes itself to the view it is showing, up to the height of the browser viewport. Past that the content area scrolls and the header stays fixed. The window re-fits itself when the browser resizes.
Opening BigCal
Section titled “Opening BigCal”- Double-click MiniCal, or click its expand button
- Click the calendar button on the HUD
- Click the BigCal button in the Notes scene controls, which toggles the window
- Call
CALENDARIA.api.showBigCal()
BigCal also opens on world load when that is enabled in Settings.
Drag the header to move the window. BigCal saves where you drop it and reopens in the same place, clamped back inside the viewport if the browser window has shrunk since. With no saved position it opens centered.
Double-click the header to close BigCal and open MiniCal. Double-clicking one of its buttons or the view selector does nothing.
Display modes
Section titled “Display modes”To switch views, use the dropdown in the header.
Month view
Section titled “Month view”The default view. A grid of weeks showing:
- Weekday headers, with rest days highlighted
- Day cells carrying notes, moon phases, and festival markers
- Multi-day events drawn as horizontal bars across the weeks
- Faded days from the previous and next month, clickable to navigate there
- Intercalary days in their own row below the regular weeks
When the calendar uses a week cycle, weekdays that a cycle row skips render as empty cells.
Week view
Section titled “Week view”One row per weekday, one column per hour of the calendar’s day.
- Hour labels run across the top, and the current hour is outlined on today’s row
- All-day events render as a single block spanning the whole day row
- Timed events sit at their start hour and stretch across the hours they cover
- Recurring notes render on every matching day in the visible week
- A multi-day event splits into a timed start block, all-day middle days, and a timed end block. Continuation edges drop their rounded corners so the blocks read as contiguous.
- A + button on a time cell creates a note at that hour
Selecting a time slot highlights it, and clicking it again clears the selection. While a slot is selected, any + button creates the note at the selected hour instead of the cell’s own hour.
Year view
Section titled “Year view”A three-by-three grid of years, each year showing its months.
- The viewed year sits at the center of the grid and is outlined
- The month holding the current date is outlined
- A month with no days in that year renders dimmed and does not respond to clicks
- Click a month to jump to it in month view
- The arrow buttons move between year ranges
Header
Section titled “Header”| Button | Action |
|---|---|
| Previous / Next | Move by month, week, or year range, depending on the view |
| View selector | Switch between month, week, and year |
| Today | Jump to the current date |
| Note Viewer | Open the Note Viewer |
| Chronicle | Open the Chronicle |
| Settings | Open the settings panel |
| Compact | Close BigCal and open MiniCal |
| Close | Close BigCal |
| Set Current Date | Set world time to the selected date (GM only) |
The Chronicle button appears only when it is enabled in Settings.
When the active calendar disallows negative years, backward navigation stops at the earliest year.
Indicators
Section titled “Indicators”The bottom header row carries indicators for weather, season, era, and cycles. The era indicator appears only when the calendar has eras, and the cycle indicator only when it has cycles. As GM you can click the weather indicator to open the Weather Picker.
Equivalent dates
Section titled “Equivalent dates”An extra row appears above the indicators whenever one or more equivalent calendars are selected. For each calendar the row shows the viewed date converted to that calendar, linking to its Secondary Calendar Viewer.
Day cells
Section titled “Day cells”| Element | Description |
|---|---|
| Day number | The date. Today and the selected day each get a tinted cell background. |
| Festival icon | Marks a festival day |
| Moon icons | Up to three visible, with a “+N” badge carrying the rest in its tooltip |
| Note indicators | One per note on the day |
| Weather pill | Icon, temperature, and wind direction |
| Add button | Creates a note on that day, appears on hover |
A festival day tints the whole cell in the festival’s color and draws a colored bar along its top edge. The icon is the festival’s own icon or image, falling back to a star when the festival has none.
When a calendar has more moons than the cell can show, clicking a moon icon opens a radial picker for choosing which moon fills that slot.
Note display styles
Section titled “Note display styles”A note’s display style changes how its indicator draws inside the day cell.
| Style | Rendering |
|---|---|
| Icon | Default. The note’s icon in the note’s color |
| Pip | A small dot filled with the note’s color |
| Banner | A full-width colored bar carrying the note’s title |
Weather pills
Section titled “Weather pills”- Today. Current weather at full opacity
- Past days. Stored weather from the weather history
- Future days. Dimmed forecast weather
Forecast pills need weather auto-generation switched on and the forecast permission granted. Without both, a future day shows a pill only where weather has already been stored for that date.
Tooltips
Section titled “Tooltips”Hovering a day cell shows:
- Full date with era
- Day name, when the date has one
- Festival name, when applicable
- Season name
- Sunrise and sunset times
- Weather conditions
- Equivalent dates from other calendars, when configured
- The day’s notes, festivals first, each with its own icon in the note’s color. A “+N more” row appears when the list runs past its cap.
Interactions
Section titled “Interactions”- Click a day to select it. Click again to deselect.
- Click a faded day from another month to navigate there.
- Right-click a day for its context menu.
Day context menu
Section titled “Day context menu”- Add Note. Creates a note on that day.
- Set Current Date. Jumps world time straight to the right-clicked day without selecting it first. GM only, and omitted when you right-click the current date.
- Open Chronicle.
- The BigCal items: BigCal Settings, which jumps to the BigCal settings tab; Open, whose submenu lists the Calendaria apps the viewer has permission for; the GM-only Show to All / Hide from All toggle; and Close.
- The day’s notes, sorted alphabetically. A “+N more” entry opens the Note Viewer filtered to that date.
Inline edit and delete icons appear only on notes you own. Delete asks for confirmation before removing the note.
Right-click the BigCal header for a shorter menu carrying only the BigCal items.
Multi-day events
Section titled “Multi-day events”A note with duration draws as a horizontal bar across the grid.
- The bar takes the note’s color and carries its icon and title
- An arrow replaces the icon on a bar whose event began before the displayed month, and only on the first row the bar occupies
- Overlapping bars condense to thin lines. Hovering one expands it to full height with its icon and title.
- Click a bar to open the note
- Timed bars trim to the start hour on the first day and the end hour on the last, scaled against the calendar’s hours and minutes per day. All-day notes and the interior weeks of a multi-week span fill their cells edge to edge.
Bars ignore the note’s display style and always draw the icon and title.
With bookends enabled the note draws two single-day bars instead, one on the start day and one on the end day. Nothing is drawn on the days between them.
Events sort by start day, then all-day before timed, then by start hour.
Clicking a note indicator or an event bar opens the note in edit mode, overriding the Note Open Mode setting. Non-owners get view mode instead.
To create a note, use the + button on a day cell, Add Note in the day context menu, or the + button on a time cell in week view.
BigCal has no search of its own. The header book-open button opens the Note Viewer, where all note searching happens.
GM controls
Section titled “GM controls”- Set Current Date. Sets world time to the selected date. The button stays disabled until you select a day other than the current date. Its tooltip reads “Current Date” while disabled and “Set Selected Date as Current” once a day is selected.
- Weather Picker. Click the weather indicator to change the weather.
- Show to All / Hide from All. Context menu toggle for BigCal visibility across connected players.
Players cannot modify world time.
While Show to All is active, players cannot close BigCal. A player who tries gets a notification that the display is forced, and switching the toggle back to Hide from All releases them.
Intercalary days
Section titled “Intercalary days”Intercalary days are festival days flagged as not counting toward the weekday cycle. They appear in their own row below the regular weeks.
Monthless calendars
Section titled “Monthless calendars”For calendars without months, the month view shows a three-week sliding window.
- The previous week, the current week, and the next week
- Navigation moves by week instead of month
- The header shows the week and year instead of a month name