monstrosite

유닛 설치 - 3) 특정 타일의 유닛 생성 차단

monstro — Mon, 27 Jul 2026 19:07:06 +0900

- 개요

동적으로 변경되는 맵에 따라 일부 타일에 유닛을 설치할 수 없도록 차단하는 기능을 추가한다

- 스크립트 작업

1) TileSlot 클래스

Start 함수를 코루틴으로 수정하여 TileAnimator의 싱글톤 인스턴스가 생성되기까지 대기한다

2) BuildTileSlot 클래스

유닛을 설치할 수 있는 타일에 위와 같이 멤버변수를 추가한다

bBuildTileAvailable 멤버변수 : 해당 타일을 사용할 수 있는지 여부
meshRenderer 멤버변수 : 해당 타일의 MeshRenderer 컴포넌트
material 멤버변수 : 해당 타일의 Material 컴포넌트
buildTileCollider 멤버변수 : 해당 타일의 Collider 컴포넌트

Awake 함수에 로직을 추가하여 meshRenderer 멤버변수와 buildTileCollider 멤버변수의 값을 설정한다

Start 함수를 위와 같이 오버라이드한다

타일을 사용할 수 없다면 타일을 시각화하고 마우스 입력이 일어나지 않도록 콜라이더를 비활성화한다

OnPointer 계열 함수 3개

위와 같이 로직을 추가하여 사용할 수 없는 타일에 대해서는 마우스 입력이 일어나지 않도록 설정한다

타일의 상승 / 하강 애니메이션에 관련된 3개의 함수에서 TileAnimator의 싱글톤 인스턴스를 사용하도록 수정한다

SetBuildTileAvailability 함수를 추가하여 타일의 사용할 수 있는지 여부를 설정한다

3) UI_BuildBtn 클래스

BuildTower 함수에 위와 같이 로직을 추가하여 유닛이 설치된 타일을 더 이상 사용할 수 없도록 설정한다

4) TileAnimator클래스

CoMoveTile 코루틴 함수에 위와 같이 로직을 추가한다

코루틴 함수가 동작하는 동안 상승 / 하강시킬 타일이 유효한지 확인하는 코드를 추가한다

5) BuildManager 클래스

MakeBuildTileAvaliablityFalse 함수를 추가하여 현재 웨이브의 타일맵과 다음 웨이브의 타일맵을 비교하여

조금이라도 달라진 타일들에 대해서 유닛을 설치할 수 없도록 설정한다

테스트용 멤버변수

테스트용 멤버변수를 대상으로 타일 비활성화

테스트용 멤버변수와 Start 함수를 추가하여

첫번째 웨이브에서 타일에 유닛을 설치할 수 없는 경우를 대비한다

6) WaveManager 클래스

WaveData의 nextWaveGrid 변수를 currentWaveGrid 변수로 변경

CheckForNewLevelLayout 함수에 로직을 추가하여 다음 웨이브에 맞춰 유닛을 설치할 수 있는 타일을 수정한다

UpdateLevelGrid 함수에 위와 같이 로직을 추가하여

BuildManager의 테스트용 변수의 값을 새로 생성된 타일맵으로 갱신하고

새로 생성된 타일맵을 대상으로 유닛을 설치할 수 있는 타일을 수정한다

GetCurrentWaveData 함수를 추가하여 현재 웨이브에 대한 WaveData를 반환한다

GetNextWaveData 함수를 추가하여 다음 웨이브에 대한 WaveData를 반환한다

- 최종 실행 결과

Dynamo DB - 5) MatchStats 데이터 구조체 추가

monstro — Sun, 26 Jul 2026 20:04:40 +0900

- 개요

MatchStats 관련 데이터를 네트워크 통신을 통해 주고받기 위한 데이터 구조체를 추가한다

해당 구조체를 직렬화 + 역직렬화하여 필요한 데이터의 값을 변환 + 추출한다

- 스크립트 작업

1) HTTPRequestTypes 클래스

DSMatchStats 구조체

DSMatchStats 구조체를 추가한다

해당 구조체는 MatchStats의 세부정보를 저장하는 역할로 사용한다

