monstrosite

유니티 엔진의 구성 - 48) Game Override

monstro — Fri, 12 Jun 2026 14:59:34 +0900

- 개요

Game Override는 모든 유저에게 동일한 값을 주는 것이 아닌,

특정 Audience(특정 기준에 따라 분류한 유저 그룹)별로 서로 다른 게임 환경 또는 값을 제공하는 것을 의미한다

- 코드 구성

public class Test : MonoBehaviour
{
    private const string PLAYER_SPEED = "playerSpeed";
    private const string SCORE = "Score";

    public struct UserAttributes
    {
        public bool isBeginner;
    }

    public struct AppAttributes
    {
        public float version;
    }

    private async void Awake()
    {
        await UnityServices.InitializeAsync();

        await AuthenticationService.Instance.SignInAnonymouslyAsync();

        RuntimeConfig runtimeConfig = await RemoteConfigService.Instance.FetchConfigsAsync
        (
            new UserAttributes
            {
                isBeginner = true,
            },
            new AppAttributes
            { 
                version = 1.0f,
            }
        );

        Debug.Log("playerSpeed : " + runtimeConfig.GetFloat(PLAYER_SPEED));
        Debug.Log("score : " + runtimeConfig.GetInt(SCORE));
    }
}

이전에 사용한 코드를 위와 같이 수정한다

UserAttributes 구조체에 불리언 변수를 추가하였고, AppAttibutes 구초제에 실수 변수를 추가하였다

또, 서버에서 데이터 값을 반환하면서 두 구조체의 인스턴스를 생성하고 멤버변수의 값도 설정한다

- 사용절차

1) 첫 번째 단계

유니티 대시보드에 접속하여 Game Overrides를 선택한다

오른쪽 상단의 Create Game Override를 선택한다

2) 두 번째 단계

첫 번째 단계

생성할 Game Override의 이름과 상세설명을 작성한다

두 번째 단계

2번째 단계에서는 Audience를 설정한다

옵션은 2가지를 선택할 수 있다

Audiences 옵션 : 미리 제공된 사용자 그룹으로 목적에 맞게 선택 가능
JEXL 옵션 : 개발자가 정의한 구조체 속성이나 기본 제공되는 사용자 그룹을 조합하여 사용자 그룹 생성

사용자 그룹을 선택하면 하단의 Rollout Percentage 수치를 설정하여

타겟 사용자 그룹 중 몇 %에게 게임 환경이나 값을 적용할지 설정할 수 있다

두 번째 단계 - 실제 사용

실제 사용은 JEXL 옵션을 사용하여 생성한 2개의 구조체 속성을 사용하여 사용자 그룹을 설정하였다

두 번째 단계 - 실제 사용 (2)

사용자 그룹 비중은 위와 같이 100%로 설정한다

3) 세 번째 단계

사용자 그룹에 적용할 서비스를 선택한다

프로젝트에서는 Remote Config를 적용하도록 설정하였다

Config Overrides

초보자인 플레이어를 대상으로 하는 Config Overrides 생성하고 Score 변수의 값을 20으로 수정하여 적용한다

4) 네 번째 단계

네 번째 단계에서는 생성한 Game Override의 시작 + 종료 날짜를 지정하거나

여러 오버라이드가 충돌할 때를 대비한 우선순위를 지정할 수 있다

프로젝트에서는 위와 같이 기본값으로 설정한다

- 최종 실행 결과

생성한 Game Override에 대해서 우측 상단의 Enable을 선택해야 실제로 사용할 수 있다

프로젝트를 실행한 후에 로그를 확인해보면 10이 아닌 덮어씌워진 20이 출력되는 것을 확인할 수 있다

AWS Cognito - 최종) 인증 코드 예외 처리 + SignIn API 요청과 처리

monstro — Fri, 12 Jun 2026 11:36:44 +0900

- 개요

인증 코드를 입력하는 경우에 6자리 숫자만을 입력할 수 있도록 예외를 처리한다

또, 클라이언트에서 로그인 정보를 입력하여 SignIn API를 요청하고 로그인을 진행한다

이후 서버에서 처리한 결과를 반환하는 작업을 구현한다

- 스크립트 작업

1) ConfirmSignUpPage 클래스

회원인증 페이지 UI 클래스에 위 2개의 함수를 추가하여 입력한 인증 코드에 대한 예외를 처리하도록 설정한다

UpdateConfirmButtonState 함수의 로직은 위와 같다

함수가 호출된 시점에 static 정규표현식 객체를 생성하고

입력한 인증 코드가 정규표현식에 부합하면 버튼을 활성화 + 상태 메세지를 비우지만,

부합하지 않으면 상태 메세지를 통해 6자리 숫자를 입력하도록 알려준다

