이개 - 이것저것 개발 블로그

언리얼 엔진으로 좁은 에어리어 바닥 만들기

이개 — Mon, 13 Jul 2026 17:12:34 +0900

카툰풍 3D 배경(고양이 파티 게임 마당 씬) 바닥 제작 과정 정리. 잔디+흙길 자연스럽게 섞인 바닥을 텍스처 두 장 + 버텍스 페인트로 구현.

방식 선택 이유

랜드스케이프: 지형 굴곡엔 좋으나 마당 규모엔 과함
대신 Plane 하나 + 버텍스 컬러 블렌딩 채택 → 작업량 절감

핵심 구조:

잔디/흙 텍스처를 머티리얼에서 Lerp로 블렌딩
흙길 위치는 버텍스 컬러로 직접 페인팅

1단계. 버텍스 페인트 가능한 Plane 제작

기본 Plane = 폴리곤 2개(버텍스 4개) → 버텍스 페인트 시 경계 각짐. 촘촘한 격자 필요.

모델링 모드에서 사각형을 선택

바닥의 가로세로 길이를 설정하고, 텍스처를 깨짐없이 적용하기 위해 너비와 뎁스 서브디비전을 적당히 설정한다.

Select Mode 드롭다운 → Modeling 모드
Create 탭 → Rectangle 툴 (Plane 역할)
Details 패널 설정
- Width / Height: 마당 크기 기준 (예: 2000 x 2000 = 20m x 20m)
- Width/Height Subdivisions: 20 x 20 (버텍스 페인트 해상도 결정)
Accept로 생성

2단계. 텍스처 준비

필요 텍스처:

Grass 계열 (Base Color)
Dirt 계열 (Base Color)

선정 기준

리얼한 개별 잎사귀/흙 알갱이 텍스처 제외 — 툰 캐릭터와 이질감 심함
"Stylized", "Toon", "Cartoon" 태그 우선 검색
해상도 1K~2K 충분, 4K는 낭비
마땅한 것 없으면 직접 제작 가능. 단색 베이스 + 약한 노이즈 정도로 충분
- AI로 생성가능
- 1024x1024정도로 생성
직접 제작 시 타일링 검증 필수 — Photoshop Filter → Other → Offset으로 이미지 절반 밀어서 이음새 확인

3단계. 머티리얼 그래프 구성

UV 타일링

TexCoord[0] → Multiply (B값: 10 정도) → 각 텍스처 샘플 UV 입력에 연결

타일링 값 = 텍스처 한 장이 덮는 실제 미터 수 기준 산출.

Grass/Dirt 블렌딩

Texture Sample 노드 2개 — Grass, Dirt 각각 할당, UV 타일링 노드 연결
Vertex Color 노드 추가
Vertex Color → Component Mask (R만 체크)
Lerp 노드
- A = Grass
- B = Dirt
- Alpha = Mask(R) 결과
Lerp 결과 → Base Color 핀

버텍스 컬러 R=0 → Grass / R=1 → Dirt / 중간값 → 자연 블렌딩

노멀맵 입체감

밋밋하면 노멀맵 추가. 세게 넣으면 실사틱해짐 → 강도 낮춰야 함.

Texture Sample — 노멀맵 텍스처 (동일 UV 타일링)
Flatten Normal 노드
- Normal 입력 = 위 텍스처 샘플
- Flatness = Constant (0.7~0.8, 0에 가까울수록 원본, 1에 가까울수록 평평)
결과 → Normal 핀

반사 제거 (매트한 표면)

Specular: 0.0
Roughness: 1.0

Constant 노드로 각각 연결.

4단계. 버텍스 페인트로 흙길 그리기

머티리얼을 Plane에 할당
Select Mode → Mesh Paint 모드
메시 선택 후 좌측 패널
- Paint Color: 빨강 (R=1, G=0, B=0)
- Brush Size / Strength 조절
원하는 부분 브러시로 칠 → 실시간 Dirt 전환 확인
잘못 칠했으면 검정(R=0)으로 재작업
초기 버텍스 컬러값이 예상과 다를 수 있음 — 결과 이상하면 채우기(Fill) 로 전체 리셋 후 재작업

팁

Brush Strength 낮게 → 덧칠할수록 진해짐 → 자연스러운 그라데이션 경계
경계 또렷하게: 작은 브러시 정교하게 / 부드럽게: 큰 브러시 여러 번 겹침

