Namespace: Hooks
SimpleCalendar.Hooks
The SimpleCalendar.Hooks property contains a list of all hooks that the Simple Calendar module can emit, when they are emitted and what information they pass along.
Interfaces
Variables
ClockStartStop
• Const ClockStartStop: "simple-calendar-clock-start-stop"
This hook is emitted in the following cases:
- When the clock is started.
- When the clock is stopped.
- When the game is paused or unpaused.
- When a combat is started or ended in the active scene
- When a combat round is advanced.
What is passed: When this hook is emitted it will pass a ClockStatus object.
Examples:
example How to listen for the hook:
Hooks.on(SimpleCalendar.Hooks.ClockStartStop, (data) => {
console.log(data);
});
example Response Data:
{
"started": false,
"stopped": true,
"paused": false
}
DateTimeChange
• Const DateTimeChange: "simple-calendar-date-time-change"
This hook is emitted any time the current date is updated. The current date can be updated by several means:
- When the GM clicks on the "Set Current Date" button after adjusting the current date.
- When the clock is running every interval update.
- When the SimpleCalendar.api.setDate function is called.
- When the SimpleCalendar.api.changeDate function is called.
- When the game world time changed and Simple Calendar is configured to update when that changes.
What is passed: When this hook is emitted it will pass a DateChangeResponse object.
Examples:
example How to listen for the hook:
Hooks.on(SimpleCalendar.Hooks.DateTimeChange, (data) => {
console.log(data);
});
example Response Data:
{
"date": {
"year": 2021,
"month": 6,
"dayOffset": 0,
"day": 8,
"dayOfTheWeek": 5,
"hour": 0,
"minute": 15,
"second": 30,
"yearZero": 1970,
"weekdays": [
"Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday"
],
"showWeekdayHeadings": true,
"currentSeason": {
"color": "#f3fff3",
"startingMonth": 5,
"startingDay": 19,
"name": "Summer"
},
"isLeapYear": false,
"monthName": "July",
"dayDisplay": "9",
"yearName": "",
"yearPrefix": "",
"yearPostfix": "",
"display": {
"day": "9",
"daySuffix": "th",
"weekday": "Friday",
"monthName": "July",
"month": "7",
"year": "2021",
"yearName": "",
"yearPrefix": "",
"yearPostfix": "",
"time": "00:15:30"
}
},
"diff": 1,
"moons": [
{
"name": "Moon",
"color": "#ffffff",
"cycleLength": 29.53059,
"cycleDayAdjust": 0.5,
"currentPhase": {
"name": "New Moon",
"length": 1,
"icon": "new",
"singleDay": true
}
}
],
"season": {
"name": "Summer",
"color": "#f3fff3"
},
"month": {
"name": "July",
"number": 7,
"intercalary": false,
"numberOfDays": 31,
"numberOfLeapYearDays": 31
},
"day": {
"number": 9
},
"time": {
"hour": "00",
"minute": "15",
"second": "30"
},
"year": {
"number": 2021,
"prefix": "",
"postfix": "",
"isLeapYear": false
}
}
PrimaryGM
• Const PrimaryGM: "simple-calendar-primary-gm"
This hook is emitted when the current users is promoted to the primary GM role.
This will happen 5 seconds after loading the game if no other GM is currently in the primary role.
What is passed: When this hook is emitted it will pass a IsPrimaryGmResponse object.
Examples:
example How to listen for the hook:
Hooks.on(SimpleCalendar.Hooks.PrimaryGM, (data) => {
console.log(data);
});
example Response Data:
{
"isPrimaryGM": true
}
Ready
• Const Ready: "simple-calendar-ready"
This hook is emitted when Simple Calendar is fully initialized and ready to use.
For GMs this will happen up to 5 seconds after loading the game as additional checks are done to see which GM is to be considered the primary GM.
What is passed: No data is passed when this hook is fired.
Examples:
example How to listen for the hook:
Hooks.on(SimpleCalendar.Hooks.Ready, () => {
console.log(`Simple Calendar is ready!`);
});