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

• DateChangeResponse
• IsPrimaryGmResponse

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);
});

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 setDate function is called.
• When the 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);
});

Response Data:

{
  "date": {
    "year": 2021,
    "month": 6,
    "dayOffset": 0,
    "day": 8,
    "dayOfTheWeek": 5,
    "hour": 0,
    "minute": 15,
    "second": 30,
    "yearZero": 1970,
    "sunrise": 1622527200,
    "sunset": 1622570400,
    "midday": 1622548800,
    "weekdays": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "showWeekdayHeadings": true,
    "currentSeason": {
      "color": "#f3fff3",
      "startingMonth": 5,
      "startingDay": 19,
      "name": "Summer"
    },
    "isLeapYear": false,
    "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
      }
    }
  ]
}

---

Init

• Const Init: "simple-calendar-init"

This hook is emitted while Simple Calendar is initializing, before the module is ready to use.

What is passed: No data is passed when this hook is fired.

Examples:

Example

How to listen for the hook:

Hooks.on(SimpleCalendar.Hooks.Init, () => {
   console.log(`Simple Calendar is initializing!`);
});

---

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);
});

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!`);
});