Emergency API
The emergency system allows scripted handling of in-flight emergencies. See Emergencies for full documentation.
onEmergencyDeclared(callback)
Called when a pilot declares an emergency.
Parameters:
callback: (event: EmergencyDeclarationEvent) => void
EmergencyDeclarationEvent object:
javascript
{
emergency: Emergency, // Emergency object
pilotMessage: string // Full pilot declaration
}Example:
javascript
onEmergencyDeclared((event) => {
log(`EMERGENCY: ${event.emergency.callsign}`);
log(`Type: ${event.emergency.type}`);
log(`Severity: ${event.emergency.severity}`);
log(`Nature: ${event.emergency.nature}`);
log(`Pilot says: ${event.pilotMessage}`);
});onEmergencyUpdate(callback)
Called when an emergency status changes.
Parameters:
callback: (event: EmergencyUpdateEvent) => void
EmergencyUpdateEvent object:
javascript
{
emergency: Emergency, // Emergency object
callsign: string, // Aircraft callsign
previousStatus: string, // Previous status
newStatus: string // New status
}Example:
javascript
onEmergencyUpdate((event) => {
log(`${event.callsign}: ${event.previousStatus} -> ${event.newStatus}`);
});onEmergencyResolved(callback)
Called when an emergency is resolved.
Parameters:
callback: (event: EmergencyResolvedEvent) => void
EmergencyResolvedEvent object:
javascript
{
emergency: Emergency, // Emergency object
resolutionTimeMs: number // Time to resolve (milliseconds)
}Example:
javascript
onEmergencyResolved((event) => {
const seconds = Math.round(event.resolutionTimeMs / 1000);
log(`${event.emergency.callsign} resolved in ${seconds}s`);
});See Emergency for the full emergency object definition.