완성

텍스처 2장 + 노멀맵 1개로 원하는 형태의 흙길 있는 스타일라이즈드 바닥 완성. AO/Height 맵은 이 규모 씬에선 생략해도 무방 — 결과물 차이 미미.

바닥 위에 담장/폴리지/원경 배경 추가 예정. 다음 글에서 정리.

언리얼 내배캠 - 멀티플레이 채팅 구현

이개 — Mon, 22 Jun 2026 19:39:48 +0900

PlayerController.h에 ClientRPCPrintChatMessageString, ServerRPCPrintChatMessageStirng 함수 추가

채팅이란 클라이언트에서 서버 RPC로 보내고, 서버에서 클라이언트 RPC로 전체 출력을 해주는 구조이다.

이 함수들을 구현할 때는 함수명 뒤에 _Implementation 접미사를 붙여주어야한다.

추가로 WithValidation 키워드를 붙이면 _Validate()도 반드시 구현해야하고, 여기서 치트 방지 검증을 한다.

for문으로 플레이어 컨트롤러 전체를 돌며 메시지 출력 함수를 실행해준다.

EngineUtils.h를 추가해야 GetWorld의 ActorIterator를 사용할 수 있다.

ClientRPC 대신 NetMulticastRPC를 사용하면 안 되는 이유

SetChatMessageString을 구현한다.

Run Under One Process를 체크 해제했으면, 서버를 켠 상태에서는 에디터가 꺼져도 서버 등은 계속 실행이 되는 경우가 있다.

빌드해서 실행한 모습을 보면 정상적으로 플레이어 화면들에 채팅 메시지가 출력된다.

누군가가 접속하면 메세지 출력

플레이어가 접속할 때마다 호출되는 함수

NetMulticast RPC를 통한 서버 접속 알리기

GameMode같은 경우에는 Server에만 존재하므로, 접속 메시지의 경우 모든 플레이어에 존재하는 GameState에서 NetMulticast로 호출해 주는 것이 맞다.

GameModeBase를 만들었으므로 GameStateBase를 새로 만들어준다.

헤더에 MulticastRPCBroadcastLoginMessage라는 함수를 선언한다.

MulticastRPCBroadcastLoginMessage_Implementation으로 함수를 구현해준다.

UFUNCTION(NetMulticast, Reliable) 매크로를 선언하면 UHT가 자동으로 코드를 생성한다.

원본 함수는 UHT가 이미 구현해버리기 때문에, 실제 로직은 함수명에 _Implementation을 붙여 구현해야한다. 그렇게 하지 않으면 중복 정의 에러가 난다.

GameStateBase에 OnPostLogin을 오버라이드하여 채팅 출력 코드를 작성한다.

에디터에서 만든 게임스테이트를 설정한다.

클라이언트를 추가 실행할 때마다 다른 클라이언트에 메시지가 뜨는 것을 확인할 수 있다.

언리얼 내배캠 - 언리얼 멀티플레이 기초 RPC(Remote Procedue Call)

이개 — Fri, 19 Jun 2026 11:31:55 +0900

RPC란?

호출하는 PC와 실행하는 PC가 달라도 되게끔 해주는 통신 기법
대부분 게임에 큰 영향을 끼치지 않는 일시적인 효과들에 사용해야한다.
게임에 큰 영향을 끼치는 것들은 프로퍼티 레플리케이션을 사용해야 한다.

Call vs Invoke

Call
Invoke

Actor Ownership

네트워크 멀티플레이가 적용되려면, 액터는 서버에서 스폰되고 bReplicated가 true여야한다.
서버에서 스폰된 후 SetOwner(PlayerController) 함수를 호출해야 Client-Owned Actor가 된다.
PlayerController가 Local PlayerController와 같다면, 호출한 클라이언트가 소유한 액터가 되어야 한다.
PlayerController가 Local PlayerController와 다르다면 다른 클라이언트가 소유한 액터가 되어야한다.
서버에서 스폰되었지만 SetOwner() 함수 호출이 없으면, Server-Owned Actor가 되어야한다.
Unowned Actor와 Server-Owned Actor를 같은 개념으로 생각하면 된다.

NetMulticast, Server, Client 키워드

