나만의 연습장

언리얼엔진의 FText는 조사를 어떻게 판별할까?

엄준식사생팬 — Sat, 12 Jul 2025 23:42:29 +0900

우리가 FText를 통해 Localization을 진행할 때

한글에서는 적절한 조사를 붙이기 위해 다음과 같이 처리한 것이 있을 것이다.

{0}|hpp(은,는)

여기서 정의는
{0}|hpp(받침이 들어올 때 쓰일 조사, 받침이 들어오지 않을 때 쓰일 조사)

그런데 언리얼엔진은 {0}에 어떤 텍스트가 들어올지 어떻게 알고 은, 는을 따로 나누어서 붙여주는 것일까?

이는 실제로 포매팅이 진행될 FTextFormatData::Format_NoLock 까지 들어가야 한다.

(여기서 Lock이 있는 이유는, 포매팅에 대해 Multithread도 지원할 수 있기 때문이다.)

FString FTextFormatData::Format_NoLock(const FPrivateTextFormatArguments& InFormatArgs)
{
	// Impl
	ArgumentModifierToken->TextFormatArgumentModifier->Evaluate(*PossibleArgumentValue, InFormatArgs, ResultString);
}

여기서 TextFormatArgumentModifier는 해당 텍스트가 한글이라면

FTextFormatArgumentModifier_HangulPostPositions가 들어온다.

void FTextFormatArgumentModifier_HangulPostPositions::Evaluate(const FFormatArgumentValue& InValue, const FPrivateTextFormatArguments& InFormatArgs, FString& OutResult) const

이 부분의 Implementation을 확인하면 된다.

코드를 하나하나 봐보자

if ((LastArgChar >= 0xAC00 && LastArgChar <= 0xD7A3) || (LastArgChar >= TEXT('0') && LastArgChar <= TEXT('9')))

LastArgChar가 [0xAC00, 0xD7A3] 안에 있거나 [0, 9] 에 있는지 확인한다.

여기서 0xAC00 의 유니코드는 '가'

0xD7A3의 유니코드는 '힣' 이다.

즉

마지막 문자가 한글이거나 숫자인지를 확인한다.

bool bIsConsonant = ((LastArgChar - 0xAC00) % 28 != 0) || LastArgChar == TEXT('0') || LastArgChar == TEXT('1') || LastArgChar == TEXT('3') || LastArgChar == TEXT('6') || LastArgChar == TEXT('7') || LastArgChar == TEXT('8');

숫자부터

LastArgChar가 0, 1, 3, 6, 7, 8 이라면 받침이 있는 것이다.

예를들어

'1은' = '일은' 이고

'2는' = "이는" 이므로 0, 1, 3, 6, 7, 8 은 받침이 있는 조사로 처리되어야 할 것이다.

또한

(LastArgChar - 0xAC00) % 28 != 0 이라는 코드가 있다.

이는 유니코드의 받침이 어떻게 처리되는지 알아야 한다.

우리가 예를들어

길 이라는 텍스트를 쓴다고 해보자 이 길이라는 텍스트는

AE38 이다.

한글 음정의 유니코드는 다음과 같이 정해진다.

초성 * 21 * 28 + 중성 * 28 + 종성

여기서 초성 | 중성 | 종성은 우리의 자음 모음 순서이다.

길은 ㄱ + ㅣ + ㄹ 이며

인덱스는 0, 20, 8 이다.

한글은 19개의 자음과 10개의 모음인데

왜 ㅣ 은 인덱스가 20 이고

ㄹ은 인덱스가 8일까?

이건 초성, 중성, 종성이 어떻게 이루어져 있는지를 봐야 하는데, 표를 보면 이해가 쉬울 것이라고 생각한다

초성 인덱스

0	ㄱ	기본 자음
1	ㄲ	된소리(쌍기역)
2	ㄴ
3	ㄷ
4	ㄸ	된소리(쌍디귿)
5	ㄹ
6	ㅁ
7	ㅂ
8	ㅃ	된소리(쌍비읍)
9	ㅅ
10	ㅆ	된소리(쌍시옷)
11	ㅇ
12	ㅈ
13	ㅉ	된소리(쌍지읒)
14	ㅊ
15	ㅋ
16	ㅌ
17	ㅍ
18	ㅎ

중성 인덱스

0	ㅏ	기본 단모음
1	ㅐ
2	ㅑ
3	ㅒ
4	ㅓ
5	ㅔ
6	ㅕ
7	ㅖ
8	ㅗ	단모음 (복합 조합 가능한 모음)
9	ㅘ	ㅗ + ㅏ
10	ㅙ	ㅗ + ㅐ
11	ㅚ	ㅗ + ㅣ
12	ㅛ
13	ㅜ
14	ㅝ	ㅜ + ㅓ
15	ㅞ	ㅜ + ㅔ
16	ㅟ	ㅜ + ㅣ
17	ㅠ
18	ㅡ
19	ㅢ	ㅡ + ㅣ
20	ㅣ

종성 인덱스

0	(없음)	받침 없음
1	ㄱ	기본 자음
2	ㄲ	쌍기역
3	ㄳ	ㄱ + ㅅ (겹받침)
4	ㄴ
5	ㄵ	ㄴ + ㅈ
6	ㄶ	ㄴ + ㅎ
7	ㄷ
8	ㄹ
9	ㄺ	ㄹ + ㄱ
10	ㄻ	ㄹ + ㅁ
11	ㄼ	ㄹ + ㅂ
12	ㄽ	ㄹ + ㅅ
13	ㄾ	ㄹ + ㅌ
14	ㄿ	ㄹ + ㅍ
15	ㅀ	ㄹ + ㅎ
16	ㅁ
17	ㅂ
18	ㅄ	ㅂ + ㅅ
19	ㅅ
20	ㅆ	쌍시옷
21	ㅇ
22	ㅈ
23	ㅊ
24	ㅋ
25	ㅌ
26	ㅍ
27	ㅎ