NativeConstruct 함수의 로직을 위와 같이 구성하여

TexBox에 입력할 때마다 UpdateConfirmButtonState 함수를 호출하도록 설정한다

2) PortalManager 클래스

서버에서 반환된 로그인 처리 결과를 브로드캐스트하는 SignInStatusMessageDelegate 멤버변수를 추가한다

SignIn_Response 함수를 추가하여 서버에서 반환된 로그인 처리 결과를 처리한다

Sign 함수의 로직을 위와 같이 구성한다

델리게이트에 False를 넘겨주어 브로드캐스트하여 필요한 하위 UI를 비활성화
서버에 전송할 HTTPRequest 객체 생성
민감한 정보를 포함하여 전송하므로 POST 함수로 설정 + HTTP 헤더 및 URL 설정
로그인에 필요한 데이터를 구성하고 JSON 포맷으로 직렬화
직렬화된 데이터를 포함한 HTTP 요청을 서버로 전송

SignIn_Response 함수의 로직을 위와 같이 구성한다

네트워크 연결이 실패했다면 델리게이트로 True를 브로드캐스트하여 필요한 하위 UI를 활성화
서버로부터 반환된 문자열을 JSON 데이터로 역직렬화
에러 메세지가 포함되어 있다면 마찬가지로 True를 브로드캐스트하고 얼리 리턴
리플렉션을 사용하여 JSON 데이터를 언리얼 구조체로 변환하고 Dump 함수를 호출하여 출력

3) SignInPage 클래스

헤더 파일

cpp 파일

로그인 페이지 UI 클래스에 UpdateStatusMessage 함수를 추가하여

TextBlock UI의 메세지를 설정하고 버튼 UI를 활성화한다

4) SignInOverlay 클래스

GameSession에 참여하는 테스트 위젯과 로그인 관련 페이지 UI들을 테스트하는 버튼 멤버변수를 제거한다

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

로그인 페이지 UI의 UpdateStatusMessage 함수를 Portal 중재자 클래스의 델리게이트에 연결한다

- 블루프린트 작업

1) WBP_SignInOverlay 위젯 블루프린트

불필요한 하위 UI들을 전부 제거한다

- 최종 실행 결과

회원가입

위와 같이 정보를 입력하여 회원가입을 진행한다

회원인증

위와 같이 발송된 인증코드를 입력하여 회원인증을 진행한다

인증 성공

회원인증이 성공하였다

로그인

로그인 후 Dump 함수 호출

로그인 후에 위와 같이 SignIn_Response 함수가 호출되고 내부적으로 Dump 함수가 호출된 것을 확인할 수 있다

AWS Cognito에서 실제 추가된 사용자를 확인할 수 있다

AWS Cognito - 13) ConfirmSignUp API 요청과 처리

monstro — Thu, 11 Jun 2026 19:51:14 +0900

- 개요

클라이언트에서 회원가입 후에 인증정보를 입력하여 ConfirmSignUp API를 요청하고 회원인증을 진행한다

이후 서버에서 처리한 결과를 반환하는 작업을 구현한다

- 스크립트 작업

1) HTTPRequestTypes 클래스

프로젝트에서 지정한 규격에 맞춰 구조체의 이름에 "DS"를 수식하여 이름을 수정한다

2) HTTPRequestManager 클래스

클라이언트에서 요청한 API의 실행이 성공하면 브로드캐스트하는 FOnAPIRequestSucceeded 델리게이트를 추가한다

자식 중재자 클래스에서는 해당 델리게이트를 사용하여 필요한 UI를 갱신한다

3) PortalManager 클래스

Portal 중재자 클래스에 위와 같이 회원인증 관련 멤버변수와 함수를 추가한다

LastSignUpResponse 멤버변수 : 서버로부터 반환된 회원가입 처리 결과를 저장
LastUsername 멤버변수 : 회원가입한 사용자의 이름을 저장
ConfirmStatusMessageDelegate 멤버변수 : 서버에서 반환된 회원인증 처리 결과를 브로드캐스트
OnSignUpSucceeded 멤버변수 : 회원가입이 성공한 경우에 브로드캐스트
OnConfirmSucceeded 멤버변수 : 회원인증이 성공한 경우에 브로드캐스트
Confirm_Response 함수 : 서버에서 반환된 회원인증 처리 결과를 처리하는 함수

SignUp 함수에 위의 로직을 추가하여 입력한 사용자의 이름을 사용하여 LastUserName 변수의 값을 설정한다

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

회원가입 요청 처리 결과를 역직렬화하여 에러가 포함되어 있다면 얼리 리턴한다

얼리 리턴되지 않았다면 문제가 없으므로 리플렉션을 통해 LastSignUpResponse 변수의 값을 설정하고