UFUNCTION() 매크로와 함께 사용되는 키워드
해당 원격 PC에서 RPC를 실행시켜달라는 요청을 나타내야함
실제로 실행될지는 표에 따라 판단

NetMulticast RPC는 액터가 레플리케이트 되어있는 모든 컴퓨터에서 실행

Server RPC는 클라이언트에서 호출되고 서버에서 실행

Server 키워드를 사용
ClientConnection이 소유하고 있는 액터에서 RPC가 호출되어야함

Client RPC는 서버에서 호출되고 클라이언트에서 실행

해당 ClientConnection이 소유하고 있는 액터에서 RPC가 호출되어야 한다.
PlayerController의 멤버 함수로 UFUNCTION 달고 클라이언트 키워드를 넣어주면 된다.

WithValidation

UFUNCTION() 매크로와 함께 사용되는 키워드
서버에서 실행되는 RPC인 경우에 사용
_Implementation() 함수와 _Validate() 함수로 나뉨

Unreliable VS Reliable

UFUNCTION() 매크로와 함께 사용되는 키워드
RPC는 기본적으로 Unreliable
코스메틱(이펙트, 사운드)처럼 큰 영향이 없으면 Unreliable, 충돌, 대미지, 스폰처럼 게임에 큰 영향을 끼치는 로직은 Reliable로 설정

언리얼 내배캠 - 언리얼 멀티플레이 기초 NetRole

이개 — Thu, 18 Jun 2026 12:57:19 +0900

액터가 서버 PC에 스폰되어있는지, 클라이언트 PC에 스폰되어있는지, 그 액터의 멤버 함수가 서버 PC에서 실행되고 있는지, 클라이언트 PC에서 실행되고 있는지도 파악해야한다.

서버에 스폰된 액터가 가진 NetRole 속성값은 언제나 Authority

-> 그래서 게임에 중대한 영향을 끼치는 로직은 NetRole이 Authority일 때 수행

NetRole이 Authority인 액터가 클라이언트로 복제되었을 때 복제된 액터의 NetRole 속성값은 Proxy이다. 여기서는 중요한 로직을 수행해서는 안 된다.

로컬 롤과 리모트 롤

현재 동작하는 컴퓨터에서의 롤을 로컬 롤(Local Role)이라고 한다.
커넥션으로 연결된 컴퓨터에서의 롤을 리모트 롤(Remote Role)이라고 한다.

NetRole의 종류

None
Authority
Autonomous Proxy
Simulated Proxy

로그 찍어보기

FString LocalRoleString = UEnum::GetValueAsString(TEXT("Engine.EnetRole"), InActor->GetLocalRole());

GetValueAsString이 String을 만들어준다.

Pawn클래스를 하나 만든다.

Wordl Settings에 만든 Pawn을 할당하고 실행해보면 로그를 확인할 수 있다.

Client 2개는 로컬 롤이 ROLE_Authority, 리모트 롤은 ROLE_SimulatedProxy.
PossessedBy가 된 뒤에 Autonomous Proxy가 됨.
AActor::HasAuthority(): 주요 로직 실행 권한 확인. NetRole이 Authority이면 서버이므로 서버인지 확인 가능. 다만 리슨 서버는 플레이어도 겸하기 때문에 true라고 해서 플레이어가 아니라고 단정할 수는 없다. Standalone이어도 true가 나온다.
AController::IsLocalController(): 입력 관련 로직이나 UI는 Autonomous Proxy에서 수행되어야한다. 이를 확인하는 함수.
APawn::IsLocallyControlled(): IsLocalController를 래핑했다고 보면 된다.

각 액터에 따른 특징

게임모드
폰
애니메이션 재생이나 UI 관련 로직

언리얼 내배캠 - 언리얼 멀티플레이 기초 NetMode, NetConnection, NetDriver

이개 — Wed, 17 Jun 2026 10:03:06 +0900

NetMode

해당 게임 프로세스가 네트워크 상에서 어떤 역할을 하고 있는지를 의미
싱글(NM_StandAlone), 서버(NM_Listen, NM_DedicatedServer), 클라이언트(NM_Client)

NetMode의 필요성