종성은 없을수도 있고,

초성과 다른 복합자음(겹받침)이 받침으로 들어갈 수 있기 때문이다.

위 표에 맞춰서 '길' 이라는 텍스트를 다시 계산하면

길은 ㄱ + ㅣ + ㄹ 이며

인덱스는 0, 20, 8 이다.

이 인덱스를 위의 식에 계산해본다면 길은 568 이라는 값이 나오고

한글 유니코드의 시작인 0xAC00 에 568를 더하면 0xAE38 이 나온다.

그럼 다시 위의 FText 코드로 돌아가본다면

(LastArgChar - 0xAC00) % 28 != 0

이는 결국

LastArgChar가 종성 28개로 Modular 연산을 했을때 0이 아니라면 받침이 있다는 뜻이다. 라는것으로 확인할 수 있다.

한글의 뒷 글자가 받침이 있다면 이것은 '받침이 있을 때 들어오는 조사' 로 포매팅 되어야 한다는 것이다.

const bool bIsRieul = ((LastArgChar - 0xAC00) % 28 == 8) || LastArgChar == TEXT('1') || LastArgChar == TEXT('7') || LastArgChar == TEXT('8');
if (bIsRieul)
{
	bIsConsonant = false;
}

bIsRieul은 해당 문자가 ㄹ 받침을 쓰는지 확인한다

'ㄹ' 은 인덱스로 8 이므로 LastArgChar - 0xAC00 % 28 (종성갯수) 했을 때 8이 나오면 이는 ㄹ이다.

ㄹ받침인 경우에는 '받침이 없는 조사'가 들어와야 한다는 것이다.

if (bIsConsonant)
{
	OutResult.AppendChars(ConsonantSuffix.StringPtr, ConsonantSuffix.StringLen);
}
else
{
	OutResult.AppendChars(VowelSuffix.StringPtr, VowelSuffix.StringLen);
}

받침이 있다는 것은 곧, 자음이 이곳에 들어왔다는 것이고 그래서 bIsConsonant를 사용한다.

이게 true 라면 '은' 이 붙을 것이고

false라면 '는' 이 붙을 것이다.

[Unreal Engine 5] World Partition

엄준식사생팬 — Sun, 23 Feb 2025 17:09:19 +0900

월드 파티션(World Partition)은 대규모 월드를 관리하기 위한 자동 데이터 관리 및 거리 기반 레벨 스트리밍 시스템이다.

기존에는 셀로 나눠진 Persistant Level에 월드를 저장하고, 커다란 레벨을 서브 레벨로 나눴어야 했는데

월드 파티션은 스트리밍 소스와 셀의 거리에 따라 로드, 언로드 하는 자동 스트리밍 시스템이다.

월드 파티션을 알기 위해선 이전의 레벨 스트리밍에 대한 정보를 알아야 한다.

레벨 스트리밍 (Level Streaming) 은 게임이 실행되는 동안 전체 맵을 한 번에 로드하는 것이 아닌, 필요한 부분만 동적으로

로드 / 언로드 하는 기술이다.

이 기술을 사용하면 큰 월드에서도 성능을 최적화 하고, 메모리 사용량을 줄일 수 있다.

예를 들어, 오픈 월드 게임에서는 플레이어가 볼 수 있는 위치 빼고는 맵을 로드해둘 필요가 없으니 볼 수 있는 위치만 로드한다.

기존의 언리얼 엔진4에서는 서브 레벨 기반 스트리밍을 사용했다.

Persistent Level (기본 레벨) 이 존재하고, 여러 개의 서브 레벨이 존재하여 이를 동적으로 로드/언로드 하는 방식이다.

우리가 필요한 월드 영역을 하나의 레벨로 만들어 분리하고 필요할 때만 로드 / 언로드 하는 것이다.

월드 파티션의 핵심 개념은 다음과 같다.

1. 자동 그리드 기반 레벨 스트리밍

월드를 자동으로 그리드 (Cell) 단위로 나누어서 관리한다.

플레이어의 위치나 설정된 로직에 따라서 필요한 영역만 동적으로 로드 / 언로드 된다.

2. HLOD

멀리 있는 월드 부분을 최적화하여 표시한다. ( 이것도 서브 레벨 스트리밍에서 사용할 수 있으나, 설정이 좀 더 필요하다. )

3. Data Layer

월드에서 특정 오브젝트들을 Layer로 묵을 수 있다.

게임 플레이 상황에 맞춰 특정 오브젝트들을 다르게 로드 / 언로드 할 수 있다.

4. 스트리밍 소스 (Streaming Source)

플레이어의 위치뿐만 아니라, 카메라 또는 특정 객체를 기준으로 월드 스트리밍을 제어할 수 있다.

기본적으로는 플레이어의 위치를 기준으로 잡히고 있는데, 추가하고 싶다면 UWorldPartitionSubsystem 에 등록해야 한다.

월드 파티션을 사용하려면 특정 세팅을 먼저 해주어야 한다.

Project를 생성할 때, 프로젝트 템플릿들에는 지금 월드 파티션 템플릿이 기본적으로 포함되어 있다.

설정을 키려면 World Settings 로 가서 Enable Streaming을 켜주어야 한다.

이 기능은 월드 파티션 템플릿이 들어가있는 경우에만 나타난다.

즉, 프로젝트 템플릿인 Blank, First Person, Third Person, Top Down, Vehicle Advanced 에서만 나타난다.

우리의 기존 프로젝트가 월드 파티션 템플릿을 포함하게 하기 위해선 다음과 같이 하면 된다.

1. Tools -> Convert Level 을 사용하여 월드 파티션 변환을 사용하기

2. Commandlet 을 사용하여 월드 파티션 변환 하기

UnrealEditor.exe QAGame -run=WorldPartitionConvertCommandlet Playground.umap -AllowCommandletRendering

그리드 세팅

World Settings의 World Partition Setup을 선택하여 월드 파티션의 런타임 세팅을 할 수 있습니다.