OnSignUpSucceeded 델리게이트를 브로드캐스트한다

Confirm 함수의 로직을 위와 같이 구성한다

델리게이트에 False를 넘겨주어 브로드캐스트하여 필요한 하위 UI를 비활성화
서버에 전송할 HTTPRequest 객체 생성
사용자의 데이터를 갱신하므로 PUT 함수로 설정 + HTTP 헤더 및 URL 설정
회원인증에 필요한 데이터를 구성하고 JSON 포맷으로 직렬화
직렬화된 데이터를 포함한 HTTP 요청을 서버로 전송

Confirm_Response 함수의 로직을 위와 같이 구성하여 서버로부터 반환된 회원인증 요청 처리 결과를 처리한다

네트워크 연결이 실패했다면 델리게이트로 True를 브로드캐스트하여 필요한 하위 UI를 활성화
서버로부터 반환된 문자열을 JSON 데이터로 역직렬화
네트워크 에러나 에러 메세지가 포함되어 있다면 True를 브로드캐스트하고 얼리 리턴
얼리 리턴되지 않았다면 OnConfirmSucceeded 델리게이트를 브로드캐스트

4) SignUpPage 클래스

함수 선언

회원가입 페이지 UI에 ClearTextBoxes 함수를 추가하고 위와 같이 정의한다

해당 함수를 호출하여 TextBox UI를 모두 초기화한다

5) ConfirmSignUpPage 클래스

회원인증 페이지 UI에 위와 같이 2개의 함수를 추가한다

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

해당 함수를 호출하여 TextBox UI를 모두 초기화한다

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

인자로 받은 문자열을 TextBlock UI에 적용하고 인자로 받은 불리언 값에 따라 버튼 UI를 활성화한다

6) SignInOverlay 클래스

중재자를 통해 회원가입과 회원인증의 성공을 전달받은 경우 호출할 2개의 함수를 추가한다

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

회원가입이 성공하는 경우 OnSignUpSucceeded 멤버함수를 호출하도록 바인드하고

회원인증이 성공하는 경우 OnConfirmSucceeded 멤버함수와

회원인증 페이지 UI의 UpdateStatusMessage 함수를 호출하도록 바인드한다

ConfirmButtonClicked 함수에 위와 같이 로직을 추가하여 회원인증 페이지 UI의 버튼을 비활성화한다

OnSignUpSucceeded 함수의 로직은 위와 같다

회원가입 페이지 UI의 TextBox들을 전부 초기화하고 회원인증 페이지 UI의 TextBox를 설정한다

이후 ShowConfirmSignUpPage 함수를 호출한다

OnConfirmSucceeded 함수의 로직은 위와 같다

회원인증 페이지 UI의 TextBox들을 전부 초기화하고 ShowSuccessConfirmedPage 함수를 호출한다

- 최종 실행 결과

회원가입

위와 같이 회원가입에 필요한 정보를 입력한다

회원인증

위와 같이 발송된 인증코드를 입력한다

회원인증 성공

위와 같이 회원인증이 성공하였다

AWS 콘솔

AWS 콘솔에서 확인해보면 위와 같이 인증된 사용자가 추가된 것을 확인할 수 있다

AWS Cognito - 12) SignUp API 요청과 처리

monstro — Thu, 11 Jun 2026 16:30:13 +0900

- 개요

클라이언트에서 필요한 정보를 입력하여 SignUp API를 요청하여 회원가입을 진행하고

서버에서 처리한 결과를 반환하는 작업을 구현한다

- 스크립트 작업

1) HTTPRequestManager 클래스

확장된 자식 중재자 클래스들에서 공통적으로 사용할 APIStatusMessage 델리게이트를 추가한다

중재자 클래스들은 용도에 맞춰 인자를 넘겨주어 해당 델리게이트를 브로드캐스트하고 UI를 갱신한다

2) GameSessionsManager 클래스

기존에 사용하던 고유한 델리게이트 멤버변수를 제거하고 상속받은 델리게이트 멤버변수를 사용한다

3) PortalManager 클래스

Portal 중재자 클래스에 회원가입과 관련된 동작을 처리하는 멤버변수와 함수를 추가한다

SignUpStatusMessageDelegate 멤버변수 : 서버에서 반환된 처리결과를 UI에 브로드캐스트하는 델리게이트
SignUp_Response 함수 : 서버에서 반환된 처리결과를 처리하는 함수

SignUp 함수의 로직을 위와 같이 구성한다

델리게이트에 False를 넘겨주어 브로드캐스트하여 필요한 하위 UI를 비활성화
서버에 전송할 HTTPRequest 객체 생성
회원가입할 데이터를 전송하므로 POST 함수로 설정 + HTTP 헤더 및 URL 설정
회원가입에 필요한 데이터를 구성하고 JSON 포맷으로 직렬화
직렬화된 데이터를 포함한 HTTP 요청을 서버로 전송