scoredElims 멤버변수 : 적 처치 횟수
defeats 멤버변수 : 사망 횟수
hits 멤버변수 : 공격 적중 횟수
misses 멤버변수 : 공격이 빗나간 횟수
headShotElims 멤버변수 : 헤드샷 처치 횟수
highestStreak 멤버변수 : 최고 연속 처치 기록
revengeElims 멤버변수 : 복수 처치 횟수
dethroneElims 멤버변수 : 우세한 플레이어를 처치한 횟수
showstopperElims 멤버변수 : 특정 상황을 저지하는 처치한 횟수
gotFirstBlood 멤버변수 : 퍼스트 킬을 달성했는지 여부 + 1이나 0을 통해 값을 설정
matchWins 멤버변수 : 게임의 승리 여부 + 1이나 0을 통해 값을 설정
matchLosses 멤버변수 : 게임의 패배 여부 + 1이나 0을 통해 값을 설정

DSRecordMatchStatsInput 구조체

DSRecordMatchStatsInput 구조체를 추가한다

해당 구조체는 위의 DSMatchStats 구조체를 플레이어의 이름과 묶어 관리하는 용도로 사용한다

matchStats 멤버변수 : 특정 플레이어의 DSMatchStats 값
username 멤버변수 : 특정 플레이어의 이름

Dynamo DB - 4) MatchStats 관련 API Gateway 생성

monstro — Sun, 26 Jul 2026 19:14:51 +0900

- 개요

클라이언트에서 서버로 이전에 생성한 RecordMatchStats 람다 함수의 실행을 요청할 수 있도록 설정한다

따라서 하나의 게임이 끝날때마다 플레이어마다의 MatchStats를 갱신하기 위한 API Gateway를 생성한다

- 절차

1) AWS Console 작업

1 - 1) API Gateway 생성

REST API Gateway 생성

REST API 방식의 API Gateway를 생성한다

생성한 Gateway의 이름 설정

새 API 방식으로 생성하고 API의 이름을 "GameStats"로 설정한다

1 - 2) API Gateway의 리소스 설정

GameStats 게이트웨이의 리소스 설정

GameStats 게이트웨이에 대한 리소스를 위와 같이 설정한다

설정한 리소스에 대한 메서드 설정

설정한 리소스에 대한 람다 함수를 설정한다

민감한 데이터를 전달하므로 POST 방식으로 동작하도록 설정하고

이전에 생성한 RecordMatchStats 람다 함수를 사용하도록 구성하였다

1 - 3) 생성한 API Gateway 배포

완전히 구성된 Gateway 배포

구성이 완료된 Gateway를 외부에 배포하기 위한 스테이지를 설정한다

스테이지의 이름을 "stage_1"으로 구성하고 배포한다

2) 스크립트 작업

2 - 1) DedicatedServersTags 클래스

GameStats API에 대한 태그 선언

GameStats API에 대한 태그 정의

매크로를 사용하여 GameStats API에 대한 태그를 선언 + 정의한다

2 - 2) GameStatsManager 클래스

GameStats API와 관련된 네트워크 작업을 처리하는 GameStatsManager 클래스를 생성한다

부모 클래스로 HTTPRequestManager 클래스를 사용한다

3) 블루프린트 작업

3 - 1) DA_GameStatsAPIData 데이터 애셋

APIData 데이터애셋에서 상속된 DA_GameStatsAPIData 데이터 애셋을 생성한다

GameStats API의 리소스와 관련된 데이터들을 저장한다

3 - 2) BP_GameStatsManager 블루프린트

2 - 2)에서 생성한 C++ 클래스를 바탕으로 블루프린트를 생성한다

APIData 멤버변수의 값으로 3 - 1)에서 생성한 데이터 애셋을 사용한다

Dynamo DB - 3) MatchPlayerState 데이터 처리

monstro — Sat, 25 Jul 2026 18:19:46 +0900

- 개요

MatchPlayerState 클래스의 일부

프로젝트에서 사용하는 PlayerState 클래스인 MatchPlayerState 클래스에는

진행된 게임의 결과와 관련된 여러 변수를 포함하고 있다

따라서 하나의 게임이 종료된 후에 해당 변수들의 값을 Dynamo DB의 데이터 테이블에 추가하는 람다 함수를 생성한다

- 절차

1) 람다 함수 생성 및 구성

MatchState의 변수의 값을 Dynamo DB의 테이블에 반영하는 RecordMatchStats 람다 함수를 생성한다

생성한 람다 함수에 대한 REGION 환경 변수를 추가하여 로직에서 리전에 접근할 수 있도록 구성하고

USER_POOL_ID 환경 변수를 추가하여 로직에서 User Pool에 접근할 수 있도록 구성한다

2) 정책 설정

2 - 1) 정책 설정 - AdminGetUser 리소스