여기선 그리드에 대한 다양한 데이터 설정과 HLOD Data layer 등을 설정할 수 있는데.

Cell Size인 25600 이 궁금할 수도 있습니다.

언리얼에서는 단위가 cm 이므로 25600cm 이고, 이는 한 셀의 크기가 256미터 임을 알 수 있습니다.

위의 Preview Grids 를 클릭하면, 에디터 뷰포트 내에서 그리드가 어떻게 나누어져있는지를 볼 수 있습니다.

다른 옵션들의 정보는 다음과 같습니다.

로딩 범위가 이해가 안될 수도 있는데, 우리의 스트리밍 액터가 그리드로부터 768미터 떨어지기 시작하면, 정보가 사라지고, 로딩되기 시작합니다.

우리의 PlayerController에도 World Partition에 대한 정보가 있습니다.

이는 WorldPartitionStreamingSourceComponent를 포함하고 있는것인데, 현재의 모든 템플릿에는 기본적으로 포함되어 있습니다

여기서의 Runtime Grid 이름은 우리가 World Settings - World Partition에서 설정한 Grid 이름입니다.

위의 예시로 들자면 MainGrid가 되겠군요.

우리가 월드 파티션을 사용할 때는 World Partition Editor 를 사용합니다.

Window - World Partition Editor 를 클릭합니다.

이 곳에서 다음과 같은 처리를 할 수 있습니다.

특정 그리드들을 드래그 한 후, 우클릭하면 Selection이 나타나게 됩니다.

특정 그리드들을 로드 하거나, 언로드 하거나

카메라등을 이동시킬 수 있습니다.

Level Instance 나 Virtrual Texture .. 같은 내용은 여기서 다루지 않습니다.

ref : https://youtu.be/LnoCwJBdUPM?si=-cqk6FbuSRRa2s-H

Unreal Engine의 FText 내부까지 알아보기

엄준식사생팬 — Sun, 21 Jul 2024 19:06:29 +0900

우리가 Unreal Engine으로 게임을 제작하다보면 UI를 만들거나, 혹은 현지화 작업을 할 때 FText를 만지게 되어있다.

현재 내가 속해 있는 게임 개발팀에서도 FText를 이용하여 L10N 작업중이다.

Unreal Engine이 FText에 정의한 내용은 다음과 같다.

https://dev.epicgames.com/documentation/ko-kr/unreal-engine/ftext-in-unreal-engine

글만봐서는 '텍스트 현지화'를 제공한다고 하는데, 어떻게 사용하고 어떻게 동작하는지에 대해 모호하게 적혀있다.

이 문서는 내가 직접 FText에 대해 분석하고, 어떻게 사용하는지에 대해 공유하는 문서이다.

1. FText 타입 변수의 사용방법

사용 방법은 정말 간단하다.

우리가 어떠한 문자열을 정의하고, 그것을 언리얼 엔진에게 알려주고 우리는 사용만 하면된다.

// NSLOCTEXT(NamespaceName, KeyName, DefaultValue);
FText testText = NSLOCTEXT("A", "B", "C");

가장 기초적인 정의방법은 다음과 같다.

이것을 가장 간단하게 바라보면 다음과 같이 풀어 쓸 수 있다.

"A 라는 Namespace에서 B라는 Key를 가진 FText 값을 주세요. 만약 없다면 DefaultValue로 C를 사용하겠습니다."

모든 FText에 대해서 이렇게 작성하기가 귀찮을 수 있다.

그럴땐 Namespace를 미리 지정하고, Key Value만 지정해도 사용할 수 있다.

#define LOCTEXT_NAMESPACE "A"
FText testText1 = LOCTEXT("B", "C");
FText testText2 = LOCTEXT("D", "E");
#undef

이렇게 사용한다면 NSLOCTEXT를 사용하지 않고 Key와 Value만을 사용하여 FText를 정의할 수 있다.

(Stringtable에 대한것은 밑에서 계속 작성하겠다)

2. Localization 하기

우리는 위에서 A Namespace에 있는 B Key 값을 정의했다.

이제 이걸 Localization 해보자

언리얼 엔진을 켜고 Tools > Localization Dashboard를 클릭한다.

이제 이곳에서 GatherText를 해주어야 한다.

Gather from Text Files를 체크하고

Search Directories 에 다음과같이 최상위 폴더만 지정해주자

그리고 Gather Text를 누르고, Compile Text를 해준다.

그럼 내 프로젝트 Content > Localization > Game에 다음과 같은 파일들이 생성되게 된다.

우리가 정의한 FText를 보려면 en -> Game.po 파일을 메모장으로 열어보자

다음과 같이 정의되어 있을 것이다

msgctext에서 "A,B" 는 A namespace B key 라는 뜻이고

이때 value는 C가 된다는 뜻이다.

en 상태일때는 C였으니 ko 일때는 다르게 출력하고 싶다.

ko 일때의 Culture를 만들어주자

다시 Localization dashboard를 켜서 밑에 Add New Culture를 누르고 Korean을 추가해준다.

Gather Text를 해주자, 그 후 Export Text를 한 후, ko 에 있는 .po 파일을 열어보자

그리고 msgstr에 우리가 쓸 문자열을 추가해준 뒤 Word Count를 해주면 다음과 같이 정상적으로 나타나게 된다.

이제 우리가 게임의 Language를 EN -> KR 로 변환하게 되면 A.B 에 있는 FText의 Value는 "씨" 로 나타나게 된다.

3. 불편한데요?

누군가는 이렇게 말할 것이다.

"결국 FText를 사용하려면 코드 어딘가에 NSLOCTEXT나 LOCTEXT로 (Key, Value) 쌍을 제공하고 컴파일 한 다음 에디터를 한번 켜야하네요? 불편한데.."

이를 위해 언리얼 엔진은 StringTable이라는 것을 제공한다.

Content browser > Miscellaneous > String Table을 눌러 새로운 String Table을 만들어주자