SignUp_Response 함수를 위와 같이 구성하여 서버로부터 반환된 회원가입 요청 처리 결과를 처리한다

네트워크 연결이 실패했다면 델리게이트로 True를 브로드캐스트하여 필요한 하위 UI를 활성화
서버로부터 반환된 문자열을 JSON 데이터로 역직렬화
에러 메세지가 포함되어 있다면 마찬가지로 True를 브로드캐스트하여 필요한 하위 UI를 활성화
리플렉션을 사용하여 JSON 데이터를 언리얼 구조체로 변환하고 Dump 함수를 호출하여 출력

4) SignUpPage 클래스

로그인 페이지의 UI 클래스에 로그인 상태에 따라 하위 UI를 갱신하는 함수를 추가한다

UpdateStatusMessage 함수의 로직은 위와 같다

인자로 받은 문자열을 TextBlock UI에 적용하고 인자로 받은 불리언 값에 따라 버튼 UI를 활성화한다

5) SignInOverlay 클래스

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

회원가입 페이지 UI의 UpdateStatusMessage 함수를 Portal 중재자 클래스의 델리게이트에 연결한다

- 최종 실행 결과

위와 같이 에디터에서 회원가입에 필요한 정보를 입력하고 회원가입을 진행한다

AWS 콘솔에 접속하여 AWS Cognito - 사용자 풀에서 새로 추가된 사용자를 확인할 수 있다

AWS Cognito - 11) 중재자 클래스 분리 + Cognito 반환값 구조체

monstro — Thu, 11 Jun 2026 11:34:07 +0900

- 개요

이전에 알아본 관심사 분리를 적용하여 GameSession의 중간 단계를 처리하는 Portal 중재자와

GameSession 관련 작업을 처리하는 중재자로 분리한다

또, AWS Cognito 관련 작업에 대한 데이터를 저장하는 구조체를 추가한다

- 스크립트 작업

1) HTTPRequestTypes 클래스

회원가입 관련 구조체

AWS Cognito의 회원가입 관련 구조체를 2개 추가한다

FCodeDeliveryDetails 구조체를 사용하여 인증 코드가 어디로 어떻게 발송되었는지에 대해 저장한다

FDSSignUpResponse 구조체를 사용하여 회원가입 요청을 보낸 후 서버로부터 받는 응답을 저장한다

로그인 및 인증 관련 구조체

AWS Cognito의 로그인 + 인증 관련 구조체를 2개 추가한다

FDSNewDeviceMetaData 구조체를 사용하여 새로운 기기나 브라우저에서 로그인했을 때 기억하거나 인증한다

FDSAuthenticationResult 구조체를 사용하여 로그인이 성공했을 때 발급되는 토큰 세트와 인증 결과를 저장한다

챌린지(추가 인증) 관련 구조체

AWS Cognito의 챌린지(추가 인증) 관련 구조체를 추가한다

FDSChallengeParameters 구조체를 사용하여 추가 인증시에 클라이언트에게 요구하는 파라미터를 저장한다

FDSInitiateAuthResponse 구조체를 사용하여 로그인을 처음 시도했을 때 서버가 반환하는 전체 응답을 저장한다

추가한 각 구조체들의 Dump 함수를 위와 같이 정의한다

멤버변수들을 로그로 찍어 출력한다

2) SignInOverlay 클래스

제거하는 함수

로그인 UI에 존재하던 GameSession 관련 2개의 함수를 제거한다

NativeConstruct 함수에서 버튼에 GameSesssion 관련 함수를 바인드하는 로직을 제거한다

3) PortalManager 클래스

GameSession의 중간 단계를 처리하는 Portal의 중재자 클래스에서

GameSession 관련 멤버변수와 함수, 델리게이트를 제거한다

Portal 중재자 클래스의 cpp 파일

최종적으로 Portal의 중재자 클래스의 cpp 파일은 위와 같이 구성된다

4) GameSessionsManager 클래스

Portal 중재자 클래스에서 제거한 GameSession 관련 요소를 GameSessions 중재자 클래스로 이주하였다

GameSessions 중재자 클래스의 cpp 파일 일부

GameSession 함수 정의부를 GameSessions 중재자 클래스의 cpp 파일로 이주하였다

- 블루프린트 작업

1) BP_PortalManager 블루프린트

PortalAPI 데이터 애셋을 사용하도록 수정한다

2) BP_GameSessionsManager 블루프린트

GameSessions 중재자 클래스의 블루프린트를 생성하고 GameSessionsAPI 데이터 애셋을 사용하도록 설정한다

