MatchController.hpp

Go to the documentation of this file.

#pragma once
 
#include "ecs/registry/Registry.hpp"
#include "network/MatchConfig.hpp"
#include "network/MatchStatus.hpp"
#include "network/Server.hpp"

class MatchController
{
public:
    void update(float deltaTime, Registry& registry, Server& server);

    MatchPhase getCurrentPhase();

    void hostStartedMatch(std::span<const ClientId> expectedPlayers);

    void setSkipLobby(bool v);

    int getWinnerId();
 
    bool setMatchConfig(const MatchConfig& cfg);
    bool setKillsToWin(int killsToWin);
    bool setMaxPlayers(int maxPlayers);
    [[nodiscard]] MatchConfig getMatchConfig() const;
 
    void beginWarmup(std::span<const ClientId> expectedPlayers);
    void markGameplayReady(ClientId clientId);
    void removeExpectedPlayer(ClientId clientId);
    [[nodiscard]] bool allExpectedPlayersReady() const;
 
private:
    MatchPhase currentPhase = MatchPhase::LOBBY;          
    float countdownTimer = 0.0f;                          
    int winnerId = -1;                                    
    bool skipLobby = false;                               
 
    std::unordered_map<ClientId, bool> playerReadyStatus; 
 
    static constexpr float k_warmupDuration =
        30.0f; 
    static constexpr float k_countdownDuration = 5.0f; 
    static constexpr float k_finishedDuration = 5.0f;  
 
    MatchConfig config; 
 
    // PR-4 (server-perf): match-state replicate-on-change.
    //
    // Pre-PR-4 the controller broadcast `MATCH_STATE` every tick
    // (128 Hz) regardless of whether anything changed — at 200 bots
    // that was 25.6 k enqueues/sec all under stateMutex_, which
    // dominated the `match` scope's 100+ ms p99 at 200 bots in PR-3.
    // The on-wire payload is tiny (a few bytes) and the only thing
    // that ever changes meaningfully is `currentPhase` plus the
    // countdownTimer (which the client smoothes locally between
    // ticks). We now broadcast only when those values move enough
    // to be observable on the client.
    MatchPhase lastBroadcastPhase = MatchPhase::LOBBY;
    int lastBroadcastWinnerId = -1;
    float lastBroadcastCountdown = -1.0f;
    int ticksSinceBroadcast = 0;

    void broadcastMatchState(Server& server);
 
    bool validateKillsToWin(int killsToWin);
    bool validateMaxPlayers(int maxPlayers);
    bool validatePowerupTiming(float initialSpawnDelaySeconds, float respawnCooldownSeconds);
    void broadcastMatchConfig(Server& server);
};