새로운 Key / Value 값을 만들어주자

이 때 Namespace는 우리가 만든 StringTable의 이름임을 기억하자.

(본인은 ST_TestString이라는 스트링 테이블 파일을 만들었으므로, ST_TestString이 Namespace가 된다. 이는 위에서 따로 지정해줄 수도 있다.)

이제 Localization Dashboard를 키고 Gather from Packcages 에서 내가 만든 스트링 테이블의 위치 WildCards를 추가해주고 Gather Text를 실행해주자.

진행하면 Word Count가 증가한 것을 볼 수 있다.

이를 통해 알 수 있는 점은, 우리가 새로운 (Key, Value)를 지정하면 그것은 엔진의 Default Language와 같다는 것을 알 수있다.

아무튼, 또 Korean의 .po를 수정해주고, Translation Edit로 해당 값을 열면

다음과 같이 나타난다.

이제 Count words를 해주고 Compile text를 해주자.

이제 코드에서 다음과 같이 작성하여 사용할 수 있다.

이를 공용적으로 사용하기 위해서는 TextManager 같은것을 하나 만들어놓고 그고세엇 StringTable 들을 다 긁어온 다음

그것을 사용하는것이 매우 공용적이고 합당하게 사용할 수 있을 것이다.

4. FText의 구현

우리가 FText를 어떻게 사용하는지 알 수 있게 되었다.

그럼 실제로 언리얼 엔진에서 FText는 어떻게 구현되어 있을까?

이를 위해 엔진 코드에서 TextLocalizationManager.h 를 열어보자

여기서 TMap에 대한 코드를 찾으면 다음과 같이 typedef가 되어 있다.

/** Manages the currently loaded or registered text localizations. */
typedef TMap<FTextId, FDisplayStringEntry> FDisplayStringLookupTable;
    
FDisplayStringLookupTable DisplayStringLookupTable;

DisplayStringLookupTable에 우리가 사용하는 Key, Value를 저장하여 사용한다는 것을 알 수 있다.

근데 이 생각을 할 수 있다.

"아니 우리는 Key Value 뿐만 아니라 Namespace도 지정했는데?"

이는 TMap<FTextId, FDisplayStringEntry> 에서 FTextId를 보면 알 수 있다.

FTextId의 생성과 변수는 다음과 같다.

FTextId(const FTextKey& InNamespace, const FTextKey& InKey)
	: Namespace(InNamespace)
	, Key(InKey)
{
}

/** Namespace component of this text identity */
FTextKey Namespace;

/** Key component of this text identity */
FTextKey Key;

이를 통해 FTextId는 Namespace와 Key로 이루어졌다는 것을 알 수 있다.

TextLocalizationManager는 Singleton으로 작성되어 있다.

FTextLocalizationManager::GetDisplayString(const FTextKey& Namespace, const FTextKey& Key, const FString* const SourceString)

이제 우리가 실제로 FText를 정의하고 사용할 때, GetDisplayString함수로 넘어오게 된다.

	FDisplayStringEntry* LiveEntry = DisplayStringLookupTable.Find(TextId);

이 때 DisplayStringLooupTable에 데이터가 있으면 바로 Find로 찾아서 꺼내올 수 있게 된다.

FName 도 동일한 방법으로 정의 되는데

우리가 배울 때 FString에 비해 FName과 FText가 가볍다고 한 이유가 바로 이렇게 Key값으로 저장해두고 바로 찾을 수 있기 때문이다.

이제 실제로 FText를 정의하게 되면 어떻게 찾는지 플로우를 대략적으로 코드로만 설명하겠다.

FText testText = NSLOCTEXT("A", "B", "C");

APlayerController* controller = Cast<APlayerController>(GetController());
controller->GetHUD()->DrawText(testText.ToString(), FColor::White, 500, 400);

우리가 testText를 실제로 사용하게 될 때,

FText 객체가 들고있는 TextData->TextHistory를 통해서 Text를 새로 업데이트 한다.

void FTextHistory_Base::UpdateDisplayString()
{
	check(!TextId.IsEmpty()); // CanUpdateDisplayString should prevent UpdateDisplayString being called
	LocalizedString = FTextLocalizationManager::Get().GetDisplayString(TextId.GetNamespace(), TextId.GetKey(), &SourceString);
}

이 FTextHistory는 내부에서 FTextLocalizationManager의 GetDisplayString 함수를 호출한다.

FText에 대한 사용법과 구현에 대해서 간략하게 설명했습니다.

만약 잘못된 내용이 있거나, 이해가 안되는 부분이 있다면 이에 대해 댓글을 남겨주시면 업데이트 하겠습니다.

감사합니다.

[Unreal Engine 5] Gameplay Ability System - 2

엄준식사생팬 — Sun, 17 Mar 2024 21:57:11 +0900

GameAbilitySystem의 가장 중요한 부분중 하나는 AbilitySystemComponent 다.

이 Component는 Actor에 추가할 수 있으며 AbilitySystem, Granding Abilities, Activating Abilities, Handling Notifications,

GameplayEffect applied 등 많은 것을 처리한다.

즉, 해당 캐릭터(Actor)가 GameplayAbilitySystem에 추가되길 원한다면, AbilitySystemComponent는 꼭 추가해야 한다.

또한 전 시간에 설명했듯이, 우리는 힘, 지능, 민첩과 같은 능력치를 Attribute라고 하기로 했다.

이 Attribute를 모아놓은 것을 AttributeSet이라고 한다.

이제 우리는 AbilitySystemComponent를 추가하여 Gameplay Ability System에 대해 알아볼 것이다.

그런데 그전에 알아둬야 할 것이 있다.

AbilitySystemComponent는 꼭 Character가 가지고있지 않아도 된다.

우리가 어떠한 Actor에 AbilitySystemComponent와 AttributeSet을 추가했다고 해보자.

그리고 이 Actor가 어떠한 영향에 의해 ( HP가 0이 되었다거나, 특정 로직으로 강제로 삭제해야 한다거나.. ) 파괴된다면