유니티 엔진의 구성 - 47) Remote Config

monstro — Wed, 10 Jun 2026 19:55:37 +0900

- 개요

Remote Config는 게임 빌드를 새로 바꾸지 않고도

유니티 대시보드에서 게임 내 필드 값을 실시간으로 수정할 수 있는 서비스를 의미한다

주로 게임의 밸런싱이나, 보상 수정, 게임을 덮어씌우는 용도로 사용할 수 있다

- Remote Config 사용 절차

1) 패키지 설치 및 설정

Remote Config 패키지 설치

패키지 매니저를 통해 Remote Config 패키지를 설치한다

상단의 Project Settings - Services에서 프로젝트에 대한 Organization과 Project ID를 연결한다

상단 Window - Remote Config 탭을 눌러 Remote Config 탭을 열 수 있다

하단의 Add Setting 버튼을 눌러 프로젝트에서 사용하는 필드와 그 값을 추가할 수 있다

추가한 필드에서는 사용하는 데이터의 자료형에 따라 Type을 설정할 수 있다

Key를 통해 데이터를 탐색하고, Value를 통해 데이터의 값을 설정한다

2) 필드 추가 및 사용

2 - 1) Push - 로컬에서 서버로 데이터를 업로드

위와 같이 playerSpeed 데이터를 추가하고 값을 설정하였다

프로젝트의 데이터에 대해 위와 같이 Push와 Pull을 선택할 수 있다

Push : 로컬에서 변경한 설정을 서버로 업로드하는 용도
Pull : 서버에서 변경한 설정을 로컬로 업로드하는 용도

로컬에서의 Push 실행 결과

위와 같이 유니티 대시보드에서 Push된 데이터를 확인할 수 있다

2 - 2) Publish - 서버에서 로컬로 데이터를 배포

서버에서의 키 생성 + Publish

유니티 대시보드에서 Add Key를 선택하여 데이터를 추가하고

Publish를 선택하여 추가한 데이터를 로컬에 배포할 수 있다

로컬에서의 Pull 실행 결과

로컬에서 Pull을 실행하면 서버에서 추가한 데이터가 문제없이 로컬로 배포된 것을 확인할 수 있다

3) 스크립트를 통한 Remote Config 사용

public class Test : MonoBehaviour
{
    private const string PLAYER_SPEED = "playerSpeed";
    private const string SCORE = "Score";

    public struct UserAttributes
    { 
        // ...
    }

    public struct AppAttributes
    { 
        // ...
    }

    private async void Awake()
    {
        await UnityServices.InitializeAsync();

        await AuthenticationService.Instance.SignInAnonymouslyAsync();

        RuntimeConfig runtimeConfig = await RemoteConfigService.Instance.FetchConfigsAsync
        (
            new UserAttributes(),
            new AppAttributes()
        );

        Debug.Log("playerSpeed : " + runtimeConfig.GetFloat(PLAYER_SPEED));
        Debug.Log("score : " + runtimeConfig.GetInt(SCORE));
    }
}

위와 같이 코드를 구성하였다

Remote Config에 등록된 데이터의 Key를 의미하는 상수 문자열 변수 추가
Awake 함수 로직
- UnityServices.InitializeAsync 함수를 호출하여 유니티 백엔드 서비스 초기화
- AuthenticationService.Instance.SignInAnonymouslyAsync 함수를 호출하여 익명 로그인
- RemoteConfigService.Instance.FetchConfigsAsync 함수를 호출하여 서버에서 데이터 값 반환
- Key 상수 문자열을 이용하여 데이터의 값 출력

- 최종 실행 결과

최종 실행 결과는 위와 같다

Remote Config를 통해 원격에서 등록한 데이터의 값을 출력하였다

캐릭터 얼굴에서 발생한 왜곡 보정

monstro — Wed, 10 Jun 2026 16:46:19 +0900

- 개요

원근 보정 매핑을 적용하여 왜곡이 발생한 캐릭터의 얼굴을 보정한다

- 문제 상황

DrawTriangle3D 함수의 로직 일부

메시를 구성하는 삼각형을 그리는 DrawTriangle3D 함수의 일부 로직은 위와 같다

삼각형을 구성하는 세 개의 점의 무게중심좌표의 값이 [0, 1]의 범위내에 있는 경우에만

해당 픽셀의 최종 UV 값을 계산하도록 로직을 구성하였다

위와 같은 텍스처 매핑 기법을 "아핀 텍스처 매핑"이라고 표현한다

왜곡이 발생

위와 같이 아핀 텍스처 매핑을 수행하면 깊이 값을 고려하지 않아 위와 같이 왜곡이 발생하는 것을 확인할 수 있다

- 원근 보정 매핑의 사용