RecordMatchStats 람다 함수에 부여할 정책 설정 (1)

생성할 람다 함수에 부여할 정책을 설정한다

우선, CognitoUserPools의 AdminGetUser 리소스를 사용할 수 있도록 설정한다

관리자 권한으로 특정 User Pool에 대한 사용자의 정보를 가져올 수 있도록 구성한다

이때 현재 사용중인 User Pool의 ARN을 추가해야 한다

생성한 정책의 이름을 위와 같이 설정한다

2 - 2) 정책 설정 - GetItem 리소스

RecordMatchStats 람다 함수에 부여할 정책 설정 (2)

2 - 1)에서 생성한 DS_RecordMatchStats 정책에 DynamoDB의 GetItem 리소스를 사용하도록 추가한다

GetItem은 Dynamo DB의 테이블에서 단일 아이템을 조회하는 목적으로 사용한다

추가한 GetItem 리소스에 대해 현재 사용중인 Players 테이블과 User Pool의 ARN을 설정한다

2 - 3) 정책 설정 - PutItem 리소스

RecordMatchStats 람다 함수에 부여할 정책 설정 (3)

2 - 1)에서 생성한 DS_RecordMatchStats 정책에 DynamoDB의 PutItem 리소스를 사용하도록 추가한다

GetItem은 Dynamo DB의 테이블에서 단일 아이템을 생성하거나 덮어쓰기하는 목적으로 사용한다

3) 람다 함수 정의

import { CognitoIdentityProviderClient, AdminGetUserCommand } from "@aws-sdk/client-cognito-identity-provider";
import { DynamoDBClient, GetItemCommand, PutItemCommand } from "@aws-sdk/client-dynamodb";
import { marshall, unmarshall } from "@aws-sdk/util-dynamodb";

export const handler = async (event) => {
  const cognitoIdentityProviderClient = new CognitoIdentityProviderClient( { region: process.env.REGION } );
  const dynamoDBClient = new DynamoDBClient( { region: process.env.REGION } );
  try {
    const adminGetUserInput = {
      Username: event.username,
      UserPoolId: process.env.USER_POOL_ID
    };
    const adminGetUserCommand = new AdminGetUserCommand(adminGetUserInput);
    const adminGetUserResponse = await cognitoIdentityProviderClient.send(adminGetUserCommand);

    const sub = adminGetUserResponse.UserAttributes.find(attribute => attribute.Name === "sub").Value;
    const email = adminGetUserResponse.UserAttributes.find(attribute => attribute.Name === "email").Value;
    
    const getItemInput = {
      TableName: "Players",
      Key: marshall( { databaseid: sub } ),
    };

    const getItemCommand = new GetItemCommand(getItemInput);
    const getItemResponse = await dynamoDBClient.send(getItemCommand);
    let statsFromDB = getItemResponse.Item ? unmarshall(getItemResponse.Item) : { databaseid: sub };

    const eventMatchStats = event.matchStats;

    for (const key in eventMatchStats) {
      if (statsFromDB[key] !== undefined) {
        statsFromDB[key] += eventMatchStats[key];
      } else {
        statsFromDB[key] = eventMatchStats[key];
      }
    }

    const putItemInput = {
      TableName: "Players",
      Item: marshall( { ...statsFromDB } )
    };
    const putItemCommand = new PutItemCommand(putItemInput);
    await dynamoDBClient.send(putItemCommand);

    return {
      statusCode: 200,
      body: `Updated match stats for ${event.username}`
    };
  } catch(error) {
    return error;
  }
};

RecordMatchStats 람다 함수의 코드를 위와 같이 구성한다

AdminGetUser 리소스를 사용하여 event.username을 통해 User Pool에서 해당 유저의 상세 정보를 반환
상세 정보 중에서 sub 고유 식별자와 email 값을 추출
sub 값을 기본 키로 GetItem 리소스를 사용하여 Players 테이블에서 플레이어의 기존 정보를 조회
기존 정보에 새로 들어온 event.matchStats 값을 합산
PutItem 리소스를 사용하여 갱신된 정보를 Players 테이블에 덮어씌움

- 최종 실행 결과

RecordMatchStats 람다 함수에 사용할 테스트 데이터를 위와 같이 구성한다

람다 함수 실행 후의 로그

테스트 실행 결과에서 위와 같이 statusCode : 200이 출력되어

성공적으로 테스트 데이터를 통한 람다 함수의 수행이 이뤄진 것을 확인할 수 있다