AbilitySystemComponent와 AttributeSet도 당연히 파괴되어야 한다.

그리고 다시 Actor를 만들어 낸다면, AbilitySystemComponent와 AttributeSet이 재 생성된다.

결국 '다시시작' (부활) 이 가능한 게임에서는 재사용이 가능할 수 있는 객체를 파괴하고 있다는 것이다.

그럼 Actor대신 어떠한 객체에 AbilitySystemComponent를 넣고, 해당 객체가 관리할 수 있다고 해보자.

이 경우에는 Actor가 파괴되더라도, AbilitySystemComponent와 AttributeSet을 재사용할 수 있다.

우리의 Actor의 힘이 10이였다고 해보자, 그 상태로 다시 시작을 한다고 하여서 힘이 10에서 변할 필요가 있을까?

그것 또한 아니다.

파괴되더라도 Actor를 새로 생성하고, 우리가 관리하던 객체에 연결해주기만 하면 된다.

이 문서를 작성하면서, 우리의 캐릭터는 PlayerState에서 AbilitySystemComponent를 가지게 할 것이다.

AI는 동일하게 캐릭터가 AbilitySystemComponent를 가지게 된다.

일단 PlayerState를 만들어 AbilitySystemComponent를 선언해준다.

그리고 PlayerState의 생성자에서 AbilitySystemComponent를 만들어준다.

여기서 궁금할건 SetIsReplicated와 SetReplicationMode이다.

이는 Replicate (복제) 에 대해서 조금 알아야 한다.

우리가 멀티플레이어 게임에서, 어떠한 변수를 선언하고 해당 변수를 Replicated 변수로 선언했다고 하자.

그리고 해당 변수의 값이 서버에서 변경되었을 때

서버는 모든 클라이언트들에게 변경된 해당 변수 값을 알려주고, 그 값으로 업데이트 합니다.

이 행위를 복제(Replicate)라고 합니다.

이러면, 멀티플레이어 개발을 해보신 분들은 어떠한 의구심을 품을 수 있습니다.

? : 그렇다면 Replicate 선언된 변수가 클라이언트 중 하나에서 변경된다면, 그 값은 서버에 알려주나요? (혹은 변경 되어야 한다라고 알려주나요?) : (즉, Replicate가 양방향으로 작동하나요?)

복제는 단방향으로만 작동한다. 변수가 Replicate로 표시되면 서버는 해당 변경 사항을 알지 못하기 때문에 클라이언트에서는 해당 값을 변경해서는 안된다.

대신 RPC (Remote Procedure call)로 처리합니다. 물론 이에 대해선 나중에 작성하겠습니다.

그럼 SetIsReplicated에 대해 알 수 있습니다.

SetIsReplicated 함수는 해당 컴포넌트를 복제시킬것이냐 라는 것입니다.

ReplicationMode는 다음과 같이 요약할 수 있다.

ReplicationMode::Full은 GameplayEffect가 모든 클라이언트에 복제됩니다.

ReplicationMode::Mixed는 GameplayEffect가 소유하고 있는 클라이언트에서만 복제됩니다.

그리고 Gameplay Cues와 Gameplay Tags는 모든 클라이언트에 복제됩니다.

ReplicationMode::Minimal은 GameplayEffect가 복제되지 않습니다. 그리고 Gameplay Cues와 Gameplay Tags는 모든 클라이언트에 복제됩니다.

위에서 설명했듯 우리가 아직 알지못하는 GameplayEffect, Gameplay Cues, Gameplay Tags가 나왔습니다.

이는 추후에 알아보도록 하며

Mixed는 플레이어에, Minimal은 AI에 적합하므로 해당 문서에서는 이와 같이 작성할 것입니다.

이제 위에서, 우리는 Actor에 AbilitySystemComponent가 붙어있어야 GameplayAbilitySystem에 참여할 수 있다고 했습니다.

AbilitySystem은 Owner Actor와 Avatar Actor를 설정할 수 있습니다.

Owner Actor는 해당 Component를 가지고 있는 Actor 입니다.

Avatar Actor는 해당 Component를 적용받고 화면에 보여질 Actor 입니다.

AI (적군)은 Owner Actor와 Avatar Actor가 해당 Actor가 될 것입니다.

우리의 캐릭터는 PlayerState가 AbilitySystemComponent를 가지기로 했습니다.

그러므로 Owner Actor는 PlayerState이며 Avatar Actor는 Actor 입니다.

이제 OwnerActor와 AvatarActor를 설정해주어야 합니다.

해당 설정은 InitAbilityActorInfo 함수로 설정합니다.

이제 문제는, 해당 함수를 언제 어디서 호출해야 하는가 입니다.

알아야 할 점은 다음과 같습니다.

InitAbilityActorInfo는 Possession이 끝난 후에 수행되어야 합니다.

(즉, Controller가 Pawn에 Set된 후에 수행되어야 합니다.)

몇 가지 타이밍이 있습니다.

1. Actor가 AbilitySystemComponent를 가지고 있는 경우

Server는 PossessedBy가 호출되면 InitAbilityActorInfo를 호출하면 됩니다.

Client는 AcknowledgePossession이 호출되면 InitAbilityActorInfo를 호출하면 됩니다.

2. PlayerState가 AbilitySystemComponent를 가지고 있는 경우

Server는 PossessedBy가 호출되면 InitAbilityActorInfo를 호출하면 됩니다.

Client는 AcknowledgePossession을 사용할 수 없습니다. 왜냐면 우리의 AbilitySystemComponent는 PlayerState에 있기 때문입니다.

대신 OnRep_PlayerState를 사용합니다. 해당 함수는 PlayerState가 복제되었을때 오는 콜백 함수입니다.

3. AI 캐릭터

AI 캐릭터는 간단합니다.

AbilitySystemComponent를 Actor가 가지고 있고 Controller가 Pawn에 Set되어야 한다는 제약도 없습니다.