DrawTriangle3D 함수의 로직 일부

메시를 구성하는 삼각형을 그리는 DrawTriangle3D 함수의 로직을 위와 같이 수정한다

이전에는 무게중심좌표의 값만을 고려하여 아핀 텍스처 매핑을 수행하였지만,

추가적으로 뷰 공간의 Z값(깊이값)도 고려하는 원근 보정 매핑을 수행한다

수정한 코드는 다음과 같다

뷰 공간의 Z값(깊이값)이 보관된 클립 좌표의 W값의 역수를 로컬 변수에 각각 저장
NDC 공간의 무게중심좌표에 각각 역수를 곱해 분모 값을 구하고 z 로컬 변수에 저장
z 로컬 변수의 역수를 계산하여 invZ 로컬 변수에 저장
W값의 역수를 저장한 로컬 변수들에 무게중심좌표를 곱하고 추가로 invZ 변수를 곱하는 연산을 진행
최종적으로 뷰 공간에서 보간된 무게중심좌표를 계산하고 targetUV 로컬 변수에 저장

왜곡이 발생하지 않음

위와 같이 원근 보정 매핑을 사용하면 무게중심좌표 + 깊이값을 고려하여 매핑하므로 왜곡이 발생하지 않는다

원근 투영 (4) - 원근 보정 매핑

monstro — Wed, 10 Jun 2026 11:18:19 +0900

- 개요

이미지 출처 - https://en.wikipedia.org/wiki/Texture_mapping#Affine_texture-mapping

이전의 방식을 사용하여 깊이 값을 고려하지 않고 텍스처 매핑을 진행하는 경우

위와 같이 격자 무늬가 꺾이거나 캐릭터의 눈과 눈썹이 출렁거리는 왜곡을 발생시킨다

이는 아핀 텍스처 매핑이 깊이 값을 무시한 채 NDC의 무게중심좌표로만 텍스처를 선형 보간하기에 발생한다

- 문제 원인 파악

시야각에 걸쳐 있는 두 점과 이를 투영한 결과

문제의 원인을 명확히 알아보기 위해 위와 같이 투영 과정을 구성하였다

투영하기 전 사영 공간의 점 P1과 P2가 카메라 시야각에 걸쳐있다고 가정한다

위 2개의 점을 투영 평면에 투영한 점 N1과 N2의 NDC 좌표 값은 각각 -1과 1이 된다

그리고 카메라의 정면에 위치한 사영 공간의 점 P3를 투영한 NDC 좌표의 점 N3는 투영 평면의 중심에 위치한다

뷰 공간의 선을 수평으로 조정해 측정한 결과

NDC 공간에서 점 N1과 N2를 이어 선분을 생성하면 선분의 중앙에 위치한 중점 N3의 무게중심좌표는 0.5가 된다

이때 사영 공간에서의 점 P1과 P2를 잇는 선분의 점 P3의 무게중심좌표는 0.5보다 작은 값이다

위와 같이 왜곡이 발생하는 원인은 사영 공간의 무게중심좌표와 NDC에서의 무게중심좌표가 다르기 때문이다

이런 문제를 수정하기 위해서는 투영되기 이전의 사영 공간에서의 무게중심좌표를 사용해야 한다

- 투영 보정 보간

1) 원리

사영 공간의 무게중심좌표를 사용하기 위해서는 다음의 절차를 진행한다

투영 과정을 거꾸로 추적하여 NDC에서 무게중심좌표를 계산
계산한 무게중심좌표로부터 사영 공간의 무게중심좌표를 계산

위와 같이 투영 전의 무게중심좌표를 계산해 텍스처를 매핑하는 것을 "투영 보정 보간"이라고 표현한다

투영 보정 보간의 계산식을 유도하기 위해서는 반비례 함수 y = -(1/x)의 성질을 알아볼 필요가 있다

2) 반비례 함수의 성질

반비례 함수의 그래프

반비례 함수를 그래프로 표현하면 위와 같이 표현할 수 있다

X값 4에 대응하는 무게중심좌표 계산식

이때 x축에 위치한 2, 4, 6의 세 가지 수 중에서 가운데에 위치한 4의 무게중심좌표 a는 위 식을 통해 0.5로 계산된다

Y값 -(1/4)에 대응하는 무게중심좌표 계산식

다음으로 4에 대응하는 Y값 -(1/4)에 대응하는 무게중심좌표 a는 위 식을 통해 0.25로 계산된다

이 식을 응용하여 Y축의 무게중심좌표 0.25로부터 X축의 무게중심좌표 0.5를 계산하는 식을 찾는다면,

사영 공간에서의 무게중심값을 계산할 수 있다

Y축의 두 점 사이의 점을 구하는 수식

