Cue Triggers Explained

NORTHSTARSHOW SYSTEMS

Cue Triggers Explained

All six hat block types with usage notes

Manual GO (event-manual)

Fires only when the operator clicks GO in Cuemaster or when an external system calls POST /api/cues/:id/go. Useful for opening sequences, preview cues, demo runs, and any effect that must be operator-initiated.

Input Event (event-input)

Fires when a specific input pin on a specific node transitions to active. The hat references nodeId and inputId. Most commonly used with PIR sensors, mushroom buttons, and end-stop switches.

NOTE —Input events are subject to the configured debounce window on the node — pulses shorter than the debounce duration are ignored.

Input Combo (event-input-combo)

Fires when multiple inputs activate together. Two modes:

• simultaneous — all listed inputs activate within windowMs of each other
• held — all listed inputs are currently active and have been for windowMs

Used for maintenance combos (key + reset), two-handed safety holds, and gesture-based triggers.

Schedule (event-schedule)

Fires when a cron-style schedule matches the current time. References a schedule object in the project's schedules array. Used for opening / closing music, sunset light cues, automatic re-armings.

Cue Complete (event-cue-complete)

Fires when another cue finishes. The hat references the parent cueId. Used to build sequences without nesting block scripts.

Cuemaster Event (event-cuemaster)

Fires when a Cuemaster event with the matching key is sent. References nodeId (the Cuemaster node) and eventKey. Used for operator-driven mid-show transitions — for example, "advance to scene 3" or "send a guest to the exit hallway".

Multiple Hats on One Cue

A cue has exactly one hat block. To trigger the same behaviour from multiple events, create separate cues that fire the same sequence — or use a single sequence and reference it from multiple hatted cues.

Related Documents

• NSSS-DOC-0060Block Programming Concepts
• NSSS-DOC-0061Block Type Reference
• NSSS-DOC-0063Sequences and Schedules

Revision History