Moon Phases
Calendaria supports multiple moons, each with its own cycle length, phase set, and color.
Configuring moons
Section titled “Configuring moons”Configure moons in Calendar Editor > Moons tab.
| Setting | Description |
|---|---|
| Name | Moon display name |
| Cycle Length | Days in one complete cycle |
| Color | Tint color for the moon icon |
The Reference Date group pins the cycle to a known date. It holds the year, month, and day, the Phase the moon shows on that date, and Adjust, which shifts the cycle by a number of days to fine-tune phase alignment.
Phase configuration
Section titled “Phase configuration”| Field | Description |
|---|---|
| Name | Phase name |
| Rising/Fading | Optional sub-phase names for multi-day phases |
| Icon | SVG path or emoji |
| Start/End | Cycle position |
To move phase boundaries, drag the handles on the phase slider. See Calendar Editor: Moon Phases.
Phase modes
Section titled “Phase modes”A moon’s Phase Mode decides how its phase is calculated over time.
The moon follows a repeating cycle. The phase on a given day comes from:
- Days since the most recent anchor. A reset anchor wins, otherwise a soft anchor or the moon’s reference date
- Position within the cycle, taken at the midpoint of the day. When the cycle has more phases than days, the position uses the current time of day instead
- The phase whose start/end range contains that fractional position
Randomized
Section titled “Randomized”The moon wanders off a strict cycle. The base cycle length still sets the overall pacing, and a seed drives how far the phase drifts from it day to day.
| Setting | Description |
|---|---|
| Phase Seed | Integer seed for randomization. The same seed always produces the same sequence. Use the dice button to randomize |
| Cycle Variance | How far the moon deviates from its base cycle length. At the low end it behaves like fixed mode; at the high end phases shift sharply between days |
| Weight | Per-phase value setting how likely a phase is relative to the others. A phase with double the weight occupies twice as much of the cycle |
Anchor phases
Section titled “Anchor phases”Anchor phases are date-specific phase pins. In Randomized mode they override the seeded phase on the anchor date. In Fixed mode they calibrate the cycle so the chosen phase begins on the anchor date. Reset Cycle restarts the cycle from that point; a non-reset anchor only calibrates it.
To add an anchor, use Add Anchor Phase on the Moons tab.
| Field | Description |
|---|---|
| Year | The display year to match. Leave blank for yearly recurrence |
| Month | The month the anchor falls on |
| Day | The day of the month |
| Phase | Which phase the moon displays on the anchored date |
Sub-phases
Section titled “Sub-phases”A phase spanning more than one day splits into thirds. The first third carries the Rising name, the last third the Fading name, and the middle third the phase name itself.
Leave a Rising or Fading name blank and the module builds one from the phase name.
Display
Section titled “Display”Calendar view
Section titled “Calendar view”Moon phases display on calendar day cells. Calendars, the HUD, and the sun dial list moons alphabetically by name.
BigCal shows moon icons on each day cell, tinted with each moon’s color. A +X badge counts the moons beyond the icons shown.
MiniCal shows a single moon icon, the alphabetically first visible moon until you pick another. To open the picker, click the icon.
The Hide Moons From Players setting on the Permissions tab hides every moon display from players. See Settings.
HUD dome
Section titled “HUD dome”The HUD dome renders moons with phase-accurate shadows and color glow. With Show All Moons enabled, secondary moons trail behind the primary moon at a smaller size.
Hidden moons
Section titled “Hidden moons”Each moon has a Hide from Players checkbox in the Calendar Editor. A hidden moon does not appear for players on calendars, the HUD, the sun dial, the chronicle, printed calendars, chat commands, cinematics, enrichers, or format tokens. You still see hidden moons on every surface. Hidden moons keep driving note conditions, eclipses, and moon illumination.
Moon brightness
Section titled “Moon brightness”Moons reduce nighttime scene darkness based on their phase. A moon under a lunar eclipse contributes less light. Each moon has a Brightness Contribution slider on the Moons tab. The slider stores no value until you move it, and both the editor and the darkness calculation read an unset value as the default contribution.
Illumination follows a cosine curve: maximum at full moon, zero at new moon. Multiple moons sum their values up to a cap, and each moon’s light is tinted with its configured color.
Toggle moon illumination from the Canvas settings. See Scene Ambience: Moon Illumination.
Moon-based note recurrence
Section titled “Moon-based note recurrence”Configure moon-based recurrence through the condition builder on the note editor’s Schedule tab. Set the note to Recurring, open the condition builder or pick a moon preset, then add moon conditions to the condition tree.
| Condition | Description |
|---|---|
| Moon Phase Index | Pick a phase and the moon it applies to |
| Moon Phase Position | Compare the moon’s numeric position in its cycle |
| Moon Sub-Phase | Match Rising, True, or Fading for the selected moon |
Moon-phase count conditions are also available. There is no standalone repeat-pattern selector for moon phases.
See Notes and Events for recurrence patterns.