Y축에서의 무게중심좌표를 q1과 q2로 지정하고 이를 사용하여

Y축의 두 점 y1과 y2 사이의 점 y`를 계산하는 수식을 위와 같이 정리할 수 있다

무게중심좌표의 정의에서 두 무게중심좌표의 합 q1 + q2의 값은 1이다

X축의 두 점 사이의 점을 구하는 수식

다음으로 X축에서의 무게중심좌표를 t1과 t2로 지정하고 이를 사용하여

X축의 두 점 사이의 점 x`를 계산하는 수식을 위와 같이 정리할 수 있다

동일하게 t1 + t2의 값은 1이다

x`와 y`는 반비례 관계

이때 반비례 함수이므로 x`와 y`는 반비례 관계이다

따라서 위와 같이 각각의 y값을 x값으로 표현할 수 있다

Y축의 두 점과 무게중심좌표를 사용하여 x`점 계산

위에서 변환한 식을 응용하여 Y축의 두 점과 무게중심좌표를 사용하여 X축의 x`점의 값을 계산할 수 있다

위의 식에서 양변에 분모를 곱한 결과

위의 식의 양변에 분모를 곱하면 위와 같이 식을 변환할 수 있다

두 무게중심좌표의 합이 1임을 이용하여 식을 변환

위의 식에서 두 무게중심좌표의 합이 1임을 이용하여 식을 변환할 수 있다

최종 계산식

위의 식에서 양변의 덧셈항을 분리하면 최종 계산식을 얻을 수 있다

위의 식을 적용하면 X축에서의 무게중심좌표 0.5가 문제없이 계산되는 것을 확인할 수 있다

3) 최종 계산식을 세 점의 조합에 적용

최종 계산식을 세 점으로 확장한 수식

2)의 최종 계산식을 삼각형을 구성하는 세 점의 조합으로 확장하여 적용하였다

세 점으로 확장한 수식은 위와 같다

최종 투영 보간 계산식

확장한 최종 계산식을 사용하여 NDC에서 구한 무게중심좌표를 사영 공간의 무게중심좌표로 변환할 수 있다

사영 공간에서 NDC로 변환될 때 나누는 값은 뷰 공간의 Z값이므로

확장한 식에서 X를 -Z로 치환하면 최종 투영 보간 계산식을 얻을 수 있다

위의 수식을 활용한 텍스처 매핑을 "원근 보정 매핑"이라고 표현한다

레벨 생성 - 최종) 타일 추가와 타일맵의 NavMesh 수정

monstro — Tue, 9 Jun 2026 19:03:22 +0900

- 개요

생성할 수 있는 타일의 종류를 추가하고

타일 오브젝트를 다른 타일로 변경하는 경우 Layer를 수정하여 NavMesh Surface를 다시 굽는 로직을 추가한다

- 스크립트 작업

1) TileSetHolder 클래스

타일의 종류를 모아놓는 컴포넌트의 클래스에 작은 코너 타일을 추가한다

2) TileSlotEditor 클래스

OnInspectorGUI 함수에 로직을 추가하여 코너 타일의 UI에 행을 추가하고 작은 타일로 변경하는 버튼을 생성한다

3) TileSlot 클래스

GetTileNavMeshSurface 함수를 추가하여 부모 오브젝트의 NavMeshSurface 컴포넌트를 반환한다

UpdateNavMeshSurface 함수를 호출하여 새롭게 NavMesh Surface를 굽는다

UpdateTileLayer 함수를 추가하여 위와 같이 구성하였다

GetStaticEditorFlags 함수를 호출하여 변경할 타일 오브젝트의 물리 / 최적화 설정을 저장하고

SetStaticEditorFlags 함수를 호출하여 변경하기 이전의 타일 오브젝트에 덮어씌운다

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

트랜스폼이 변경되면 NavMesh Surface를 다시 굽도록 설정한다

에디터인 경우에 위의 함수를 호출하도록 설정한다

Undo 또는 Redo가 실행되면 UpdateNavMeshSurface 함수를 호출하여 NavMesh Surface를 조정한다

SwitchTile 함수의 로직을 일부 분리하여 UpdateChildren 함수를 위와 같이 구성한다

이전의 로직에서 부모 오브젝트의 물리 설정을 저장하고 자식 오브젝트에 적용하는 로직을 추가하였다

최종적으로 자식 오브젝트의 트랜스폼 + Layer를 설정한다

SwitchTile 함수의 로직을 위와 같이 구성하였다

Undo.RegisterCompleteObjectUndo 함수를 호출하여 변경하기 이전의 타일 오브젝트를 기록한다

또, Undo.RecordObject 함수를 호출하여 오브젝트의 변경 사항을 Undo에 기록한다