BeginPlay에서 해주면 됩니다.

이제 InitAbilityActorInfo를 해봅시다.

Enemy는 BeginPlay에서 하면 됩니다.

Owner와 Avatar는 Actor 자기 자신이므로 this로 등록합니다.

PlayerState 상태에서는, 두 곳 (PossessedBy, OnRep_PlayerState) 에서 처리한다고 했습니다.

다음과 같이 작성합니다.

이 것으로 AbilitySystemComponent가 등록이 완료되었습니다.

[Unreal Engine 5] Gameplay Ability System - 1

엄준식사생팬 — Fri, 15 Mar 2024 22:28:28 +0900

Gameplay Ability System의 정보글이 적어 작성하는 포스트

다룰 내용이 많아 장편이 될 것으로 예상

최대한 간단하고, 알아듣기 쉽게 작성하도록 노력하겠다.

1. 개요

Gameplay Ability System의 내용은 언리얼 엔진 문서에도 잘 나와있다.

게임플레이 어빌리티 시스템(Gameplay Ability System) 은 RPG나 MOBA 타이틀에서 볼 수 있는 어빌리티 및 어트리뷰트 유형을 구축하기 위한 고도로 유연한 프레임워크입니다. 게임 내 캐릭터가 사용할 액션이나 패시브 어빌리티, 이러한 액션의 결과로 다양한 어트리뷰트를 높이거나 낮추는 상태 이펙트를 만들 수 있고, '재사용 대기 시간' 타이머나 자원 비용을 구현하여 액션의 사용 빈도를 조절하거나, 어빌리티의 레벨과 레벨에 따른 이펙트를 변경하거나, 파티클 및 사운드 이펙트를 활성화하는 등의 작업이 가능합니다. 게임플레이 어빌리티 시스템을 사용하면 점프처럼 단순한 것부터 최신 RPG나 MOBA 타이틀 내 인기 캐릭터의 기술 모음처럼 복잡한 것까지 다양한 인게임 어빌리티를 설계 및 구현하고 효과적으로 연결할 수 있습니다.

중요하게 보아야 할 것은 '어빌리티 및 유형을 구축하기 위한 고도로 유연한 프레임워크' 라는 것이다.

Gameplay Ability System은 게임 내 능력을 설계, 구현 하기 쉽게 도와주고 네트워크 게임에서 효율적으로 작동할 수 있게 도와준다.

듣기만 하면 꽤 좋아 보이긴 하는데, 약간 모호하기도 하다.

실제로 무엇인지에 대해 조금 이야기 해보도록 하겠다.

우리가 RPG 게임을 하나 만든다고 생각해보자

RPG 또는 롤플레잉 게임은 일반적으로 다양한 요소를 포함하는 '상당히' 큰 게임이다.

RPG 게임에서는 힘, 지능, 민첩, 체력, 마나와 같은 능력치가 있을 수 있다.

이 들은 게임 플레이에 중요한 방식으로 영향을 미치는 것들이다.

이를 일반적으로 'Attribute' 라고 한다.

우리가 어떠한 Attribute에 변화를 가하면, 다른 Attribute들이 영향을 받을 수 있다.

또한 Attribute는 다른 여려 요인의 영향을 받을 수 있다.

예를 들어

힘(Str)을 찍으면 캐릭터의 물리 공격력(Damage)이 올라간다.
A의 물리 공격력(Damage)으로 B를 공격하면, Armor, CriticalChance 같은 Attribute들에 영향을 받아 최종 데미지가 계산된다.

우리가 Damage라는 Attribute로 어떠한 캐릭터를 공격했을때, 이 공격 이라는 행위는 Ability로 인해 발생한다.

RPG에서 어떠한 캐릭터를 공격하여, 그 캐릭터가 죽었다면 우리는 EXP (경험치) 라는 것을 얻는다.

그리고 어떠한 기준을 넘어서면, 캐릭터는 레벨 업 이라는 것을 하게 된다.

또한 우리의 캐릭터는 Buff/DeBuff 같은 것들을 받을 수 있다.

포션을 마시면 체력/마나가 증가하거나, 불 지형에 닿으면 '발화' 같은 디버프에 걸려 체력이 점차 감소한다.

따라서 이러한 효과들은 캐릭터의 Attribute 값을 변경하는데

이러한 Attribute 값을 변경하는 것을 'Effects' 라고 한다.

이제 우리가 어떠한 몬스터를 칼로 공격했다고 해보자.

그 몬스터는 칼을 맞고 '으악' 소리를 낼 것이며, '피가 튀는' 파티클이 발생할 것이다.

즉, 우리가 몬스터에 공격을 가하는 작업을 하였다.

이는 우리가 몬스터의 Attribute에 Effect를 적용시킨것이다.

그럼 해당 Effect가 게임 내에서 적절하게 작동하는지 '시각적', '청각적' 으로 확인할 수 있어야 하는데

이를 GameplayCues가 담당한다.

이 내용들은 RPG에만 쓰이는 것 뿐만아니라, 잘 생각해보면 여러 장르의 게임에서 많이 사용되고 있다.

대부분의 게임들은 HP/MP같은 Attribute들을 사용하고, 다른 캐릭터에게 Effect를 적용시킨다.

요점은, 게임이 다양한 처리를 맡게 됨으로써 많은 효과들로 인해 복잡해질 수 있다는 것이다.

게임이 복잡해질수록, 오브젝트간의 관계는 더 많아진다는 것이고

이런 관계가 많아질수록 관리하기가 어려워질 수 있다는 것이다.

Gameplay Ability System은 프레임워크를 제공하여 매우 복잡한 게임을 개발하기 쉽게 만들어준다.

Gameplay Ability System은 네트워크와 관련된 정보들이 많이 물려있는데, 이에 대한 내용들도 간단하게 나마 작성할 예정이다.

네트워크를 몰라도 알 수 있도록 작성할 예정이며 개요는 이렇게 마치겠다.