DynamoDB의 Players 테이블

Dynamo DB의 Players 테이블에서 hits와 misees 속성과 값이 추가된 것도 확인할 수 있다

Dynamo DB - 2) 사용자 인증 처리

monstro — Fri, 24 Jul 2026 15:26:34 +0900

- 개요

회원가입한 플레이어가 인증한 후에 사용자 정보를 Dynamo DB에 추가하는 람다 함수를 생성한다

- 절차

1) 람다 함수 생성 및 정책 설정

AWS 콘솔의 람다 탭에서 CongitoPostConfirmation 람다 함수를 생성한다

CognitoPostConfirmation 람다 함수 정책 설정 (1)

생성한 람다 함수에 적용할 정책을 설정한다

우선, Players 테이블을 대상으로 정책을 사용하도록 Players 테이블의 리소스 ARN을 복사 + 붙여넣기한다

CognitoPostConfirmation 람다 함수 정책 설정 (2)

정책은 DynamoDB의 PutItem 리소스를 사용할 수 있도록 구성하였다

CognitoPostConfirmation 람다 함수 정책 설정 (3)

생성한 정책의 이름을 위와 같이 설정한다

최종적으로 생성한 CognitoPostConfirmation 람다 함수에 정책을 적용한다

람다 함수에서 사용할 REGION 환경 변수를 정의한다

2) 람다 함수 정의

import { DynamoDBClient, PutItemCommand } from "@aws-sdk/client-dynamodb";

export const handler = async (event) => {
  
  console.log(JSON.stringify(event));

  if (event.triggerSource === 'PostConfirmation_ConfirmSignUp') {
    const dynamoDBClient = new DynamoDBClient( { region: process.env.REGION } );
    const username = event.userName;
    const cognitosub = event.request.userAttributes.sub;
    const email = event.request.userAttributes.email;

    const putItemInput = {
      TableName: "Players",
      Item: {
        "databaseid": { S: cognitosub },
        "username": { S: username },
        "email": { S: email },
      }
    };

    const putItemCommand = new PutItemCommand(putItemInput);
    try {
      const putItemResponse = await dynamoDBClient.send(putItemCommand);
    } catch(error) {
      return error;
    }
  }
  return event;
};

위와 같이 CognitoPostConfirmation 람다 함수의 코드를 정의한다

Cognito 트리거 이벤트 종류를 체크하여 플레이어가 회원가입 후에 인증이 성공한 경우에만 로직을 수행
REGION 환경 변수를 사용하여 DynamoDB 클라이언트를 생성
인자로 전달받은 이벤트에서 핵심 사용자 정보 3가지를 추출
- userName : 플레이어의 이름
- cognitoSub : User Pool에서 부여하는 고유 식별자
- email : 플레이어의 이메일 주소
DynamoDB의 Players 테이블에 문자열 형태로 데이터들을 매핑
이후 DynamoDB에 데이터를 작성

3) 람다 함수 트리거 연결

현재 사용중인 User Pool의 Lambda 트리거에 CognitoPostConfirmation 람다 함수를 연결한다

회원가입 후의 인증이 끝나면 Players 테이블에 추가하는 람다이므로 사후 확인 트리거 방식으로 동작한다

- 최종 실행 결과

에디터를 실행한 후에 위와 같이 회원정보를 기입한다

기입한 이메일 주소로 도착한 인증 코드를 입력하여 플레이어를 인증한다

최종적으로 DynamoDB의 Players 테이블에서 위와 같이 데이터가 추가된 것을 확인할 수 있다

Dynamo DB - 1) 플레이어 데이터 테이블

monstro — Fri, 24 Jul 2026 11:04:06 +0900

- 개요

AWS에서 제공하는 서버리스 기반의 초고속, 완전관리형 NoSQL 데이터베이스인 Dynamo DB를 사용하여

플레이어에 관한 데이터를 관리 + 수정 + 저장한다

GameLift가 Game Session을 배포 + 확장 + 호스팅하는 역할을 수행한다면

DynamoDB는 Game Session 안과 밖에서 발생하는 막대한 데이터를 관리하는 용도로 사용한다

- 구성

1) 데이터 테이블의 생성

Dynamo DB의 테이블 생성 - 테이블 세부 정보

생성할 Dynamo DB의 테이블 이름과 파티션 키를 위와 같이 설정한다

세부 정보에서 적용할 수 있는 설정은 다음과 같다