이후 3개의 함수를 호출하여 타일 오브젝트를 수정한 후에 자식 오브젝트 + Layer + NavMesh Surface를 조정한다

4) GridBuilder 클래스

GetNavMeshSurface 함수를 추가하여 NavMesh Surface 컴포넌트를 반환한다

UpdateNavMesh 함수를 호출하여 NavMesh Surface를 다시 굽고,

ClearNavMesh 함수를 호출하여 존재하는 NavMesh Surface를 제거한다

에디터인 경우에 위의 함수를 호출하도록 설정한다

Undo 또는 Redo가 실행되면 UpdateNavMeshSurface 함수를 호출하여 NavMesh Surface를 조정한다

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

타일 맵이 생성되면서 만들어지는 다수의 타일 오브젝트를 Undo 그룹에 기록한다

타일 맵이 생성된 후에 UpdateNavMesh 함수를 호출하여 NavMesh Surface를 생성한다

기록된 Undo 그룹을 하나로 뭉쳐 Undo 또는 Redo할 수 있도록 설정한다

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

타일 맵이 제거되면서 제거되는 다수의 타일 오브젝트를 Undo 그룹에 기록한다

타일 맵이 제거된 후에 ClearNavMesh 함수를 호출하여 NavMesh Surface를 제거한다

기록된 Undo 그룹을 하나로 뭉쳐 Undo 또는 Redo할 수 있도록 설정한다

- 애셋 작업

1) GridBuilder 오브젝트

위와 같이 타일 맵을 생성하는 오브젝트에 컴포넌트가 수식될 수 있도록 설정한다

TileSetHolder 컴포넌트 : 교체하거나 생성할 타일의 종류를 저장
GridBuilder 컴포넌트 : 지정한 타일로 구성된 타일맵을 생성
NavMesh Surface 컴포넌트 : Road 레이어로 지정된 적의 이동 경로를 생성

- 최종 실행 결과

레벨 생성 - 4) 타일맵 생성

monstro — Tue, 9 Jun 2026 11:21:08 +0900

- 개요

레벨을 구성하는 타일들로 이루어진 타일맵을 자동으로 생성하는 시스템을 추가한다

- 스크립트

1) TileSlot 클래스

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

Undo 그룹을 생성하여 모든 변경사항에 대해 Ctrl + z나 Ctrl + y를 한번 눌러 Undo 또는 Redo를 하도록 설정한다

또, 변경하기 이전의 타일 오브젝트의 이름도 Undo에서 저장하도록 설정한다

변경된 타일의 자식 오브젝트들을 생성하고 자식 오브젝트들의 위치를 Undo에서 저장하는 로직을 추가하였다

마지막으로 Undo.CollapseUndoOperations 함수를 호출하여 Undo 그룹을 완성한다

UpdateCollider 함수를 위와 같이 수정하여

조건문에서 is 연산자를 사용하여 newCollider 매개변수가 자식 클래스 타입이라면 즉시 로컬 변수에 할당한다

위와 같이 구성하여 GetComponent 함수를 호출하는 로직을 제거하였다

2) GridBuilder 클래스

타일맵을 생성하는 클래스의 멤버변수를 위와 같이 구성한다

mainPrefab 멤버변수 : 생성할 타일맵의 타일
gridLength 멤버변수 : 타일맵의 길이
gridWidth 멤버변수 : 타일맵의 너비
createdTiles 멤버변수 : 생성한 타일맵을 구성하는 타일들

CreateTile 함수를 위와 같이 생성한다

mainPrefab 멤버변수를 바탕으로 게임 오브젝트를 2개의 인자로 지정한 위치에 생성한다

이후, createTiles 멤버변수에 생성한 오브젝트를 저장하고 Undo에 기록한다

ClearGridInternal 함수를 위와 같이 구성하였다

타일들이 저장된 createdTiles 멤버변수를 순회하면서 생성된 타일 오브젝트를 제거한다

Undo.DestoryObjectImmediate 함수를 호출하여 제거된 타일 오브젝트를 기록한다

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

ContextMenu 어트리뷰트를 사용하여 컴포넌트를 우클릭하여 함수를 호출한다

Undo.IncrementCurrentGroup 함수를 호출하여 Undo 그룹을 생성하고 createdTiles 멤버변수를 기록한다

이후 ClearGridInternal 함수를 호출 + Clear 함수를 호출하여 생성된 타일 오브젝트들을 완전히 제거한다

이후 수정된 내용을 저장한다

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

Undo.IncrementCurrentGroup 함수를 호출하여 createdTiles 멤버변수의 상태를 기록한다

gridLength 변수와 gridWidth 변수의 값만큼 순회하면서 CreateTile 함수를 호출하여 타일 오브젝트를 생성한다

이후 수정된 내용을 저장한다