Chat Commands

Calendaria adds 22 slash commands. They work with no other module installed. Chat Commander adds autocomplete and an icon per command on top.

Command list

Command	Alias	Description	Permission
/date	/d	Display current date	Everyone
/time	/t	Display current time	Everyone
/datetime	/dt	Display current date and time	Everyone
/today		List today’s notes	Everyone
/sunrise		Display today’s sunrise time	Everyone
/sunset		Display today’s sunset time	Everyone
/moon		Display current moon phases	Everyone
/season		Display current season	Everyone
/weather		Display current or historical weather	Everyone
/forecast	/fc	Display weather forecast	viewWeatherForecast
/weatherprob	/wp	Display weather probability breakdown	viewWeatherForecast
/weekday		Display current weekday	Everyone
/festival		Display current festival	Everyone
/cycle	/zodiac	Display zodiac/cycle values	Everyone
/calendar	/cal	Display full calendar summary	Everyone
/calendars	/cals	List all available calendars	Everyone
/note	/n	Create a quick note	addNotes
/advance	/adv	Advance time	changeDateTime
/setdate		Set date (year month day)	changeDateTime
/settime		Set time (hour minute [second])	changeDateTime
/switchcal		Switch active calendar	changeActiveCalendar
/enrichers		Open the enricher reference journal	Everyone

The names in that column are Calendaria’s own permission gates, configured on the Permissions page.

Date and time

/date, /time, and /datetime post the current date, the current time, or both. Each takes an optional format preset or a custom string built from format tokens.

/date
/date dateLong
/time HH:mm:ss
/datetime EEEE, D MMMM Y - h:mm A

Sunrise and sunset

/sunrise and /sunset post today’s times and take the same optional format argument.

/sunrise
/sunset h:mm A

Both read the climate zone of the active scene and fall back to the calendar’s active zone, so the times change with the zone as well as the date.

Calendar information

/today

Lists today’s notes. Timed notes show their start time; all-day notes show none.

/moon

Posts every moon’s name and current phase. Pass a zero-based index for a single moon.

/moon
/moon 0

Moons hidden from players are skipped for non-GM users. A player who asks for a hidden moon by index gets the no-moons message.

/season

Posts the current season name and icon.

/weekday

Posts the current weekday, marked as a rest day where the calendar defines one.

/festival

Posts the current festival. On a day with none, it reports “No festival today.”

/cycle

Posts every active cycle value for the current date.

/calendar

Posts date, time, season, weather, moon phases, and daylight hours in one summary message.

/calendars

Lists every configured calendar with a check mark on the active one.

Weather

/weather and /forecast read the climate zone of the active scene and fall back to the calendar’s active zone. /weatherprob ignores the scene override and reads the calendar’s active zone.

/weather

/weather
/weather 1492 7 15

With no argument, /weather posts the weather icon, condition label, and temperature. Pass year month day to look up a historical date; that form also prefixes the requested date and appends the wind speed label when the wind is above calm. Neither form reports precipitation.

/forecast

/forecast
/forecast 14

Posts one line per upcoming day with an icon, day number, weather label, and temperature, under a zone name subtitle. The optional day count is clamped to the Forecast Days setting (see Settings), so asking for more days returns the configured maximum. Omit the count to forecast the full configured length.

Requires the viewWeatherForecast permission. Auto-Generate Weather must also be on; with it off the command reports that no forecast is available, whatever the permission.

A GM sees the exact planned forecast; a non-GM user sees variance-adjusted results. The message is whispered when a GM runs it and public when a permitted non-GM runs it. Run through Chat Commander, the whisper is dropped.

/weatherprob

/weatherprob
/weatherprob Winter

Posts each weather preset’s probability percentage and the temperature range, under a zone and season subtitle. Pass a season name to read a season other than the current one. Permission, the Auto-Generate Weather requirement, and the whisper behavior match /forecast.

/note

/note "Meeting with the Council"
/note "Dragon Attack" "The red dragon Scorlax attacked the village"

The first argument is the title, the second is the content. Quotes are needed only when you pass content as well; unquoted text becomes the whole title.

Nothing is posted to chat. The note sheet opens in edit mode and a confirmation notification appears. The note is created as a timed event at the current in-game date and time, in the event category, and visible to players. Change any of that in the sheet.

Requires the addNotes permission and an active calendar. Without the permission, the user gets a no-access warning and no note. A user who cannot create journal entries in Foundry sends a socket request to the GM instead.

Changing time and calendar

/advance, /setdate, /settime, and /switchcal post nothing to chat. Each shows a confirmation notification instead. A non-GM holding the required permission sends a socket request to the GM to apply the change.

/advance

Takes an amount and a unit, plus an optional cinematic=true or cinematic=false to override the configured cinematic threshold.

/advance 2 hours
/advance 30 m
/advance 10 rounds
/advance 1 week cinematic=true
/advance 8 hours cinematic=false

Unit	Aliases
second	seconds, sec, secs, s
minute	minutes, min, mins, m
hour	hours, hr, hrs, h
day	days, d
week	weeks, w
month	months, mo
year	years, yr, yrs, y
round	rounds, rd

Requires the changeDateTime permission.

/setdate

/setdate 1492 3 15

Takes a year, a month, and a day. Month and day are both 1-indexed. Requires the changeDateTime permission.

/settime

/settime 14 30
/settime 14 30 0

Takes an hour and a minute, with an optional second. Requires the changeDateTime permission.

/switchcal

/switchcal forgotten-realms

Takes a calendar ID. Requires the changeActiveCalendar permission.

/enrichers

Opens the enricher reference journal, which lists every text enricher with a live example, and posts a short confirmation to chat. The first run creates the journal and needs Foundry’s Create Journal Entries permission; later runs reopen the existing one.

Chat Commander integration

With Chat Commander active, Calendaria registers its commands with an icon each and these autocomplete suggestions:

• Format presets for /date, /time, /datetime, /sunrise, and /sunset, plus a hint pointing at the format token reference
• Usage forms for /weather, covering the current-weather and historical-date variants
• Common amounts for /advance, plus cinematic=true and cinematic=false once an amount and unit are typed
• Day counts for /forecast, up to the Forecast Days setting
• Season names from the active calendar for /weatherprob
• The calendar list for /switchcal

/advance, /setdate, /settime, and /switchcal are registered as GM-only, so they do not appear in a non-GM’s Chat Commander menu. Their callbacks gate on the matching Calendaria permission rather than on GM status.