이번 작업에서는 로비에서 팀 전원이 Ready 상태가 되면 매치메이킹 큐에 팀을 올리고, 큐에 쌓인 팀 수가 임계치에 도달하면 GameSession을 시작하도록 서버 주도 로직을 직접 구현했습니다.
목표/요구사항
- 팀 내 모든 인원이 Ready가 되면 해당 팀을 매치메이킹 대기열에 추가합니다.
- 대기열의 팀 수가 RequiredTeamsToStart 이상이면 세션을 시작합니다.
- 로비에서 준비/취소/초대/합류/퇴장과 같은 상호작용이 자연스럽게 이어지도록 합니다.
- 서버 권한 강제, 중복 삽입 방지, 초기 동기화 타이밍 이슈를 예방합니다.
아키텍처 요약
- Team 상태 관리
- FCMLobbyTeamInfo: TeamID, CurrentPlayerCount, ReadyPlayerCount, TeamMembers, TeamLeader 등으로 구성합니다.
- Player별 PlayerStateLobby가 자신의 팀 정보를 캐싱합니다.
- Ready 처리 흐름
- ReadyMatchmaking: 서버 전용으로 Ready 수를 올리고, 전원이 Ready면 EnterMatchmakingQueue를 호출합니다.
- EnterMatchmakingQueue: 서버 전용으로 대기열(TeamID 집합)에 추가하고, 임계치 도달 시 StartGameSession을 호출합니다.
- Team 구성/합류
- AddTeamToLobby: 새 플레이어 로그인 시 1인 팀을 생성하고 PlayerTeamMapping을 갱신합니다.
- JoinTeam: 초대 수락 시 팀에 합류하며 인원 수와 초대 가능 상태를 갱신합니다.
- 초기 동기화
- GameStateBase: OnLoadCompleted 이후 클라이언트가 로비 플레이어 목록 동기화를 수행합니다.
- GameStateLobby: SyncLobbyPlayerList로 KnownLobbyPlayers를 갱신하고 Delegate를 브로드캐스트합니다.
핵심 흐름
- 로그인: CMGameModeLobby::PostLogin → CMGameStateLobby::AddTeamToLobby를 호출합니다.
- 초대/수락: PerformInvitePlayer → AcceptInvitePlayer → JoinTeam/RemoveLookingPlayer로 이어집니다.
- Ready: ReadyMatchmaking → EnterMatchmakingQueue → StartGameSession 순서로 진행됩니다.
- 동기화: GameStateBase 로드 시퀀스 완료 → CMGameStateLobby::SyncLobbyPlayerList가 실행됩니다.
소스 코드: Ready → 큐 진입 → 세션 시작
// filepath: Source/CrimsonMoon/Private/Game/CMGameStateLobby.cpp
void ACMGameStateLobby::ReadyMatchmaking(FCMLobbyTeamInfo* TeamInfo)
{
if (!TeamInfo)
{
UE_LOG(LogTemp, Warning, TEXT("ACMGameStateLobby::ReadyMatchmaking - TeamInfo is null"));
return;
}
if (!HasAuthority())
{
UE_LOG(LogTemp, Warning, TEXT("ACMGameStateLobby::ReadyMatchmaking - Should be called on server only"));
return;
}
// 이미 대기열에 있으면 무시
if (MatchmakingQueueTeamIDs.Contains(TeamInfo->TeamID))
{
UE_LOG(LogTemp, Verbose, TEXT("ACMGameStateLobby::ReadyMatchmaking - Team %d already queued"), TeamInfo->TeamID);
return;
}
// 준비 수 증가 (과증가 방지)
TeamInfo->ReadyPlayerCount = FMath::Clamp(TeamInfo->ReadyPlayerCount + 1, 0, TeamInfo->CurrentPlayerCount);
if (TeamInfo->CurrentPlayerCount > 0 && TeamInfo->ReadyPlayerCount >= TeamInfo->CurrentPlayerCount)
{
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::ReadyMatchmaking - Team %d is fully ready (%d/%d)"), TeamInfo->TeamID, TeamInfo->ReadyPlayerCount, TeamInfo->CurrentPlayerCount);
EnterMatchmakingQueue(TeamInfo);
}
else
{
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::ReadyMatchmaking - Team %d ready progress: %d/%d"), TeamInfo->TeamID, TeamInfo->ReadyPlayerCount, TeamInfo->CurrentPlayerCount);
}
}
void ACMGameStateLobby::EnterMatchmakingQueue(FCMLobbyTeamInfo* TeamInfo)
{
if (!TeamInfo)
{
UE_LOG(LogTemp, Warning, TEXT("ACMGameStateLobby::EnterMatchmakingQueue - TeamInfo is null"));
return;
}
if (!HasAuthority())
{
UE_LOG(LogTemp, Warning, TEXT("ACMGameStateLobby::EnterMatchmakingQueue - Should be called on server only"));
return;
}
if (TeamInfo->TeamID < 0)
{
UE_LOG(LogTemp, Warning, TEXT("ACMGameStateLobby::EnterMatchmakingQueue - Invalid TeamID"));
return;
}
if (!MatchmakingQueueTeamIDs.Contains(TeamInfo->TeamID))
{
MatchmakingQueueTeamIDs.Add(TeamInfo->TeamID);
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::EnterMatchmakingQueue - Team %d entered queue. QueueSize=%d"), TeamInfo->TeamID, MatchmakingQueueTeamIDs.Num());
}
else
{
UE_LOG(LogTemp, Verbose, TEXT("ACMGameStateLobby::EnterMatchmakingQueue - Team %d already in queue. QueueSize=%d"), TeamInfo->TeamID, MatchmakingQueueTeamIDs.Num());
}
// 기준 팀 수에 도달하면 게임 세션 시작
if (MatchmakingQueueTeamIDs.Num() >= RequiredTeamsToStart)
{
StartGameSession();
// 간단 구현: 시작 후 대기열 초기화 (중복 트리거 방지)
MatchmakingQueueTeamIDs.Empty();
}
}
void ACMGameStateLobby::StartGameSession()
{
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::StartGameSession - Starting game session (RequiredTeamsToStart=%d)"), RequiredTeamsToStart);
}소스 코드: 팀 생성/합류
// filepath: Source/CrimsonMoon/Private/Game/CMGameStateLobby.cpp
void ACMGameStateLobby::AddTeamToLobby(ACMPlayerStateLobby* NewPlayer)
{
FCMLobbyTeamInfo NewTeam;
NewTeam.TeamID = TeamIndexCounter;
NewTeam.CurrentPlayerCount = 1;
NewTeam.TeamMembers.Add(NewPlayer);
NewTeam.TeamLeader = NewPlayer;
// 먼저 맵에 저장하여 영속적인 스토리지에 배치한 후, 그 참조를 캐싱합니다
LobbyTeams.Add(TeamIndexCounter, NewTeam);
FCMLobbyTeamInfo& StoredTeam = LobbyTeams[TeamIndexCounter];
NewPlayer->SetCachedTeamInfo(&StoredTeam);
PlayerTeamMapping.Add(NewPlayer->GetPendingNickname(), StoredTeam.TeamID);
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::AddTeamToLobby - Added new team with ID %d"), StoredTeam.TeamID);
TeamIndexCounter++;
}
void ACMGameStateLobby::JoinTeam(const FName& JoinedPlayer, const FName& JoiningPlayer)
{
if (ACMPlayerControllerLobby* PC = CurrentLookingPlayers[JoiningPlayer])
{
int32 TeamIndex = PlayerTeamMapping[JoinedPlayer];
if (LobbyTeams.Contains(TeamIndex))
{
FCMLobbyTeamInfo& TeamInfo = LobbyTeams[TeamIndex];
TeamInfo.CurrentPlayerCount++;
if (ACMPlayerStateLobby* PS = PC->GetPlayerState<ACMPlayerStateLobby>())
{
TeamInfo.TeamMembers.Add(PS);
PS->SetCachedTeamInfo(&TeamInfo);
PS->SetCanBeInvited(false);
}
UE_LOG(LogTemp, Log, TEXT("ACMGameStateLobby::JoinTeam - Player %s joined team %d"), *JoinedPlayer.ToString(), TeamIndex);
}
}
}안정성/중복/권한 처리
- 서버 전용 메서드를 HasAuthority로 보호하여 ReadyMatchmaking/EnterMatchmakingQueue가 서버에서만 실행되도록 했습니다.
- 대기열 중복은 MatchmakingQueueTeamIDs.Contains 검사로 차단했습니다.
- TeamID 유효성을 확인하여 음수 값을 방지했습니다.
- Ready 카운트는 FMath::Clamp로 과증가를 방지했습니다.
- 초기 동기화 타이밍은 GameState 미존재 시 다음 틱 재시도로 레이스를 완화했습니다.
에지 케이스
- 팀 인원이 0명일 때는 ReadyMatchmaking에서 처리하지 않도록 했습니다.
- 동일 팀에서 Ready가 중복 호출되면 이미 큐에 있음을 감지하고 조기 반환합니다.
- PlayerState 복제 지연 상황에서 OnRep/다음 틱 재시도로 안전하게 동기화를 완료합니다.
- 초대 수락 직후 Ready 호출 시 TeamInfo 일관성을 유지하도록 합류 로직 이후 상태를 점검합니다.
실제 적용
마치며
팀 전원이 Ready가 되면 큐에 진입하고, 큐의 팀 수가 임계치에 도달하면 세션을 시작하는 핵심 사용자 여정을 서버 권한, 중복 방지, 복제 타이밍을 고려하여 직접 구현했습니다. 현재 구조는 확장에 용이하며, Ready 취소/퇴장 처리와 실제 세션 전환(맵 트래블)을 보강하면 실전 매치메이킹 파이프라인으로 무리 없이 연결될 것으로 판단됩니다.
프로젝트 진행 과정을 주로 업로드합니다