Automatic matchmaking service. More...

#include <MatchmakingService.hpp>

Inheritance diagram for server::MatchmakingService:

Collaboration diagram for server::MatchmakingService:

Public Member Functions
	MatchmakingService (size_t minPlayers=2, size_t maxPlayers=4, std::shared_ptr< server::EventBus > eventBus=nullptr)
	Construct matchmaking service.

	~MatchmakingService () override=default

void	addPlayer (uint32_t playerId) override
	Add a player to the matchmaking queue.

void	removePlayer (uint32_t playerId) override
	Remove a player from the matchmaking queue.

void	tick () override
	Process matchmaking queue and create matches Called periodically by the server.

size_t	getQueueSize () const override
	Get the number of players waiting in queue.

void	setMatchCreatedCallback (MatchCreatedCallback callback) override
	Set callback for when a match is created.

std::pair< std::shared_ptr< Room >, bool >	findOrCreateMatch (uint32_t playerId, const std::vector< std::shared_ptr< Room > > &availableRooms, bool allowSpectator=true) override
	Find an available room or add player to matchmaking queue.

std::vector< PlayerQueueInfo >	getWaitingPlayers () const
	Get list of waiting players.

void	setMinPlayers (size_t min)
	Set minimum players required to start a match.

void	setMaxPlayers (size_t max)
	Set maximum players per match.

std::string	getStatistics () const
	Get statistics about matchmaking.

Public Member Functions inherited from server::IMatchmakingService
virtual	~IMatchmakingService ()=default

Private Member Functions
bool	_tryCreateMatch ()
	Try to create a match from waiting players.

std::string	_generateRoomId ()
	Generate unique room ID for a new match.

Private Attributes
size_t	_minPlayers

size_t	_maxPlayers

std::shared_ptr< server::EventBus >	_eventBus

std::vector< PlayerQueueInfo >	_waitingPlayers

std::mutex	_mutex

MatchCreatedCallback	_matchCreatedCallback

uint32_t	_totalMatchesCreated {0}

uint32_t	_totalPlayersMatched {0}

Detailed Description

Automatic matchmaking service.

Manages matchmaking for players in two modes:

Manual Matchmaking (queue-based):
- Players are added to a waiting queue via addPlayer()
- tick() is called periodically to create matches when min players reached
- Creates balanced matches (2-4 players)
Auto-Matchmaking (instant + queue):
- findOrCreateMatch() tries to find an existing room first (instant join)
- If no room available, automatically adds to queue
- Provides best user experience with minimal wait time

Features:

Automatic match creation when minimum players reached
Configurable min/max players per match
Wait time tracking
Callback notification when match is created
Thread-safe operations

Definition at line 53 of file MatchmakingService.hpp.

Constructor & Destructor Documentation

◆ MatchmakingService()

server::MatchmakingService::MatchmakingService	(	size_t	minPlayers = `2`,
		size_t	maxPlayers = `4`,
		std::shared_ptr< server::EventBus >	eventBus = `nullptr`
	)

explicit

Construct matchmaking service.

Parameters

minPlayers	Minimum players to start a match (default: 2)
maxPlayers	Maximum players per match (default: 4)
eventBus	Shared event bus for server-wide events

Definition at line 16 of file MatchmakingService.cpp.

References _maxPlayers, _minPlayers, and LOG_INFO.

◆ ~MatchmakingService()

server::MatchmakingService::~MatchmakingService ( )

overridedefault

Member Function Documentation

◆ _generateRoomId()

std::string server::MatchmakingService::_generateRoomId ( )

private

Generate unique room ID for a new match.

Returns: Room ID string

Definition at line 138 of file MatchmakingService.cpp.

References _totalMatchesCreated.

Referenced by _tryCreateMatch().

◆ _tryCreateMatch()

bool server::MatchmakingService::_tryCreateMatch ( )

private

Try to create a match from waiting players.

Returns: true if a match was created

Definition at line 75 of file MatchmakingService.cpp.

References _eventBus, _generateRoomId(), _matchCreatedCallback, _maxPlayers, _minPlayers, _totalMatchesCreated, _totalPlayersMatched, _waitingPlayers, LOG_ERROR, and LOG_INFO.

Referenced by tick().

Here is the call graph for this function:

◆ addPlayer()

void server::MatchmakingService::addPlayer ( uint32_t playerId )

overridevirtual

Add a player to the matchmaking queue.

Parameters

playerId Player ID to add

Implements server::IMatchmakingService.

Definition at line 28 of file MatchmakingService.cpp.

References _mutex, _waitingPlayers, server::PlayerQueueInfo::joinTime, LOG_INFO, LOG_WARNING, and server::PlayerQueueInfo::playerId.

◆ findOrCreateMatch()

std::pair< std::shared_ptr< Room >, bool > server::MatchmakingService::findOrCreateMatch	(	uint32_t	playerId,
		const std::vector< std::shared_ptr< Room > > &	availableRooms,
		bool	allowSpectator = `true`
	)

overridevirtual

Find an available room or add player to matchmaking queue.

Implements intelligent matchmaking strategy:

Try to find a waiting room (instant join)
If no waiting room, join as spectator to in-progress game (if allowed)
If no matches available, add to queue for future match creation

Parameters

playerId	Player ID requesting matchmaking
availableRooms	List of currently available rooms to search
allowSpectator	Whether player can join as spectator if no waiting rooms