테이블 이름 : 테이블의 고유 이름
파티션 키 : 생성할 테이블의 데이터를 여러 물리적 서버(파티션)로 나누어 저장할 때 기준이 되는 키
정렬 키 : 동일한 물리적 서버(파티션) 안에서 데이터를 정렬하는 기준이 되는 키

이후 설정은 기본값으로 설정한 후에 최종적으로 위와 같이 Players 테이블이 생성되었다

2) 데이터 테이블에 대한 작업 - 데이터 탐색

생성된 Players 테이블에 대해 항목 스캔 또는 쿼리를 사용하여 데이터를 탐색할 수 있다

두 방식은 각각 다음의 차이가 존재한다

항목 스캔 : 테이블의 전체 데이터를 끝까지 순회
쿼리 : 파티션 키를 사용하여 특정 데이터만 탐색

위와 같이 탐색 방식에 차이점이 있으므로 다음과 같이 사용하는 것이 권장된다

실시간 게임 서비스 및 일반적인 백엔드 API 처리 - 쿼리를 사용
전체 데이터 백업이나 일괄 분석 작업과 같은 특정 관리 목적 - 항목 스캔 사용

3) 데이터 테이블에 대한 작업 - 데이터 추가 및 삭제

생성된 Players 테이블에 대해 항목 생성을 선택하여 속성 - 값(Key - Value)의 데이터를 추가할 수 있다

추가할 속성 - 값의 쌍에 대한 속성의 유형을 정의할 수 있다

최종적으로 위와 같이 구성된 데이터 테이블을 생성하였다

데이터 테이블에서 속성을 선택하여 제거하는 작업도 가능하다

PlayerSession 처리 - 최종) UI를 통한 게임에 접속한 플레이어 표시

monstro — Thu, 23 Jul 2026 19:14:44 +0900

- 개요

로비에 UI를 추가하여 한 게임의 GameSession에 접속하는 플레이어들을 표시한다

- 스크립트 작업

1) LobbyState 클래스

GetPlayers 함수를 추가하여 PlayerInfoArray로부터 Players 변수를 반환한다

2) PlayerLabel 클래스

게임에 접속하는 플레이어에 대한 한 개의 행을 의미하는 PlayerLabel 클래스를 생성한다

멤버변수의 구성은 위와 같다

TexyBlock_UserName 멤버변수 : 플레이어의 이름을 보여주는 TextBlock UI

TextBlock UI에 대한 2개의 함수를 정의한다

SetUserName 함수를 호출하여 TextBlock UI의 텍스트를 설정하고

GetUserName 함수를 호출하여 TextBlock UI의 텍스트를 가져온다

3) LobbyPlayerBox 클래스

PlayerLabel을 담고 있는 박스의 역할을 수행하는 LobbyPlayerBox 클래스를 생성한다

멤버변수의 구성은 위와 같다

ScrollBox_PlayerInfo 멤버변수 : PlayerLabel을 담고 있는 Scroll Box UI
PlayerLabelClass 멤버변수 : 표현할 PlayerLabel의 Subclass

FindPlayerLabel 함수를 위와 같이 정의한다

스크롤 박스 안에 있는 PlayerLabel을 가져와 인자로 받은 플레이어의 이름에 대한 PlayerLabel을 반환한다

OnPlayerRemoved 함수를 위와 같이 정의한다

인자로 받은 LobbyPlayerInfo의 플레이어에 대한 PlayerLabel을 스크롤 박스에서 제거한다

CreateAndAddPlayerLabel 함수의 로직을 위와 같이 정의한다

새로운 PlayerLabel을 생성하고 스크롤 박스에 추가한다

UpdatePlayerInfo 함수를 위와 같이 정의한다

스크롤 박스에 저장된 다른 UI들을 초기화하고 현재 로비에 존재하는 플레이어에 대한

LobbyPlayerInfo만큼 순회하면서 PlayerLabel을 생성하고 스크롤 박스에 추가한다

OnLobbyStateInitialized 함수를 위와 같이 정의한다

인자로 받은 LobbyState의 OnPlayerInfoAdded와 OnPlayerInfoRemoved에 필요한 멤버 함수를 바인드하여

로비에 플레이어가 입장 / 퇴장하면 CreateAndAddPlayerLabel 함수와 OnPlayerRemoved 함수를 호출한다

위젯 생성 후에 한번만 호출하는 NativeOnInitialized 함수를 위와 같이 오버라이드한다

DSGameState의 LobbyState를 가져와 유효한지 체크한다

