The Moons tab allows for the adding and editing on moons in your calendar.

To create a moon, enter a name for it in the Moon name, and press the + button. You can type a number in the cycle and shift inputs, but those are not needed to create the moon. If you create a moon without these settings, the average month length will be used for the cycle, allowing for quick creation.

Once a moon has been created, it is added to the list below.


Moons in Fantasy Calendar are displayed each on each day, and the moon image is determined by its cycle and its shift.


The cycle is how many days it takes for the moon to complete a full cycle. On Earth, our moon takes 29.53 days to complete a full lunar cycle (to be exact, 29.530588853).


You can also change which phase that the moon starts on with the shift input. If you want to line up a moon to a specific cycle or match a full moon to a specific date, this input will shift the moon's phases in either a negative or positive direction. Each whole number in the shift represents a day that the moon's phases have been moved.


As noted above, the moon cycle and shift can be fractional numbers, meaning that at some point, the calendar has to round that number one way or another to get a specific moon image. This setting allow you to tweak which way it rounds the numbers, which can have a small impact which moons actually appear on your calendar.

In case you're unfamiliar with the different styles of rounding, here's a quick reference:

Style Behavior Example
Floor Always round down 0.1 through 0.99999 becomes 0.0.
Round Rounds half up, half down 0.1 through 0.49 becomes 0.0, 0.5 through 0.999999 becomes 1.0, 0.9 becomes 1.0
Cieling Always round up 0.1 through 0.99999 becomes 1.0.

Custom phase count

This setting is for advanced users wanting exact moon phase control. By clicking this, the cycle, shift, and rounding options will disappear, and is replaced with a long input. In this input, you can enter any number between 0 and 39, each one representing a specific moon phase. As the moon system is self-adjusting, the highest number that you enter into this field makes it pick from different set of moon images.


As you can see above, the number you input determines which image set the moon will use. For example, if the highest number you have put in is 7, then you will get the second row, as the number is below 8.

These are some example inputs:

Input: 0,0,2,2,0,0,1,1,3,3
Output: New Moon, New Moon, Full Moon, Full Moon, First Quarter, First Quarter, Last Quarter, Last Quarter
Granularity: 4
Input: 0,0,1,2,3,4,4,5,6,7
Output: New Moon, New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Full Moon, Waning Gibbous, Last Quarter, Waning Crescent
Granularity: 8


This setting is for changing the color of the moon when it is displayed in the calendar. The Moon Color determines what the color of light-facing side will be, and the Shadow Color determines what color the dark side of the moon will be.

Hide from players

This setting will make this moon hidden from anyone viewing your calendar without the appropriate privileges.