Overview The Match class is the central data model that orchestrates all match-related data, including teams, players, rounds, timeouts, and event processing. Each match instance represents a single game session and manages the lifecycle from match start to completion.
Match Class export class Match { // Identification public matchId : string = "" ; public groupCode : string ; public groupSecret : string ; public organizationId : string = "" ; public isRegistered : boolean = false ; // Match State public isRunning : boolean = false ; public roundNumber : number = 0 ; public roundPhase : string = "LOBBY" ; public eventNumber : number = 1 ; // Teams and Players private teams : Team [] = []; private map : string = "Loading" ; // Game Configuration private matchType : "bomb" | "swift" | string = "bomb" ; private switchRound : number = 13 ; private firstOtRound : number = 25 ; // Round State private roundTimeoutTime ?: number ; private wasTimeout : boolean = false ; private agentSelectStartTime ?: number ; // Spike State private spikeState : SpikeStates ; private spikeDetonationTime ?: number ; private attackersWon : boolean = false ; // Timeout Management private timeoutState : TimeoutStates ; private timeoutEndTimeout : any ; private timeoutRemainingLoop : any ; private timeoutGracePeriodPassed : boolean = false ; // Tools and Configuration private tools : ToolsData ; private showAliveKDA : boolean = false ; // Replay and Logging private replayLog : ReplayLogging ; private hasEnteredOvertime : boolean = false ; private orgIsSupporter : boolean = false ; }
Properties Unique identifier for the match received from the game client.
Unique code that identifies the match session for client connections.
12-character alphanumeric secret for secure match access. Auto-generated.
Indicates whether the match is currently active.
Current round number (1-indexed).
Current phase of the round.
LOBBY: Waiting for match to startshopping: Buy phase at round startcombat: Active round gameplayend: Round has endedgame_end: Match has concluded Incremental counter for tracking events throughout the match.
Array containing exactly two team instances (left and right).
Current map name (translated from internal names).
Game mode type.
bomb: Standard competitive mode (13-round halves, OT at 25)swift: Swiftplay mode (5-round halves) Constructor constructor ( data : IAuthenticationData )
Initializes a new match with authentication data from the observer client.
data
IAuthenticationData
required
Authentication payload containing: Show Authentication Data Fields
groupCode: Session identifierleftTeam: Left team configurationrightTeam: Right team configurationtoolsData: Tournament and display settingsorganizationId: Optional organization identifierisSupporter: Whether the organization has Spectra Plus Core Methods receiveMatchSpecificData async receiveMatchSpecificData ( data : IAuthedData | IAuthedAuxData ): Promise < void >
Processes incoming event data from observer and auxiliary clients. This is the primary data ingestion method.
data
IAuthedData | IAuthedAuxData
required
Authenticated event data with type discriminator.
SCOREBOARD: Player stats and equipment updatesROSTER: Agent selection and player infoKILLFEED: Kill events and assistsOBSERVING: Camera focus changesSCORE: Round score updatesROUND_INFO: Round phase and number changesMATCH_START: Match initializationMAP: Map selectionGAME_MODE: Mode configurationTECH_PAUSE: Technical pause toggleLEFT_TIMEOUT / RIGHT_TIMEOUT: Team timeout requestsSPIKE_PLANTED / SPIKE_DETONATED / SPIKE_DEFUSED: Spike eventsAUX_*: Auxiliary data from player clients Behavior:
Routes data to appropriate team/player instances
Updates match state based on event type
Increments eventNumber after processing
Writes all events to replay log
Manages database sync for registered matches
setAuxDisconnected public setAuxDisconnected ( playerId : string ): void
Marks auxiliary data sources as disconnected for a specific player.
State Interfaces SpikeStates export interface SpikeStates { planted : boolean ; detonated : boolean ; defused : boolean ; }
Whether the spike has been planted this round.
Whether the spike has detonated.
Whether the spike has been defused.
TimeoutStates export interface TimeoutStates { techPause : boolean ; leftTeam : boolean ; rightTeam : boolean ; timeRemaining : number ; }
Whether a technical pause is active (not team-initiated).
Whether the left team has an active timeout.
Whether the right team has an active timeout.
Seconds remaining in the current timeout.
Lifecycle Events Match Start When MATCH_START is received:
Sets isRunning = true
Stores the match ID
Registers with database (if backend enabled)
Initializes stats tracking (for supporters)
Round Transitions On shopping phase:
Processes previous round results
Resets spike states
Handles side switches (round 13 and OT rounds)
Grants overtime timeouts
Updates database
Match End When game_end is received:
Sets isRunning = false
Clears timeout timers
Removes match from controller
Completes database record
Triggers stats processing (for supporters)
Example Usage // Match is created on authentication const authData : IAuthenticationData = { type: DataTypes . AUTH , clientVersion: "1.0.0" , obsName: "Observer1" , key: "auth-key" , groupCode: "ABC123" , leftTeam: { name: "Team Alpha" , tricode: "ALP" , url: "https://example.com/alpha.png" , attackStart: true }, rightTeam: { name: "Team Beta" , tricode: "BTA" , url: "https://example.com/beta.png" , attackStart: false }, toolsData: new ToolsData () }; const match = new Match ( authData ); // Process incoming events await match . receiveMatchSpecificData ({ obsName: "Observer1" , groupCode: "ABC123" , type: DataTypes . MATCH_START , timestamp: Date . now (), data: "match-uuid-12345" }); await match . receiveMatchSpecificData ({ obsName: "Observer1" , groupCode: "ABC123" , type: DataTypes . ROUND_INFO , timestamp: Date . now (), data: { roundNumber: 1 , roundPhase: "shopping" } });
Internal Mechanisms Show Spike Plant Detection
The match automatically detects spike plants by monitoring player money increases:
If a player receives exactly 300 credits during combat phase
Sets spike planted state and starts 45-second detonation timer
Can also receive explicit SPIKE_PLANTED events from hotkeys
Show Round Reason Tracking
After each round, the match determines win conditions:
Attackers won by detonation or elimination
Defenders won by defusal, timeout, or elimination
Stores results in team round records
Timeouts include grace period cancellation:
Teams start with 2 timeouts (max configurable)
Timeouts last 60 seconds by default
10-second grace period allows free cancellation
Teams gain +1 timeout when entering overtime (round 25)
Show Name Overrides & Playercams
For organizations with playercam integration:
Fetches overrides and enabled players from database
Updates at round start
Requires identifier and secret from playercamsInfo