작성 중인 로직이 서버에서 도는지 클라이언트에서 돌고 있는지는 알아야할 때
멀티플레이 시에 가장 큰 걸림돌은 같은 코드가 여러 PC에서 동작한다는 것
디버깅을 할 때 어떤 PC에서 동작중인지를 살펴보아야한다.
NetMode는 월드 클래스의 속성값, NetRole은 액터의 속성값이라고 보면 된다.

UWorld::InternalGetNetMode() 함수

NetDriver가 NULL이 아니면 클라이언트나 서버 중 하나다.

GetNetMode에서는 IsServer로 서버 여부를 먼저 판단하고, 클라이언트이자 서버면 리슨서버, 아니면 데디서버로 나눈다.

IsServer에서는 ServerConnection이 없다면 클라이언트로 판단한다.

NetConnection이란?

다른 PC와의 연결이 발생하면 그에 대응하는 UNetConnection 객체가 생성됨
클라이언트가 접속하면 서버에는 ClientConnection객체, 클라이언트에는 ServerConnection 객체가 생성됨
두 PC는 UNetConnection 객체를 통해 통신
UNetDriver는 생성된 UNetConnection 객체를 소유하고 관리
서버 PC에 생성된 UNetDriver는 접속한 클라이언트의 수만큼 UNetConnection을 관리
클라이언트 PC에 생성된 UNetDriver는 ServerConnection 하나만 관리
NetConnection은 PlayerController를 소유

클라이언트끼리의 통신은 불가능하고, 오직 서버와 클라이언트 사이의 통신만 가능하다.

NetDriver 구성요소

ServerClient는 하나고 ClientConnections는 복수형인 것을 알 수 있다.

NetDriver는 멀티플레이를 하기 위해서는 연결된 모든 디바이스에서 필수적으로 실행되어야한다. 오너가 서버인지 클라이언트에 따라 ClientConnections 데이터를 가지고 있는지, ServerClient 데이터를 가지고 있는지가 다르다.

멀티플레이어에서의 OwnerShip

하나의 ClientConnection은 하나의 PlayerController를 소유
PlayerController의 Owning Connection은 ClientConnection인 셈
PlayerController가 빙의하는 Pawn의 Owner 속성은 해당 PlayerController로 설정됨
폰에 무기 액터가 생성되고, 무기 액터의 Owner 속성에 해당 폰을 설정할 수 있음
ClientConnection에서부터 무기 액에터 이르는 소유관계를 패밀리라고도 부름
소유 관계 속 액터가 본인의 Owing Connection을 얻으려면 AActor::GetNetConnection() 함수를 호출하면 된다.

NetDriver란?

언리얼 네트워크 통신에서 로우레벨 동작들을 관리하는 클래스
싱글 플레이에서는 생성되지 않음
멀티플레이에서만 UWorld::Listen()함수를 통해 UNetDriver 객체가 생성됨
멀티플레이에 참여하는 각 PC마다 생성됨

멀티플레이용 디버깅로그 작성하기

데디서버는 뷰포트가 필요없다.

위와 같이 로그 코드를 추가하고 클라이언트에서 메시지를 치면 클라이언트로 나온다.

플레이어 수 1, 넷모드는 Standalone으로 변경한다.

if (IsLocalController() == false)

{

return;

}

이 부분을 빼고 코드를 추가 수정하면 StandAlone인지 알 수 있다.

로깅할 때 이런 식으로 어느 쪽에서 작동하는지를 표시해주어야한다.

StandAlone

게임이 원격 클라이언트의 연결을 허용하지 않는 서버로 실행 중
커넥션 없음
모든 플레이어는 로컬 플레이어
싱글 및 로컬 플레이에 사용
로컬 플레이어에 맞게 서버측 로직과 클라이언트축 로직을 모두 실행

Client

게임이 네트워크 멀티플레이 세션에 서 서버에 연결된 클라이언트로 실행됨
서버 측 로직을 실행하지 않음
서버로부터 복제된 Proxy만 보여주는 역할을 함

Listen 서버

게임이 네트워크 멀티플레이어 세션을 호스팅하는 서버로 실행 중
원격 클라이언트의 연결을 수락하고 로컬 플레이어를 서버에 직접 배치
서버 자신도 게임에 참여

Dedicated Server

게임이 네트워크 멀티플레이 세션을 호스팅하는 서버로 실행됨
로컬 플레이어가 없음
그래픽, 사운드 등 플레이어 중심 기능 삭제