유효하다면 OnLobbyStateInitialized 함수에 LobbyState를 인자로 넘겨준다

유효하지 않다면 DSGameState의 OnLobbyStateInitialized 델리게이트에 OnLobbyStateInitialized 함수를 연결한다

4) DS_LobbyGameMode 클래스

CancleCountdown 멤버함수를 CheckAndStopLobbyCountdown 함수로 변경하고

위와 같이 3개의 새로운 함수를 추가한다

CheckAndStopLobbyCountdown 함수를 위와 같이 이름을 변경한다

CheckAndStartLobbyCountdown 함수를 위와 같이 추가한다

로비의 상태를 Seamless Travel 상태로 변경하고 카운트다운을 시작하는 기존 함수들의 로직을 함수로 구성하였다

AddPlayerInfoToLobbyState 함수의 로직을 위와 같이 정의한다

인자로 받은 플레이어에 대한 LobbyPlayerInfo를 DSGameState의 LobbyState에 저장한다

RemovePlayerInfoFromLobbyState 함수의 로직을 위와 같이 정의한다

DSGameState의 LobbyState에서 인자로 받은 플레이어에 대한 LobbyPlayerInfo를 제거한다

InitSeamlessTravelPlayer 함수에 위와 같이 로직을 추가한다

CheckAndStartLobbyCountdown 함수를 호출하여 Seamless Travel에 대한 카운트다운을 시작하고

AddPlayerInfoToLobbyState 함수를 호출하여 새로운 맵에 대해 재설정된 플레이어에 대한 LobbyPlayerInfo를 저장한다

Logout 함수에 위와 같이 로직을 추가한다

CheckAndStopLobbyCountdown 함수를 호출하여 로비 상태를 변경하고 카운트다운을 중단한다

이후 로비 상태가 변경되었다면 RemovePlayerInfoFromLobbyState 함수를 호출한다

PostLogin 함수에서 CheckAndStartLobbyCountdown 함수를 호출하도록 수정한다

새로 접속한 플레이어의 PlayerController가 생성된 후에 호출하는 InitNewPlayer 함수에 로직을 추가한다

로비의 상태가 Seamless Travel이 아니라면, AddPlayerInfoToLobbyState 함수를 호출하여

접속한 플레이어에게 생성된 PlayerController의 LobbyPlayerInfo를 저장한다

- 블루프린트 작업

1) WBP_LobbyPlayerLabel 위젯 블루프린트

위와 같이 구성된 PlayerLabel 위젯 블루프린트를 생성한다

하위 UI의 이름을 클래스의 멤버변수 이름과 통일한다

2) WBP_LobbyPlayerBox 위젯 블루프린트

1)에서 생성한 위젯 블루프린트를 포함하는 PlayerBox 위젯 블루프린트를 생성한다

동일하게 하위 UI의 이름과 클래스의 멤버변수 이름을 통일하였다

PlayerLabelClass 멤버변수를 1)에서 생성한 위젯 블루프린트로 설정한다

3) WBP_LobbyOverlay 위젯 블루프린트

로비에서 사용하는 Overlay 위젯 블루프린트에 2)에서 생성한 위젯 블루프린트를 추가한다

4) BP_LobbyGameMode 블루프린트

로비 레벨에서의 GameMode에서 사용할 GameState의 클래스를 위와 같이 설정한다

- 최종 실행 결과

# 1) 토큰 발급
aws gamelift get-compute-auth-token ^
--fleet-id "플릿 ID" ^
--compute-name "컴퓨팅 자원 이름" ^
--region "사용중인 리전" ^
--profile "프로필 이름" // 해당 옵션은 필요한 경우 사용

# 2) 발급된 토큰을 사용하여 서버 exe 파일 실행
"경로\Build\Build_5\운영체제Server\프로젝트Server.exe" -log -glAnywhere ^
-glAnywhereAuthToken="발급된토큰" ^
-glAnywhereHostId="컴퓨팅 자원 이름" ^
-glAnywhereFleetId="플릿 ID" ^
-glAnywhereWebSocketUrl="리전에 따른 소켓 URL" ^
-port=7777 // 기본 포트번호

이후 프로젝트를 패키징하여 Build_5 폴더에 저장한다

패키징이 끝난 후에 위와 같이 명령어를 입력하여 서버 exe 파일을 실행한다

로컬 좌표를 사용한 구 바운딩 볼륨 생성

monstro — Wed, 22 Jul 2026 19:23:43 +0900

- 개요

Render3D 함수의 로직 일부

