import ipAnonymize from "ip-anonymize"; import { Logger } from "winston"; import WebSocket from "ws"; import { z } from "zod"; import { isAdminRole } from "../core/ApiSchemas"; import { GameEnv, ServerConfig } from "../core/configuration/Config"; import { GameType } from "../core/game/Game"; import { ClientID, ClientMessageSchema, ClientSendWinnerMessage, GameConfig, GameInfo, GameStartInfo, GameStartInfoSchema, PlayerRecord, PublicGameType, ServerDesyncSchema, ServerErrorMessage, ServerLobbyInfoMessage, ServerPrestartMessageSchema, ServerStartGameMessage, ServerTurnMessage, StampedIntent, Turn, } from "../core/Schemas"; import { createPartialGameRecord } from "../core/Util"; import { archive, finalizeGameRecord } from "./Archive"; import { Client } from "./Client"; import { ClientMsgRateLimiter } from "./ClientMsgRateLimiter"; export enum GamePhase { Lobby = "LOBBY", Active = "ACTIVE", Finished = "FINISHED", } const KICK_REASON_DUPLICATE_SESSION = "kick_reason.duplicate_session"; const KICK_REASON_LOBBY_CREATOR = "kick_reason.lobby_creator"; const KICK_REASON_ADMIN = "kick_reason.admin"; const KICK_REASON_HOST_LEFT = "kick_reason.host_left"; const KICK_REASON_TOO_MUCH_DATA = "kick_reason.too_much_data"; const KICK_REASON_INVALID_MESSAGE = "kick_reason.invalid_message"; export class GameServer { private sentDesyncMessageClients = new Set(); private intentRateLimiter = new ClientMsgRateLimiter(); private maxGameDuration = 3 * 60 * 60 * 1000; // 3 hours private disconnectedTimeout = 1 * 30 * 1000; // 30 seconds private turns: Turn[] = []; private intents: StampedIntent[] = []; public activeClients: Client[] = []; private allClients: Map = new Map(); // Map persistentID to clientID for reconnection lookup private persistentIdToClientId: Map = new Map(); private clientsDisconnectedStatus: Map = new Map(); private _hasStarted = false; private _startTime: number | null = null; private hasReachedMaxPlayerCount: boolean = false; private endTurnIntervalID: ReturnType | undefined; private lastPingUpdate = 0; private winner: ClientSendWinnerMessage | null = null; // Note: This can be undefined if accessed before the game starts. private gameStartInfo!: GameStartInfo; private log: Logger; private _hasPrestarted = false; private kickedPersistentIds: Set = new Set(); private outOfSyncClients: Set = new Set(); private isPaused = false; private websockets: Set = new Set(); private winnerVotes: Map< string, { winner: ClientSendWinnerMessage; ips: Set } > = new Map(); private _hasEnded = false; private lobbyInfoIntervalId: ReturnType | null = null; private visibleAt?: number; constructor( public readonly id: string, readonly log_: Logger, public readonly createdAt: number, private config: ServerConfig, public gameConfig: GameConfig, private creatorPersistentID?: string, private startsAt?: number, private publicGameType?: PublicGameType, ) { this.log = log_.child({ gameID: id }); if (startsAt !== undefined) { this.visibleAt = Date.now(); } } private get lobbyCreatorID(): ClientID | undefined { return this.creatorPersistentID ? this.persistentIdToClientId.get(this.creatorPersistentID) : undefined; } public updateGameConfig(gameConfig: Partial): void { if (gameConfig.gameMap !== undefined) { this.gameConfig.gameMap = gameConfig.gameMap; } if (gameConfig.gameMapSize !== undefined) { this.gameConfig.gameMapSize = gameConfig.gameMapSize; } if (gameConfig.difficulty !== undefined) { this.gameConfig.difficulty = gameConfig.difficulty; } if (gameConfig.nations !== undefined) { this.gameConfig.nations = gameConfig.nations; } if (gameConfig.bots !== undefined) { this.gameConfig.bots = gameConfig.bots; } if (gameConfig.infiniteGold !== undefined) { this.gameConfig.infiniteGold = gameConfig.infiniteGold; } if (gameConfig.donateGold !== undefined) { this.gameConfig.donateGold = gameConfig.donateGold; } if (gameConfig.infiniteTroops !== undefined) { this.gameConfig.infiniteTroops = gameConfig.infiniteTroops; } if (gameConfig.donateTroops !== undefined) { this.gameConfig.donateTroops = gameConfig.donateTroops; } if (gameConfig.maxTimerValue !== undefined) { this.gameConfig.maxTimerValue = gameConfig.maxTimerValue ?? undefined; } if (gameConfig.instantBuild !== undefined) { this.gameConfig.instantBuild = gameConfig.instantBuild; } if (gameConfig.randomSpawn !== undefined) { this.gameConfig.randomSpawn = gameConfig.randomSpawn; } if (gameConfig.spawnImmunityDuration !== undefined) { this.gameConfig.spawnImmunityDuration = gameConfig.spawnImmunityDuration ?? undefined; } if (gameConfig.gameMode !== undefined) { this.gameConfig.gameMode = gameConfig.gameMode; } if (gameConfig.disabledUnits !== undefined) { this.gameConfig.disabledUnits = gameConfig.disabledUnits; } if (gameConfig.playerTeams !== undefined) { this.gameConfig.playerTeams = gameConfig.playerTeams; } if (gameConfig.goldMultiplier !== undefined) { this.gameConfig.goldMultiplier = gameConfig.goldMultiplier ?? undefined; } if (gameConfig.startingGold !== undefined) { this.gameConfig.startingGold = gameConfig.startingGold ?? undefined; } if (gameConfig.disableAlliances !== undefined) { this.gameConfig.disableAlliances = gameConfig.disableAlliances ?? undefined; } if (gameConfig.waterNukes !== undefined) { this.gameConfig.waterNukes = gameConfig.waterNukes ?? undefined; } this.gameConfig.hostCheats = gameConfig.hostCheats; } private isKicked(clientID: ClientID): boolean { const persistentID = this.allClients.get(clientID)?.persistentID; return ( persistentID !== undefined && this.kickedPersistentIds.has(persistentID) ); } // Get existing clientID for this persistentID, or null if new player public getClientIdForPersistentId(persistentID: string): ClientID | null { const clientID = this.persistentIdToClientId.get(persistentID); if (!clientID) return null; if (this.kickedPersistentIds.has(persistentID)) return null; return clientID; } public joinClient(client: Client): "joined" | "kicked" | "rejected" { if (this.kickedPersistentIds.has(client.persistentID)) { return "kicked"; } if ( this.gameConfig.maxPlayers && this.activeClients.length >= this.gameConfig.maxPlayers ) { this.log.warn(`cannot add client, game full`, { clientID: client.clientID, }); client.ws.send( JSON.stringify({ type: "error", error: "full-lobby", } satisfies ServerErrorMessage), ); return "rejected"; } this.log.info("client joining game", { clientID: client.clientID, persistentID: client.persistentID, clientIP: ipAnonymize(client.ip), }); if ( this.gameConfig.gameType === GameType.Public && this.activeClients.filter( (c) => c.ip === client.ip && c.clientID !== client.clientID, ).length >= 3 ) { this.log.warn("cannot add client, already have 3 ips", { clientID: client.clientID, clientIP: ipAnonymize(client.ip), }); return "rejected"; } if (this.config.env() === GameEnv.Prod) { // Prevent multiple clients from using the same account in prod const conflicting = this.activeClients.find( (c) => c.persistentID === client.persistentID && c.clientID !== client.clientID, ); if (conflicting !== undefined) { this.log.warn("client ids do not match", { clientID: client.clientID, clientIP: ipAnonymize(client.ip), clientPersistentID: client.persistentID, existingIP: ipAnonymize(conflicting.ip), existingPersistentID: conflicting.persistentID, }); // Kick the existing client instead of the new one, because this was causing issues when // a client wanted to replay the game afterwards. this.kickClient(conflicting.clientID, KICK_REASON_DUPLICATE_SESSION); } } // Client connection accepted this.websockets.add(client.ws); this.persistentIdToClientId.set(client.persistentID, client.clientID); this.activeClients.push(client); client.lastPing = Date.now(); this.markClientDisconnected(client.clientID, false); this.allClients.set(client.clientID, client); this.addListeners(client); this.startLobbyInfoBroadcast(); if (this.activeClients.length >= (this.gameConfig.maxPlayers ?? Infinity)) { this.hasReachedMaxPlayerCount = true; } // In case a client joined the game late and missed the start message. if (this._hasStarted) { this.sendStartGameMsg(client.ws, 0); } return "joined"; } // Attempt to reconnect a client by persistentID. Returns true if successful. // WebSocket is always updated. Optional identity updates are applied only // before the game has started. public rejoinClient( ws: WebSocket, persistentID: string, lastTurn: number = 0, identityUpdate?: { username: string; clanTag: string | null }, ): boolean { const clientID = this.getClientIdForPersistentId(persistentID); if (!clientID) return false; const client = this.allClients.get(clientID); if (!client) return false; this.websockets.add(ws); this.log.info("client rejoining", { clientID, lastTurn }); // Close old WebSocket to prevent resource leaks if (client.ws !== ws) { client.ws.removeAllListeners(); client.ws.close(); } this.activeClients = this.activeClients.filter( (c) => c.clientID !== client.clientID, ); this.activeClients.push(client); if (identityUpdate && !this.hasStarted()) { client.username = identityUpdate.username; client.clanTag = identityUpdate.clanTag; } client.lastPing = Date.now(); this.markClientDisconnected(client.clientID, false); client.ws = ws; this.addListeners(client); this.startLobbyInfoBroadcast(); if (this._hasStarted) { this.sendStartGameMsg(client.ws, lastTurn); } return true; } private addListeners(client: Client) { client.ws.removeAllListeners("message"); client.ws.on("message", async (message: string) => { try { let json: unknown; try { json = JSON.parse(message); } catch (e) { this.log.warn(`Failed to parse client message JSON, kicking`, { clientID: client.clientID, error: String(e), }); this.kickClient(client.clientID, KICK_REASON_INVALID_MESSAGE); return; } const parsed = ClientMessageSchema.safeParse(json); if (!parsed.success) { this.log.warn(`Failed to parse client message, kicking`, { clientID: client.clientID, error: z.prettifyError(parsed.error), }); this.kickClient(client.clientID, KICK_REASON_INVALID_MESSAGE); return; } const clientMsg = parsed.data; const bytes = Buffer.byteLength(message, "utf8"); const intentType = clientMsg.type === "intent" ? clientMsg.intent.type : undefined; const rateResult = this.intentRateLimiter.check( client.clientID, clientMsg.type, bytes, intentType, ); if (rateResult === "kick") { this.log.warn(`Client rate limit exceeded, kicking`, { clientID: client.clientID, type: clientMsg.type, }); this.kickClient(client.clientID, KICK_REASON_TOO_MUCH_DATA); return; } if (rateResult === "limit") { this.log.warn(`Client message rate limit exceeded, dropping`, { clientID: client.clientID, type: clientMsg.type, }); return; } switch (clientMsg.type) { case "rejoin": { // Client is already connected, no auth required, send start game message if game has started if (this._hasStarted) { this.sendStartGameMsg(client.ws, clientMsg.lastTurn); } break; } case "intent": { // Server stamps clientID from the authenticated connection const stampedIntent = { ...clientMsg.intent, clientID: client.clientID, }; switch (stampedIntent.type) { case "mark_disconnected": { this.log.warn( `Should not receive mark_disconnected intent from client`, ); return; } // Handle kick_player intent via WebSocket case "kick_player": { const isLobbyCreator = client.clientID === this.lobbyCreatorID; const isAdmin = isAdminRole(client.role); // Check if the authenticated client is the lobby creator or admin if (!isLobbyCreator && !isAdmin) { this.log.warn( `Only lobby creator or admin can kick players`, { clientID: client.clientID, creatorID: this.lobbyCreatorID, target: stampedIntent.target, gameID: this.id, }, ); return; } // Don't allow kicking yourself if (client.clientID === stampedIntent.target) { this.log.warn(`Cannot kick yourself`, { clientID: client.clientID, }); return; } // Log and execute the kick this.log.info(`Player initiated kick`, { kickerID: client.clientID, isAdmin, target: stampedIntent.target, gameID: this.id, kickMethod: "websocket", }); this.kickClient( stampedIntent.target, isAdmin && !isLobbyCreator ? KICK_REASON_ADMIN : KICK_REASON_LOBBY_CREATOR, ); return; } case "update_game_config": { // Only lobby creator can update config if (client.clientID !== this.lobbyCreatorID) { this.log.warn(`Only lobby creator can update game config`, { clientID: client.clientID, creatorID: this.lobbyCreatorID, gameID: this.id, }); return; } if (this.isPublic()) { this.log.warn(`Cannot update public game via WebSocket`, { gameID: this.id, clientID: client.clientID, }); return; } if (this.hasStarted()) { this.log.warn( `Cannot update game config after it has started`, { gameID: this.id, clientID: client.clientID, }, ); return; } if (stampedIntent.config.gameType === GameType.Public) { this.log.warn(`Cannot update game to public via WebSocket`, { gameID: this.id, clientID: client.clientID, }); return; } this.log.info( `Lobby creator updated game config via WebSocket`, { creatorID: client.clientID, gameID: this.id, }, ); this.updateGameConfig(stampedIntent.config); return; } case "start_game": { if (client.clientID !== this.lobbyCreatorID) { this.log.warn(`Only lobby creator can start game`, { clientID: client.clientID, creatorID: this.lobbyCreatorID, gameID: this.id, }); return; } if (this.isPublic()) { this.log.warn(`Cannot start public game via WebSocket`, { gameID: this.id, }); return; } if (this.hasStarted()) { this.log.warn(`Cannot start game that has already started`, { gameID: this.id, clientID: client.clientID, }); return; } this.log.info(`Lobby creator starting game via WebSocket`, { creatorID: client.clientID, gameID: this.id, }); this.start(); return; } case "toggle_pause": { // Only lobby creator can pause/resume if (client.clientID !== this.lobbyCreatorID) { this.log.warn(`Only lobby creator can toggle pause`, { clientID: client.clientID, creatorID: this.lobbyCreatorID, gameID: this.id, }); return; } if (stampedIntent.paused) { // Pausing: send intent and complete current turn before pause takes effect this.addIntent(stampedIntent); this.endTurn(); this.isPaused = true; } else { // Unpausing: clear pause flag before sending intent so next turn can execute this.isPaused = false; this.addIntent(stampedIntent); this.endTurn(); } this.log.info(`Game ${this.isPaused ? "paused" : "resumed"}`, { clientID: client.clientID, gameID: this.id, }); break; } default: { // Don't process intents while game is paused if (!this.isPaused) { this.addIntent(stampedIntent); } break; } } break; } case "ping": { this.lastPingUpdate = Date.now(); client.lastPing = Date.now(); break; } case "hash": { client.hashes.set(clientMsg.turnNumber, clientMsg.hash); break; } case "winner": { this.handleWinner(client, clientMsg); break; } default: { this.log.warn(`Unknown message type: ${(clientMsg as any).type}`, { clientID: client.clientID, }); break; } } } catch (error) { this.log.info( `error handline websocket request in game server: ${error}`, { clientID: client.clientID, }, ); } }); client.ws.on("close", () => { this.log.info("client disconnected", { clientID: client.clientID, persistentID: client.persistentID, }); this.activeClients = this.activeClients.filter( (c) => c.clientID !== client.clientID, ); // Close lobby when host leaves before game starts if ( !this._hasStarted && !this.isPublic() && client.persistentID === this.creatorPersistentID ) { this.log.info("Host left, closing lobby", { gameID: this.id, }); for (const c of [...this.activeClients]) { this.kickClient(c.clientID, KICK_REASON_HOST_LEFT); } this._hasEnded = true; } }); client.ws.on("error", (error: Error) => { if ((error as any).code === "WS_ERR_UNEXPECTED_RSV_1") { client.ws.close(1002, "WS_ERR_UNEXPECTED_RSV_1"); } }); // Check if WebSocket already closed before we added the listener (race condition) if (client.ws.readyState >= 2) { this.log.info("client WebSocket already closing/closed, removing", { clientID: client.clientID, readyState: client.ws.readyState, }); this.activeClients = this.activeClients.filter( (c) => c.clientID !== client.clientID, ); } } public setStartsAt(startsAt: number) { this.startsAt = startsAt; // Record when the lobby first became visible to players, used to measure lobby fill time. this.visibleAt ??= Date.now(); } public numClients(): number { return this.activeClients.length; } public numDesyncedClients(): number { return this.outOfSyncClients.size; } public prestart() { if (this.hasStarted()) { return; } this._hasPrestarted = true; const prestartMsg = ServerPrestartMessageSchema.safeParse({ type: "prestart", gameMap: this.gameConfig.gameMap, gameMapSize: this.gameConfig.gameMapSize, }); if (!prestartMsg.success) { console.error( `error creating prestart message for game ${this.id}, ${prestartMsg.error}`.substring( 0, 250, ), ); return; } const msg = JSON.stringify(prestartMsg.data); this.activeClients.forEach((c) => { this.log.info("sending prestart message", { clientID: c.clientID, persistentID: c.persistentID, }); c.ws.send(msg); }); } private startLobbyInfoBroadcast() { if (this._hasStarted || this._hasEnded) { return; } if (this.lobbyInfoIntervalId !== null) { return; } this.broadcastLobbyInfo(); this.lobbyInfoIntervalId = setInterval(() => { if ( this._hasStarted || this._hasEnded || this.activeClients.length === 0 ) { this.stopLobbyInfoBroadcast(); return; } this.broadcastLobbyInfo(); }, 1000); } private stopLobbyInfoBroadcast() { if (this.lobbyInfoIntervalId === null) { return; } clearInterval(this.lobbyInfoIntervalId); this.lobbyInfoIntervalId = null; } private broadcastLobbyInfo() { const lobbyInfo = this.gameInfo(); this.activeClients.forEach((c) => { if (c.ws.readyState === WebSocket.OPEN) { const msg = JSON.stringify({ type: "lobby_info", lobby: lobbyInfo, myClientID: c.clientID, } satisfies ServerLobbyInfoMessage); c.ws.send(msg); } }); } public start() { if (this._hasStarted || this._hasEnded) { return; } this._hasStarted = true; this._startTime = Date.now(); // Set last ping to start so we don't immediately stop the game // if no client connects/pings. this.lastPingUpdate = Date.now(); const result = GameStartInfoSchema.safeParse({ gameID: this.id, lobbyCreatedAt: this.createdAt, visibleAt: this.visibleAt, config: this.gameConfig, players: this.activeClients.map((c) => ({ username: c.username, clanTag: c.clanTag ?? null, clientID: c.clientID, cosmetics: c.cosmetics, isLobbyCreator: this.lobbyCreatorID === c.clientID, })), }); if (!result.success) { const error = z.prettifyError(result.error); this.log.error("Error parsing game start info", { message: error }); return; } this.gameStartInfo = result.data satisfies GameStartInfo; this.endTurnIntervalID = setInterval( () => this.endTurn(), this.config.turnIntervalMs(), ); this.activeClients.forEach((c) => { this.log.info("sending start message", { clientID: c.clientID, persistentID: c.persistentID, }); this.sendStartGameMsg(c.ws, 0); }); } private addIntent(intent: StampedIntent) { this.intents.push(intent); } private sendStartGameMsg(ws: WebSocket, lastTurn: number) { // Find which client this websocket belongs to const client = this.activeClients.find((c) => c.ws === ws); if (!client) { this.log.warn("Could not find client for websocket in sendStartGameMsg"); return; } this.log.info(`Sending start message to client`, { clientID: client.clientID, lobbyCreatorID: this.lobbyCreatorID, isLobbyCreator: this.lobbyCreatorID === client.clientID, }); try { ws.send( JSON.stringify({ type: "start", turns: this.turns.slice(lastTurn), gameStartInfo: this.gameStartInfo, lobbyCreatedAt: this.createdAt, myClientID: client.clientID, } satisfies ServerStartGameMessage), ); } catch (error) { throw new Error( `error sending start message for game ${this.id}, ${error}`.substring( 0, 250, ), ); } } private endTurn() { // Skip turn execution if game is paused if (this.isPaused) { return; } const pastTurn: Turn = { turnNumber: this.turns.length, intents: this.intents, }; this.turns.push(pastTurn); this.intents = []; this.handleSynchronization(); this.checkDisconnectedStatus(); const msg = JSON.stringify({ type: "turn", turn: pastTurn, } satisfies ServerTurnMessage); this.activeClients.forEach((c) => { c.ws.send(msg); }); } async end() { this._hasEnded = true; // Close all WebSocket connections if (this.endTurnIntervalID) { clearInterval(this.endTurnIntervalID); this.endTurnIntervalID = undefined; } this.websockets.forEach((ws) => { if (ws.readyState === WebSocket.OPEN) { ws.close(1000, "game has ended"); } }); if (!this._hasPrestarted && !this._hasStarted) { this.log.info(`game not started, not archiving game`); return; } this.log.info(`ending game with ${this.turns.length} turns`); try { if (this.allClients.size === 0) { this.log.info("no clients joined, not archiving game", { gameID: this.id, }); } else if (this.winner !== null) { this.log.info("game already archived", { gameID: this.id, }); } else { this.archiveGame(); } } catch (error) { let errorDetails; if (error instanceof Error) { errorDetails = { message: error.message, stack: error.stack, }; } else if (Array.isArray(error)) { errorDetails = error; // Now we'll actually see the array contents } else { try { errorDetails = JSON.stringify(error, null, 2); } catch (e) { errorDetails = String(error); } } this.log.error("Error archiving game record details:", { gameId: this.id, errorType: typeof error, error: errorDetails, }); } } phase(): GamePhase { const now = Date.now(); const alive: Client[] = []; for (const client of this.activeClients) { if (now - client.lastPing > 60_000) { this.log.info("no pings received, terminating connection", { clientID: client.clientID, persistentID: client.persistentID, }); if (client.ws.readyState === WebSocket.OPEN) { client.ws.close(1000, "no heartbeats received, closing connection"); } } else { alive.push(client); } } this.activeClients = alive; if (now > this.createdAt + this.maxGameDuration) { this.log.warn("game past max duration", { gameID: this.id, }); return GamePhase.Finished; } const noRecentPings = now > this.lastPingUpdate + 20 * 1000; const noActive = this.activeClients.length === 0; if (this.gameConfig.gameType !== GameType.Public) { if (this._hasStarted) { if (noActive && noRecentPings) { this.log.info("private game complete", { gameID: this.id, }); return GamePhase.Finished; } else { return GamePhase.Active; } } else if (this._hasEnded) { return GamePhase.Finished; } else { return GamePhase.Lobby; } } // Public Games const lessThanLifetime = this.startsAt ? Date.now() < this.startsAt : true; if ( lessThanLifetime && !this.hasStarted() && !this.hasReachedMaxPlayerCount ) { return GamePhase.Lobby; } const warmupOver = now > this.startsAt! + 30 * 1000; if (noActive && warmupOver && noRecentPings) { return GamePhase.Finished; } return GamePhase.Active; } hasStarted(): boolean { return this._hasStarted || this._hasPrestarted; } public gameInfo(): GameInfo { return { gameID: this.id, clients: this.activeClients.map((c) => ({ username: c.username, clanTag: c.clanTag ?? null, clientID: c.clientID, })), lobbyCreatorClientID: this.lobbyCreatorID, gameConfig: this.gameConfig, startsAt: this.startsAt, serverTime: Date.now(), publicGameType: this.publicGameType, }; } public isPublic(): boolean { return this.gameConfig.gameType === GameType.Public; } public kickClient( clientID: ClientID, reasonKey: string = KICK_REASON_DUPLICATE_SESSION, ): void { if (this.isKicked(clientID)) { this.log.warn(`cannot kick client, already kicked`, { clientID, reasonKey, }); return; } const clientToKick = this.allClients.get(clientID); if (!clientToKick) { this.log.warn(`cannot kick client, not found in game`, { clientID, reasonKey, }); return; } this.kickedPersistentIds.add(clientToKick.persistentID); const client = this.activeClients.find((c) => c.clientID === clientID); if (client) { this.log.info("Kicking client from game", { clientID: client.clientID, persistentID: client.persistentID, reasonKey, }); client.ws.send( JSON.stringify({ type: "error", error: reasonKey, } satisfies ServerErrorMessage), ); client.ws.close(1000, reasonKey); this.activeClients = this.activeClients.filter( (c) => c.clientID !== clientID, ); } else { this.log.warn(`cannot kick client, not found in game`, { clientID, reasonKey, }); } } private checkDisconnectedStatus() { if (this.turns.length % 5 !== 0) { return; } const now = Date.now(); for (const [clientID, client] of this.allClients) { const isDisconnected = this.isClientDisconnected(clientID); if (!isDisconnected && now - client.lastPing > this.disconnectedTimeout) { this.markClientDisconnected(clientID, true); } else if ( isDisconnected && now - client.lastPing < this.disconnectedTimeout ) { this.markClientDisconnected(clientID, false); } } } public isClientDisconnected(clientID: string): boolean { return this.clientsDisconnectedStatus.get(clientID) ?? true; } private markClientDisconnected(clientID: string, isDisconnected: boolean) { this.clientsDisconnectedStatus.set(clientID, isDisconnected); this.addIntent({ type: "mark_disconnected", clientID: clientID, isDisconnected: isDisconnected, }); } private archiveGame() { this.log.info("archiving game", { gameID: this.id, winner: this.winner?.winner, }); // Players must stay in the same order as the game start info. const playerRecords: PlayerRecord[] = this.gameStartInfo.players.map( (player) => { const stats = this.winner?.allPlayersStats[player.clientID]; if (stats === undefined) { this.log.warn(`Unable to find stats for clientID ${player.clientID}`); } return { clientID: player.clientID, username: player.username, clanTag: player.clanTag, persistentID: this.allClients.get(player.clientID)?.persistentID ?? "", stats, cosmetics: player.cosmetics, } satisfies PlayerRecord; }, ); archive( finalizeGameRecord( createPartialGameRecord( this.id, this.gameStartInfo.config, playerRecords, this.turns, this._startTime ?? 0, Date.now(), this.winner?.winner, this.createdAt, this.visibleAt, ), ), ); } private handleSynchronization() { if (this.activeClients.length <= 1) { return; } if (this.turns.length % 10 !== 0 || this.turns.length < 10) { // Check hashes every 10 turns return; } const lastHashTurn = this.turns.length - 10; const { mostCommonHash, outOfSyncClients } = this.findOutOfSyncClients(lastHashTurn); if (outOfSyncClients.length === 0) { this.turns[lastHashTurn].hash = mostCommonHash; return; } const serverDesync = ServerDesyncSchema.safeParse({ type: "desync", turn: lastHashTurn, correctHash: mostCommonHash, clientsWithCorrectHash: this.activeClients.length - outOfSyncClients.length, totalActiveClients: this.activeClients.length, }); if (!serverDesync.success) { this.log.warn("failed to create desync message", { gameID: this.id, error: serverDesync.error, }); return; } const desyncMsg = JSON.stringify(serverDesync.data); for (const c of outOfSyncClients) { this.outOfSyncClients.add(c.clientID); if (this.sentDesyncMessageClients.has(c.clientID)) { continue; } this.sentDesyncMessageClients.add(c.clientID); this.log.info("sending desync to client", { gameID: this.id, clientID: c.clientID, persistentID: c.persistentID, }); c.ws.send(desyncMsg); } } findOutOfSyncClients(turnNumber: number): { mostCommonHash: number | null; outOfSyncClients: Client[]; } { const counts = new Map(); // Count occurrences of each hash for (const client of this.activeClients) { if (client.hashes.has(turnNumber)) { const clientHash = client.hashes.get(turnNumber)!; counts.set(clientHash, (counts.get(clientHash) ?? 0) + 1); } } // Find the most common hash let mostCommonHash: number | null = null; let maxCount = 0; for (const [hash, count] of counts.entries()) { if (count > maxCount) { mostCommonHash = hash; maxCount = count; } } // Create a list of clients whose hash doesn't match the most common one let outOfSyncClients: Client[] = []; for (const client of this.activeClients) { if (client.hashes.has(turnNumber)) { const clientHash = client.hashes.get(turnNumber)!; if (clientHash !== mostCommonHash) { outOfSyncClients.push(client); } } } // If half clients out of sync assume all are out of sync. if (outOfSyncClients.length >= Math.floor(this.activeClients.length / 2)) { outOfSyncClients = this.activeClients; } return { mostCommonHash, outOfSyncClients, }; } private handleWinner(client: Client, clientMsg: ClientSendWinnerMessage) { if ( this.outOfSyncClients.has(client.clientID) || this.isKicked(client.clientID) || this.winner !== null || client.reportedWinner !== null ) { return; } client.reportedWinner = clientMsg.winner; // Add client vote const winnerKey = JSON.stringify(clientMsg.winner); if (!this.winnerVotes.has(winnerKey)) { this.winnerVotes.set(winnerKey, { ips: new Set(), winner: clientMsg }); } const potentialWinner = this.winnerVotes.get(winnerKey)!; potentialWinner.ips.add(client.ip); const activeUniqueIPs = new Set(this.activeClients.map((c) => c.ip)); const ratio = `${potentialWinner.ips.size}/${activeUniqueIPs.size}`; this.log.info( `received winner vote ${clientMsg.winner}, ${ratio} votes for this winner`, { clientID: client.clientID, }, ); if (potentialWinner.ips.size * 2 < activeUniqueIPs.size) { return; } // Vote succeeded this.winner = potentialWinner.winner; this.log.info( `Winner determined by ${potentialWinner.ips.size}/${activeUniqueIPs.size} active IPs`, { winnerKey: winnerKey, }, ); this.archiveGame(); } }