서버에만 존재하는 액터

게임모드

서버와 모든 클라이언트에 존재하는 액터

배경 액터와 폰

서버와 클라이언트에만 존재하는 액터

플레이어 컨트롤러

클라이언트에만 존재하는 언리얼 오브젝트

클라이언트에서 GameMode를 호출하면 nullptr이 반환된다. 그래서 GameMode에 접근하려면 Server RPC 함수 내에서 접근하거나, 서버에서도 수행되는 함수 내에서 HasAuthority() 함수로 서버임을 확인하고 접근한다.

언리얼 내배캠 - 언리얼 멀티플레이 기초 실습 환경 설정

이개 — Tue, 16 Jun 2026 09:14:16 +0900

플레이모드 메뉴에서 플레이어 수를 2, 넷모드는 클라이언트로 지정해준다.

PIE 모드로 실행시키고 채팅을 치면 동기화가 되는 것을 볼 수 있다.

출력 로그는 이러하다.

모든 것이 동기화 될 필요는 없다. 위젯 객체같은 경우 Owning Client에서만 생성되면 된다. 로컬 플레이어 컨트롤러가 아니면 위와 같은 에러가 뜨게 된다.

Ctrl + T를 눌러 코드를 검색할 수 있다.

CXPlayerController.cpp

IsLocalController() 조건을 걸어주면 정상 처리된다.

채팅을 치면 다른 클라이언트에서 보이는 이유

Run Under One Process 속성 때문

데디케이티드 서버 환경 설정

에디터 개인설정->레벨 에디터 카테고리의 플레이-> 단일 프로세스 하 실행 체크 해제

체크할 경우

체크 해제 후 실행하면 서버가 따로 실행되며 Join Succeeded라는 메뉴가 출력된다.

이렇게 멀티 프로세스로 실행 시에는 내 화면에서만 문장이 출력된다.

추가로 Allow Late Joining을 체크하여 Add another cliner 버튼으로 클라이언트 추가가 가능하게 한다.

클라이언트 추가 버튼으로 클라이언트를 추가할 수 있다.

Always on top 체크하면 새 클라이언트 화면이 항상 위에 뜬다.

Multiplayer Options에서 추가설정이 가능하다.

개별 서버 실행

체크 시 서버를 따로 띄워준다
미체크 시 에디터 화면이 클라이언트이자 서버가 된다.

언리얼 내배캠 마스터반 - Subsystem 기반으로 아이템 매니저 만들기

이개 — Mon, 15 Jun 2026 08:05:38 +0900

총 세 가지의 클래스를 만든다.

GameInstanceSubsystem → ItemManagerSubsystem
PrimaryDataAsset → ItemDataAsset
플레이하고 아이템 장착 할 액터 → ItemManagerTestCharacter

#include "Engine/AssetManager.h"

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnItemLoaded, FPrimaryAssetId, AssetId);


public:
    // 서브시스템 초기화 시 호출
    virtual void Initialize(FSubsystemCollectionBase& Collection) override;

    // 아이템 비동기 로드 요청
    UFUNCTION(BlueprintCallable, Category = "ItemManager")
    void RequestAsyncLoadItem(FPrimaryAssetId AssetId);

    // 로드된 아이템 가져오기 (이미 로드된 경우만 반환)
    UFUNCTION(BlueprintCallable, Category = "ItemManager")
    class UMyItemDataAsset* GetItemData(FPrimaryAssetId AssetId);

    // 아이템 메모리 해제
    UFUNCTION(BlueprintCallable, Category = "ItemManager")
    void UnloadItem(FPrimaryAssetId AssetId);



    //델리게이트
    UPROPERTY(BlueprintAssignable, Category = "ItemManager")
    FOnItemLoaded OnItemLoaded;


private:
    void OnLoadCompleted(FPrimaryAssetId AssetId);

    // 로드된 핸들을 보관하여 가비지 컬렉션을 방지
    TMap<FPrimaryAssetId, TSharedPtr<FStreamableHandle>> LoadingHandles;

void UItemManagerSubsystem::Initialize(FSubsystemCollectionBase& Collection)
{
	Super::Initialize(Collection);
	UE_LOG(LogTemp, Log, TEXT("Item Manager Subsystem Initialized!"));
}