절두체 컬링에 사용하는 구 바운딩 볼륨은 로컬 좌표를 기준으로 생성되는 데이터다

그러나 절두체 컬링은 뷰 공간에서 수행된다

따라서 이전에 수동으로 로컬 좌표로 저장된 구 바운딩 볼륨을 뷰 공간으로 변환하여 절두체 컬링을 진행하였다

하지만 매번 로컬 공간에 저장된 바운딩 볼륨을 뷰 공간으로 변환하는 작업은 다소 불편하다

따라서 이를 개선하여 로컬 공간의 데이터로 바로 절두체 컬링을 진행하도록 수정한다

- 개선 : 로컬 공간의 데이터를 활용한 바운딩 볼륨의 생성

원근 투영 행렬을 사용한 평면의 방정식

뷰 공간에서의 영역 판정을 위해 원근 투영 행렬을 사용하여 평면의 방정식을 생성할 수 있었다

이때 사용한 원근 투영 행렬을 P로, 클립 공간의 좌표를 V(clip)으로, 뷰 공간의 좌표를 V(view)로 표시하면

위와 같이 수식을 정리할 수 있다

위 식에서 뷰 행렬과 모델링 행렬을 사용한 복합 행렬과 로컬 공간의 좌표를 사용한 버전

이때 P 행렬을 구성하는 행벡터를 사용하여 각 평면의 방정식을 추출할 수 있다

이때 뷰 공간의 좌표가 아닌 로컬 공간의 좌표를 의미하는 V(local)을 사용한다면

모델링 행렬을 의미하는 M 행렬과 뷰 행렬을 의미하는 V 행렬을 사용하여 위와 같이 수식을 수정할 수 있다

위의 식에서 세 개의 행렬을 곱한 PVM 행렬은 4X4 행렬이므로 행벡터를 사용하여 평면의 방정식을 생성할 수 있다

평면의 방정식을 통해 만들어진 평면은 로컬 공간의 평면이 되므로

따라서 로컬 공간의 바운딩 볼륨 정보로 절두체 컬링을 수행하는 것이 가능하다

- 예제

Render3D 함수의 로직 일부

렌더링을 수행하는 Render3D 함수의 로직을 위와 같이 구성한다

원근 투영 행렬과 뷰 행렬이 결합된 pvMatrix 로컬 변수에 모델링 행렬을 곱하여

최종 행렬을 의미하는 finalMatrix 로컬 변수를 생성한다

finalMatrix 로컬 변수로부터 Transpose 함수를 호출하여 전치시킨 후에 행벡터에 접근한다

전치된 행렬로부터 절두체를 구성하는 6개의 평면을 생성한다

생성한 절두체의 평면으로부터 CheckBound 함수를 호출하고 구 바운딩 볼륨을 넘겨주어 절두체 컬링을 수행한다

- 최종 실행 결과

구 바운딩 볼륨을 이용한 절두체 컬링

monstro — Wed, 22 Jul 2026 16:23:52 +0900

- 개요

구 바운딩 볼륨을 사용하여 절두체 영역과 구 영역을 비교하는 CheckBound 함수를 사용하여 절두체 컬링을 진행한다

절두체 영역과 겹치는 구 영역의 게임 오브젝트는 붉은색으로 표시하고,

절두체 영역 내부에 포함된 구 영역의 게임 오브젝트는 일반적으로 표시한다

- 예제

Render3D 함수의 로직 일부

렌더링을 진행하는 Render3D 함수의 로직을 위와 같이 구성한다

intersectedObjects 로컬 변수를 사용하여 절두체 영역과 구 영역이 겹치는 경우를 파악한다

finalColor 로컬 변수를 사용하여 게임 오브젝트의 색상을 지정한다

이후 메시의 구 바운딩 볼륨을 가져와 sphereBound 로컬 변수에 저장하고

sphereBound의 반지름을 트랜스폼의 세 가지 값 중에서 가장 큰 값으로 반영한다

또, sphereBound의 중점을 로컬 공간에서 뷰 공간으로 변환한다

이후 CheckBound 함수를 호출하여 절두체 영역과 구 영역을 비교한다

절두체 영역과 구 영역이 겹치면 intersectedObjects의 값을 1 증가시키고 해당 오브젝트의 색상을 붉은색으로 설정한다

- 최종 실행 결과

바운딩 볼륨

monstro — Wed, 22 Jul 2026 11:05:46 +0900

- 개요