물론 위에 설명한 내용 말고도 GameplayAbility, Ability Task, Gameplay Tag등이 있다. 이 내용은 앞으로 추가되는 문서에서 다룰 예정이다.

[Unreal Editor] 4. Custom Tab

엄준식사생팬 — Tue, 16 Jan 2024 15:53:02 +0900

이번에 우리는 언리얼 엔진 에디터를 커스터마이징해 새로운 탭을 만들고, 탭을 누르면 어떠한 창이 나타나게 하여 우리가 추가해놓은 Slate 탭이 나타나게 할 것입니다.

이를 위해선 Slate에 대해 알아야합니다.

Slate는 이 곳에 설명해 두었습니다. (추후 추가 예정 )

우리는 언리얼 엔진 에디터를 커스터마이징 해야 하기 때문에, 엔진이 시작과 동시에 기능이 붙어야 한다는 것을 알아둬야 합니다.

엔진이 시작됨과 동시에, 즉 StartupModule이 호출될 때 에디터에 추가 작업을 요청합니다.

이는 FGlobalTabmanager를 통해서 요청합니다.

FOnSpawnTab 객체를 확인해보면, Delegate임을 알 수 있습니다. 이에 맞춰서 함수를 하나 만들어 바인딩 해주어야 합니다.

이제 탭 생성이 끝났으니, 탭이 눌러졌을 때 어떠한 창이 떠야 하는지를 알려주어야 합니다.

다음과 같이 작성합니다.

여기서 알아두어야 할 것은 SNew 매크로와 ETabRole입니다.

SNew는 괄호안에 들어가는 새로운 Slate 객체를 만들겠다는 뜻입니다.

Slate 객체는 SNew 또는 SAssignNew를 통해서만 만들어져야 합니다.

ETabRole은 다음과 같습니다.

MajorTab : 탭의 최상위 레벨이며 모드 패널이나 월드 아웃라이너 같은 에디터UI의 최상위 섹션입니다. MatorTab에는 여러 개의 PanelTab이 포함될 수 있습니다.
PanelTab : 디테일 패널이나 콘텐츠 브라우저 같은 콘텐츠 패널이 포함된 탭입니다. PanelTab은 MajorTab, PanelTab, NomadTab이 포함될 수 있습니다.
NomadTab : MajorTab / PanelTab 에 맞지 않는 콘텐츠를 보관하는데 사용하는 독립적인 탭입니다. 에셋이나 다른 유형의 콘텐츠에 대한 에디터를 보유하는데 사용할 수 있습니다.
DocumentTab : Material이나 Blueprint같은 특정 에셋이나 리소스에 대한 문서를 표시하는데 사용되는 PanelTab 유형입니다. 일반적으로 에셋 / 리소스 당 단일 인스턴스를 가지며 에디터 UI에서 붙이거나 (도킹하거나) 뗄 수 있습니다.

이제 다 끝났고, 실제로 버튼이 눌렸을 때 탭이 나타나게 하면 됩니다.

이를 통해 우리가 만든 새로운 NomadTab이 생성되게 됩니다.

[Unreal Editor] 3. EditorAssetLibrary, EditorUtilityLibrary

엄준식사생팬 — Tue, 9 Jan 2024 12:35:26 +0900

우리가 에디터의 어떠한 에셋에 대해서 '특정 작업'을 하려면 EditorAssetLibrary와 EditorUtilityLibrary의 도움을 받을 수 있다.

예를 들어, 우리가 클릭한 어떠한 에셋을 가져오려면

UEditorUtilityLibrary::GetSelectedAssets();

를 사용하면 된다.

이를 통해, 사용이 되지 않는 에셋에 대해서 삭제도 진행할 수 있다.

void UQuickAssetAction::RemoveUnusedAssets()
{
	TArray<FAssetData> SelectedAssetsData = UEditorUtilityLibrary::GetSelectedAssetData();
 	TArray<FAssetData> UnusedAssetsData;

	//FixUpRedirectors();

	for (const FAssetData& SelectedAsset : SelectedAssetsData)
	{
		TArray<FString> AssetReferencers = UEditorAssetLibrary::FindPackageReferencersForAsset(SelectedAsset.ObjectPath.ToString());

		if (AssetReferencers.Num() == 0)
		{
			UnusedAssetsData.Add(SelectedAsset);
		}
	}

	if (UnusedAssetsData.Num() == 0)
	{
		ShowMessageDialog(EAppMsgType::Ok, TEXT("No unused asset found among selected assets"), false);
		return;
	}

	const int32 NumOfAssetsDeleted = ObjectTools::DeleteAssets(UnusedAssetsData);

	if (NumOfAssetsDeleted == 0) return;

	ShowNotifyInfo(TEXT("Succesfully deleted ") + FString::FromInt(NumOfAssetsDeleted) + TEXT(" unused Assets"));
}

이를 사용하면 Level에 배치되지 않았거나 reference가 없는 '클릭된' 모든 오브젝트를 삭제한다.

그냥 삭제하기에는 알림 기능이 없으므로, Editor의 힘을 빌려 ObjectTool에서 특정 알림을 낼 수 있다.

실제로 이를 통해서 사용되지 않는 에셋 삭제를 진행하면, 다음과 같이 팝업창이 발생한다.

[Unreal Editor] 2. Asset Action Utility

엄준식사생팬 — Tue, 26 Dec 2023 09:06:51 +0900

우리가 언리얼 에디터에서 특정 에셋이나 액터들에 어떠한 '로직'을 행할 때 유용한 ScriptedAction이 있습니다.

이를 위해 언리얼 엔진에서는 다양한 Built-in Class를 제공 하고 있습니다.

AssetActionUtility : 에셋들에 대한 액션
ActorActionUtility : 액터들에 대한 액션

이번엔 테스트를 위해 TestFunc가 호출되게 만들 것입니다.

언리얼 에디터에서 Add C++ Class를 하여 AssetActionUtility를 만들어줍니다.