void UItemManagerSubsystem::RequestAsyncLoadItem(FPrimaryAssetId AssetId)
{
    if (!AssetId.IsValid()) return;

    // 이미 로드 중이거나 로드 완료되었는지 확인
    if (LoadingHandles.Contains(AssetId) && LoadingHandles[AssetId]->IsActive())
    {
        return;
    }

    UAssetManager& Manager = UAssetManager::Get();

    // 비동기 로드 시작
    TSharedPtr<FStreamableHandle> Handle = Manager.LoadPrimaryAsset(
        AssetId,
        TArray<FName>(),
        FStreamableDelegate::CreateUObject(this, &UItemManagerSubsystem::OnLoadCompleted, AssetId)
    );

    LoadingHandles.Add(AssetId, Handle);
}

UMyItemDataAsset* UItemManagerSubsystem::GetItemData(FPrimaryAssetId AssetId)
{
    // 에셋 매니저를 통해 메모리에 올라온 객체 포인터를 즉시 반환
    return UAssetManager::Get().GetPrimaryAssetObject<UMyItemDataAsset>(AssetId);
}

void UItemManagerSubsystem::UnloadItem(FPrimaryAssetId AssetId)
{
    if (LoadingHandles.Contains(AssetId))
    {
        // 핸들을 해제하여 에셋 매니저가 참조를 끊게 함 (GC 대상이 됨)
        LoadingHandles.Remove(AssetId);
        UAssetManager::Get().UnloadPrimaryAsset(AssetId);
        UE_LOG(LogTemp, Log, TEXT("Item Unloaded: %s"), *AssetId.ToString());
    }
}

void UItemManagerSubsystem::OnLoadCompleted(FPrimaryAssetId AssetId)
{
    UE_LOG(LogTemp, Log, TEXT("Item Loaded via Subsystem: %s"), *AssetId.ToString());

    // 로드 완료 알림
    if (OnItemLoaded.IsBound())
    {
        OnItemLoaded.Broadcast(AssetId);
    }
}

Primary Data Asset

public:
    // 에셋 매니저에서 식별할 타입 이름 (예: "Weapon")
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Item")
    FPrimaryAssetType ItemType;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Stats")
    float AttackDamage;

    // 무거운 에셋은 SoftObjectPtr로 선언해서 로드 시점을 제어합니다.
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Visual")
    TSoftObjectPtr<USkeletalMesh> ItemMesh;

    // ID를 반환하는 함수 오버라이드 (Asset Manager가 식별할 때 사용)
    virtual FPrimaryAssetId GetPrimaryAssetId() const override
    {
        return FPrimaryAssetId(ItemType, GetFName());
    }

언리얼 내배캠 마스터반 수업 - Subsystem과 수명 관리

이개 — Wed, 10 Jun 2026 12:28:19 +0900

Subsystem이란?

내가 직접 만들고 관리하지 않아도 엔진이 알아서 켜고 꺼주는 시스템
실행 시점과 수명을 직접 결정할 수 있음

Engine

상속받는 원본 클래스
태어나는 시점
사라지는 시점

Editor

상속받는 원본 클래스
태어나는 시점
사라지는 시점

GameInstance

상속받는 원본 클래스
태어나는 시점
사라지는 시점

World(UE5에서 추가)

상속받는 원본 클래스
태어나는 시점
사라지는 시점

LocalPlayer

상속받는 원본 클래스
태어나는 시점
사라지는 시점

서브시스템의 장점

통계, UI 관리 기능 등을 별도 파일로 분리해 관리 가능하여 코드가 깔끔해진다.
NewObject로 생성하고 가비지 컬렉션을 걱정할 필요없다. 엔진이 생명주기를 책임진다.
플러그인을 만들 때 사용자가 따로 설정할 필요없이, 플러그인을 넣기만 하면 서브시스템이 자동으로 활성화되어 기능을 수행한다.

내부 에셋들을 할당받기는 힘들다. 블루프린트로 할당하기에는 불안정하다. 하드코딩으로 넣어놓을 수는 있다.

실습

WorldSubsystem을 상속받은 새 클래스 MyWorldSubsystem을 만든다.

virtual void Initialize(FSubsystemCollectionBase& Collection) override;

virtual void Deinitialize() override;

두 함수를 오버라이드한다.