절두체에 걸쳐 있지만 절두체 컬링에 의해 그리기에서 제거된 게임 오브젝트

이전에 원근 투영 행렬을 활용한 절두체 컬링에서 카메라를 이동시키면

화면 가장자리의 게임 오브젝트가 갑자기 튀어오르거나 사라지는 현상이 발생하였다

위와 같은 현상이 발생하는 이유는 게임 오브젝트의 메시가 차지하는 공간 영역이 있음에도 불구하고

게임 오브젝트의 기존 위치만 가지고 절두체 컬링을 수행하기 때문이다

위의 이미지와 같은 상황에서 해당 게임 오브젝트는 그려져야 하지만

기존의 절두체 컬링 로직을 사용한다면 절두체의 외부에 있다고 판단하여 그리기를 생략한다

1) 바운딩 볼륨의 도입

이미치 출처 : https://gamedev.stackexchange.com/questions/114700/bounding-box-rotated-on-import

문제를 해결하기 위해 절두체 컬링은 게임 오브젝트의 위치가 아닌, 메시가 차지하는 영역을 대상으로 진행해야 한다

게임 엔진은 메시가 차지하는 영역을 효과적으로 관리하기 위해 구나 박스와 같은 원시 도형을 사용하는데,

이러한 원시 도형으로 설정한 공간 데이터를 바운딩 볼륨이라고 표현한다

위 이미지에서 회색 선으로 구성된 박스가 바운딩 볼륨을 의미한다

2) 구 바운딩 볼륨의 판정

한 점이 구의 외부에 있는지 판단하는 공식

위 공식의 시각화

구를 사용한 바운딩 볼륨의 판정 과정을 알아본다

구는 두 영역이 서로 겹치는지, 떨어져 있는지를 쉽게 판단할 수 있어 바운딩 볼륨에서 손쉽게 사용된다

하나의 점이 구의 외부에 있는지 판단하는 방법은 구의 중점에서부터 점까지의 거리와 구의 반지름을 비교하는 것이다

두 구의 영역이 서로 떨어져 있는지 판단하는 공식

위 공식의 시각화

또한 두 개의 구의 영역이 서로 떨어져 있는지 여부를 판단하는 공식은 위와 같다

두 구의 중점 사이의 거리와 두 구의 반지름의 합을 비교하여 두 구의 겹침을 판단할 수 있다

3) 프로젝트에서 구 바운딩 볼륨의 구현

3 - 1) 구의 선언

Sphere 구조체를 통해 프로젝트에서 구를 사용할 수 있다

멤버변수는 다음과 같다

Center 멤버변수 : 구의 중점
Radius 멤버변수 : 구의 반지름

멤버함수는 다음과 같다

IsInside 멤버 함수 : 구 영역이 어느 한 점을 포함하는지 판단
- 해당 함수를 호출하여 주어진 점과 중점과의 거리가 반지름보다 작으면 주어진 점은 구 안에 포함
Intersect 멤버 함수 : 두 구의 영역이 겹치는지 판단
- 해당 함수를 호출하여 두 구의 중점간의 거리가 두 구의 반지름의 합보다 작으면 두 구는 겹치게 됨

3 - 2) 메시 정보로부터 구를 생성

Sphere 구조체의 생성자에 메시의 정보를 넘겨주어 메시를 감싸는 구 영역을 생성할 수 있다

메시를 구성하는 모든 점의 위치 값에 대한 평균을 계산하여 중점 위치를 계산하고,

중점에서 가장 먼 점과의 거리를 구의 반지름으로 결정하면 메시의 모든 영역을 감싸는 구 영역을 생성할 수 있다

3 - 3) 메시에 대한 바운딩 볼륨을 생성

LoadResources 함수는 메시를 생성한다

이때 내부적으로 CaclulateBounds 함수를 실행하여 메시가 생성된 후에 메시의 바운딩 볼륨을 생성한다

3 - 4) 구 영역을 활용한 절두체 컬링

구 영역을 활용한 CheckBound 함수를 구성하여 구를 사용한 절두체 컬링을 구현한다

총 3개의 조건을 통해 게임 오브젝트를 그려야 하는지 판단한다

평면으로부터의 거리값 > 구의 반지름 : 해당 게임 오브젝트의 메시는 절두체의 외부에 존재
평면으로부터의 거리값 <= 구의 반지름 : 해당 게임 오브젝트의 메시는 절두체의 경계에 존재
그 외의 경우 : 해당 게임 오브젝트의 메시는 절두체의 내부에 존재