우리는 우리가 만든 플러그인에 만들어야 하므로

PluginName(Editor) 로 변경하여 줍니다.

Class Type은 .h와 .cpp를 분리할 것 이므로 Public으로 합니다.

이로써 첫 AssetActionUtility가 만들어 졌습니다.

하지만 만들고 나면, AssetActionUtility.h 에서 컴파일 에러가 발생할 것입니다.

우리가 AssetActionUtility를 사용할 것이라고 Build.cs에게 알려야 합니다.

IDE에서 AssetActionUtility를 검색해 보면 다음과 같습니다.

Blutility는 모듈 이름이며, 우리가 만든 모듈이 이 Blutility를 사용한다고 알려주어야 합니다.

우리가 만든 플러그인의 Build.cs를 확인합니다.

다음과 같이 dependency에 "Blutility"를 추가해줍니다.

또한 Blutility에는 Private한 폴더와 모듈이 있습니다. 이 또한 포함해주어야 합니다.

이는 경로 설정을 통해 포함할 수 있는데, cs를 사용해 '상대경로'로 지정합니다.

이제 UE5를 종료하고, IDE에서 컴파일 해보면 정상적으로 컴파일이 되는 것을 확인할 수 있습니다.

이제 우리가 만든 버튼이 눌려지면, Test 라는 문자열을 화면에 출력하도록 만들겠습니다.

우리가 만든 AssetAction.h 로 돌아가 다음과 같이 테스트 함수를 작성합니다.

이제 우리가 임의의 Actor를 만들고, 우클릭하여 'Scripted Asset Actions' 에서 TestFunc를 클릭하면

화면에 "Test"라는 문자가 나타나게 됩니다.

추가로 만약, 여기까지 정상적으로 진행했는데 Scripted AssetActions 나오지 않는다면,

Editor Utility Blueprint에서 우리가 만든 AssetAction을 부모로 한 새로운 블루프린트를 만들어주면 나타납니다.

[Unreal Editor] 1. Plugins

엄준식사생팬 — Thu, 14 Dec 2023 06:59:49 +0900

모듈은 언리얼 엔진과 우리가 사용하는 모든 것을 구성하는 블록이라고 생각할 수 있습니다.

언리얼 엔진 내부는 기본적으로 모듈로 되어있습니다.

그리고 Editor를 확장하려면 자체 모듈과 Resource Dropdown을 만들어야 합니다.

Custom Editor 문서에서는 간단하게 주요 사항만 작성합니다.

모듈은 코드 분리에 아주 적합합니다.
모듈은 자체적으로 '빌드 평가 파일' 이 필요합니다. 이는 [ModuleName].Build.cs 로 시작합니다.우리가 어떠한 프로젝트를 만들때도 이것이 만들어지는것을 볼 수 있습니다.
즉, 프로젝트도 하나의 모듈입니다.
모든 모듈은 빌드 액세스 파일에 추가하여, 프로젝트에 포함할 수 있습니다.

이제 첫 번째 빈 플러그인을 만들어 에디터에 관련된 모듈을 생성하겠습니다.

언리얼 에디터에서 Edit > Plugins를 클릭합니다.

이 곳에서 많은 플러그인들을 볼 수 있습니다.

Add를 클릭합니다.

Blank를 클릭하고, 플러그인 이름을 작성합니다.

플러그인 이름은 추 후에 변경할 수 없으므로, 유니크하게 작성합니다.

플러그인 생성이 완료되면, 프로젝트 내의 Plugins 폴더에서 내가 만든 플러그인을 볼 수 있습니다.

여기서 [ModuleName].uplugin을 더블클릭합니다.

우리가 만들 플러그인에 대한 정보가 작성되어 있습니다.

이 중, 유심히 봐야 할 것은 'Type'과 'LoadingPhase' 입니다.

Type은 해당 플러그인이 '게임 코드'에 영향을 주는 지, 에디터에 영향을 주는지에 대해 작성합니다.

이 곳에서 LoadingPhase에 대한 설명을 볼 수 있습니다.

https://openmynotepad.tistory.com/114

Unreal Engine Game Framework : main 함수부터 BeginPlay까지

UnrealEngine의 초보자들이 GameFramework(GameMode, GameState, PlayerController, Pawn, PlayerState와 같은 클래스)를 제대로 이해하고 다루고 싶어 할 것이다. 익숙해지기 가장 좋은 방법 중 하나는 언리얼 엔진의 소

openmynotepad.tistory.com

우리의 플러그인은 '에디터' 에만 영향을 줄 것이고, 게임 모듈이 로드 되기 전에 로드되어야 하므로

Type을 'Editor' 로

LoadingPhase를 'PreDefault'로 작성합니다.

이제 첫 Blank 플러그인 만들기가 완료 되었습니다.

NewObject와 SpawnActor

엄준식사생팬 — Tue, 3 Oct 2023 19:34:02 +0900

NewObject는 엔진이 초기화 된 이후, 런타임에서 오브젝트 생성을 위해 일반적으로 사용한다.

하지만 SpawnActor도 이와 동일한데, 무엇이 다를까?

결론적으로 말하자면, SpawnActor에서 Actor를 생성할 때도 NewObject를 사용한다.

AActor도 결국엔 UObject에서 파생된것이기 때문이다.

하지만 몇 가지 추가 작업을 더 거치게 된다.

일단 NewObject의 Outer는 당연히 ULevel이 된다.

그리고, 현재 Level에 Actor 목록 배열과 GC를 위한 목록 배열을 가지고 있는데 이곳에 넣어둔다.

또한 해당 Actor가 가지고있는 WorldTransform을 설정한다.

그리고 액터의 컴포넌트 생성과 연결을 처리한다.

즉, 해당 작업을 개인적으로 할 수 있다면 AActor를 NewObject로 만들어도 상관은 없다.

근데 코드를 봐서 알겠지만, 그게 더 큰 처리가 될테니 그냥 SpawnActor 쓰자