Deinitialize에서는 파일 저장이나 Unbind 등을 진행해주면 된다.

UE_LOG로 서브시스템의 시작과 끝을 확인한다.

종료되는 함수는 Super를 뒤에 붙인다.

로그를 확인하기 위해 레벨 플루프린트에 Open Level 노드를 배치한다.

새 월드가 열릴 때마다 로그가 출력되는 것을 확인할 수 있다.

서브시스템 자동활성화 제어

UWorldSubsystem에 들어가면 ShouldCreateSubsystem이라는 함수가 있는데, 여기서 활성화 여부를 제어할 수 있다.

true면 생성, false면 미생성

UWorld* World = Cast<UWorld>(Outer);

-> 현재 액터의 상위 액터

ex) 스타터 맵에서만 실행하고 싶은 경우

World를 가져오고, World의 맵 이름에 StaterMap이 들어가는지 확인해서 해당 맵에서만 띄우기

블루프린트에서 서브시스템을 갖고 오고싶다면 바로 호출이 가능하다.

날씨 서브시스템과 시간 서브시스템의 관계

만약 시간에 따라 날씨를 조정하고 싶다고하면, 시간 서브시스템이 먼저 생성되고 날씨 시스템은 시간을 가져와서 조정을 할 수 있어야 한다. 그래서 Collection을 통해 의존성을 주입하여 선행 초기화를 시켜준다.

TimeWorldSubsystem을 만들어준다.

GetCurrentHour 함수를 만들고 시간을 리턴해준다.

MyWorldSubsystem.cpp에서 연동해준다.

UTimeWorldSubsystem* TimeSub = Collection.InitializeDependency<UTimeWorldSubsystem>(); 로 UTimeWorldSubsystem을 먼저 생성해주는 것이다.

실행 화면. 생성 초기에만 한번 실행하기 때문에 0이 뜬다.

언리얼 내배캠 - 언리얼 멀티플레이 기초 채팅 프로젝트 생성

이개 — Tue, 9 Jun 2026 22:31:09 +0900

패키징을 하기 위해서는 200GB 넘게 필요하기 때문에 넉넉한 용량(웬만하면 2TB이상)이 필요하다.

또한, 경로 문제가 발생할 수 있어서 한 드라이브에 다 설치해주는 것이 좋다.

프로젝트 생성

ChatX라는 이름의 프로젝트를 하나 생성한다.

새 레벨을 만든다.

컨텐츠 폴더 안에 프로젝트와 같은 이름의 폴더를 만든다.

Ctrl+Shift+S로 저장해줘야만 전체 상황이 저장된다.

맵 & 모드에서 만든 레벨로 레벨을 수정해준다.

새 게임모드 베이스를 만들어준다.

라이브코딩은 꺼준다.

cpp파일 include에서 에러가 뜨는 경우는 경로 오류이다.

같은 폴더 안에 있는 경우 Game/을 지워주면 된다.

Build.cs 파일에 PublicIncludePaths,AddRange(new string[] { "ChatX" });를 추가해주어야 경로가 제대로 잡힌다.

PlayerController도 생성한다.

이름은 CXPlayerController

PlayerCharacter는 필요없다.

Blueprint 폴더와 그 안에 Game, Player 폴더를 만든다.

보통 C++ 클래스를 상속받기 때문에 C++폴더와 유사한 구조를 가진다고 보면 된다.

블루프린트로 CXGameModeBase를 상속받아 새 게임모드 클래스 BP_GameModeBase를 만든다.

BP_PlayerController도 만들어준다.

WorldSettings 탭에서 게임 모드 오버라이드에 BP_GameModeBase를 할당해준다

선택된 게임모드에서는 만든 블루프린트를 할당해준다.

그러면 게임 실행 시 아웃라이너에 만든 블루프린트가생성된다.

UserWidget C++ 클래스를 만든다.

UI 하위에 소스를 만든다.

Build.cs에 UMG 모듈을 추가한다.

UCXChatInput.h에 멤버를 추가한다.

UPROPERTY(meta = (BindWidget))에서 BindWidget이 메타 키워드로 들어가면, EditableTextBox_ChatInput이라는 이름의 UEditableTextBox를 구현하는 것을 강제한다.

WBP_ChatInput을 만들어준다.

EditableTextBox_ChatInput을 만들지 않으면 에러가 뜬다.

팔레트에서 캔버스 패널을 하나 만들고, 라이브러리에서 EditableTextBox를 캔버스 패널 밑에 드래그앤드롭으로 생성한다.

그리고 이름을 바꿔주면 에러가 사라진다.

텍스트박스의 앵커는 하단으로 설정한다.

오프셋은 위와 같다.

폰트 크기는 24, 컬러는 검정색으로 해준다.

플레이어 컨트롤러의 헤더를 수정한다.

코드는 이렇게 쓴다.

캐릭터 블루프린트에 WBP_ChatInput을 할당한다.

게임을 실행하면 이렇게 텍스트 입력창이 나온다.

Build.cs에 Slate, SlateCore도 추가해준다.

컨트롤러 헤더에 FString타입 ChatMessageString과 Setter를 만들어준다.

ChatInput 클래스에 Native 생성자와 소멸자를 넣고 채팅 입력시 실행될 함수를 만든다. 함수에 UFUNCTION() 붙여줘야한다.

델리게이트 바인딩 및 텍스트 commit시 동작을 구현한다.

EditableTextBox에는 텍스트 커밋 시 이벤트가 발생하는데 이것을 델리게이트로

if (EditableTextBox_ChatInput->OnTextCommitted.IsAlreadyBound(this, &ThisClass::OnChatInputTextCommitted) == false)

{

EditableTextBox_ChatInput->OnTextCommitted.AddDynamic(this, &ThisClass::OnChatInputTextCommitted);

}

이렇게 바인딩해서 사용할 수가 있다.

이 상태로 실행하면 입력 후 엔터를 누를 시 텍스트가 사라지며 String에 저장된다.

바인딩이 잘 되었는지 확인하려면 아래와 같이 진행한다.

#include "Kismet/KismetSystemLibrary.h"

UKismetSystemLibrary::PrintString(this, ChatMessageString, true, true, FLinearColor::Red, 5.0f);으로 SetChatMessageString 실행 시 화면에 출력해본다.

SetString이 되면 화면에 입력한 내용이 출력된다.

언리얼 내배캠 마스터반 - 소프트 레퍼런스

이개 — Mon, 8 Jun 2026 09:56:53 +0900

C++ 액터를 하나 만든다. 이름은 TestActor

소프트 오브젝트 레퍼런스

소프트 클래스 레퍼런스

비동기, 동기, 데이터 에셋

UPROPERTY(EditAnywhere)

ConstructorHelper: ...(하드코딩으로 경로, 위치 넣어줌. 찾으면 반환, 없으면 nullptr)

간접 프로퍼티

주소만 들고 있다가 로드 시점을 정해주는 것

블루프린트에서 변수를 생성하면 오브젝트 레퍼런스, 클래스 레퍼런스, 소프트 오브젝트 레퍼런스, 소프트 클래스 오브젝트 레퍼런스가 있다. 소프트 오브젝트 레퍼런스가 뭘까?

일반 레퍼런스는 하드 레퍼런스다. 항상 같이 로드된다.

소프트 오브젝트 레퍼런스는 필요할 때만 로드된다.

예를 들면 특정 스테이지에서만 나타나는 몬스터, 고해상도 텍스쳐 등이다.

소프트 오브젝트 만들기

동기 로드 함수

이 상태로 빌드

보통 메인 스레드에서 동기로 로드를 하는데, 리소스를 많이 먹는 오브젝트는 서브스레드에서 로드를 하는 것이 비동기.

액터를 화면에 올리고 메시에 아직 아무데서도 사용되지 않은 메시를 할당한다.

처음 실행 시

두 번째 실행 시

엔진 실행 자체가 게임 실행이나 다름없기 때문에 엔진 자체를 끄지 않고 두 번째 실행하면 이미 오브젝트가 로드가 되어있는 것이다.

비동기 호출

새로운 함수 MyOnLoadCompleted 선언

아래 헤더를 인클루드해주어야한다.

#include "Engine/AssetManager.h"
#include "Engine/StreamableManager.h"

LoadWithSoftPtr()의 이미 로드된 부분 밑에 추가해준다. RequestAsyncLoad가 비동기로 가져와서 바인딩 해주는 부분이다. ToSoftObejctPath는 경로를 가져와주는 것이다.