생각처럼

내일배움캠프 언리얼트랙 45일차 - GAS

thinklikethink — Thu, 25 Jun 2026 20:30:44 +0900

Gameplay Ability System, GAS

< GAS의 개요 >

스킬을 중심으로 액터 간의 상호 작용을 설계하는 프레임워크.

복잡한 스킬 시스템을 가지고 이를 기반으로 캐릭터들이 상호작용하는 RPG, 액션 어드벤처, 모바 같은 장르의 게임을 만들 때 큰 도움이 됨.

=> 대규모 RPG 및 네트워크 멀티플레이어 게임 개발에 최적화된 시스템. 높은 효율성과 확장성을 제공하지만 기본적으로 배워야 할 내용이 많아 학습 장벽이 높으며, 올바른 활용을 위해서는 체계적인 이해가 요구된다.

< 기존의 게임 개발 방식 >

FSM, Behavior Tree같은 현재 상황에 맞춰 다음 행동을 결정하는 언리얼엔진에서 제공하는 대표적인 의사결정 시스템.

결정에 따른 행동 실행은 있지만 결과를 시스템에 반영하는 피드백 구조가 부족함.

결정 시스템으로 명령 내린 행동에 대응하는 캐릭터의 모션은 재생되지만 그 이후의 전체 시스템에 대해서는 개발자가 직접 구형해야 함.

피드백 루프 시스템을 설계하기 위해서는 정교한 설계 능력과 깊은 개발 경험이 필요함.

=> GAS는 코어 게임 플레이 루프 제작을 지원하는 프레임워크이다.

GAS에서 루프의 구성 요소는 Ability, Attribute, Effect 라는 이름으로 제공됨.

< GAS의 장단점 >

모듈화가 잘 되어있다.
- 의존성 최소화.
- 각 컴포넌트가 독립적으로 작동할 수 있도록 설계되어있어 프로젝트 규모에 제한되지않고 쉽게 확장이 가능.
네트워크 멀티플레이어 기능.
- 네트워크상에서 일어나는 일들을 검증하고 문제가 생기면 롤백하는 시스템이 내장됨.
- 소규모 인디 게임 제작 개발자가 활용하기에 가장 좋은 시스템임.
유연성, 확장성
- 복잡하고 다양한 게임 개발 환경을 지원
데이터 기반 설계
- 데이터 테이블과 환경 설정을 기반으로 동작

높은 학습 난이도
- 구성요소가 많고 복잡함
잠재적인 오버헤드
- 규모가 작거나 단순한 프로젝트에는 시스템이 너무 복잡

< GAS의 핵심 구성 요소 >


Ability System Component (ASC)	Ability System Component
Gameplay Tag	Gameplay Tag	Gameplay Tag Container
Gameplay Ability (GA)	Gameplay Ability	Ability Task	Gameplay Event
Attribute Set	Gameplay Attribute Data	Attribute Set
Gameplay Effect (GE)	Instance Gameplay Effect	Durational Gameplay Effect
Gameplay Cue (GC)	GameplayCue Static	GameplayCue Actor

Ability System Component, ASC

-> GAS를 구동하는 핵심 컴포넌트. GAS의 다른 구성요소를 하나씩 쌓아올릴 수 있는 기반.

Actor에 ASC를 붙이면 해당 액터에서 GAS를 사용 가능

Gameplay Tag

-> 언리얼엔진이 기본으로 제공하는 태그보다 강력한 계층 구조를 지원하는 태그 시스템.

사용 시 액터의 상태를 효과적으로 표현가능해 복잡한 코딩작업 없이 특정 조건을 만족할 시 특정 행동을 수행하는 것이 가능함.

GAS가 만드는 커다란 시스템을 잘 정리하고 규모를 늘리는 데 유용하게 사용됨.

Gameplay Ability, GA

-> Gameplay 설계의 시작을 의미.

캐릭터가 행하는 모든 행동(공격, 회피, 캐스팅..)이나 스킬을 GA로 만들 수 있음.

GA로 포장된 캐릭터의 스킬은 이후 성공/실패/취소 등 여러 결과를 가지게 되는데 이를 발동하는 로직을 Ability Task로 처리함.

이러한 스킬을 성공적으로 성공했다면, 이후 Gameplay Event를 통해 다양한 상황 설계 가능.

Attribute Set

-> 체력, 마나, 임시 데미지 같은 캐릭터가 가진 스탯을 표현하는데 사용.

Gameplay Effect, GE

-> 단순한 데미지를 넘어 복잡한 효과를 제작 가능. 게임시스템 설계의 핵심.

GAS가 제공하는 프레임워크 덕분에 코딩 없이 블루프린트로 기본값을 설정하는 것만으로도 쉽게 구현 가능.

Gameplay Cue, GC

-> 치장 효과를 효율적으로 처리할 수 있도록 GAS에서 제공하는 독립적인 시스템.

사용자에게 시각적, 청각적인 피드백 효과를 주는것 : 코스메틱 치장 효과

게임 시스템과 무관하게 동작함.

GC에서 게임 클라이언트에 사용되는 시각적, 청각적인 효과를 모두 모아서 관리함.

< GAS 핵심 게임 플레이 루프 >

GAS의 핵심 구성 요소들은 독립적인 모듈로 제공되지만, 서로 연결되어서 코어 게임 플레이 루프를 구성함.

GAS 핵심 게임 플레이 루프

내일배움캠프 언리얼트랙 44일차 - 손님NPC 신고게이지

thinklikethink — Wed, 24 Jun 2026 21:51:31 +0900

어제 해결하지 못한 문제를 오늘 이어서 해결해보려합니다.

문제 1. 시야 내에서 훔치고 있는데 신고하지 않음. (해결)

<현재 상황>

손님NPC가 플레이어를 감지하는가? O

플레이어가 훔치는 상호작용을 할 때 채널링이 되고 있는가? O

도둑질로 판정을 하고있는가? O

심고 흐름 시작 조건에 부합하는가? O

이렇게 전부 통과되면 신고를 진행해야하는데 진행되지 않음.

손님NPC의 시야 내에서 훔치는 상호작용을 했을 때 뜨는 경고로그

LogStateTree: Warning:
Evaluation forced to false: source data cannot be accessed
(e.g. enter conditions trying to access inactive parent state)

로그 기준으로 NPC의 감지 쪽에는 문제가 없다.

State Tree에 문제가 있다는 것.

StateTree를 살펴보자.

어제 Shopping -> Suspicious의 Transition의 Trogger를 On Tick으로 변경했었다.

Shopping -> Suspicious의 Condition을 살펴보면 현재

TargetActor is Valid

&&

HasSeenTarget == true

&&

IsTargetStealing == true

이렇게 설정해두었다.

각 Shopping상태에서 Suspicious로 가는 조건을 전부 바꿔주겠다.

CanStartReportFlow() == true

CanStartReportFlow()는 신고를 시작할 수 있는지 판단하는 함수이다.
이전에 설정한 조건(TargetActor 유효, bHasSeenTarget, bIsTargetStealing)이 모두 참일 경우 true를 반환한다.

실행해봤는데 달라진게 없다.

음...

Suspicious 상태까지 가는지를 확인하기 위해 Suspicious의 Task에 Debug Text를 추가한다.

LogFTNPC: NPC AI: Picked shopping target BP_FTShoppingPoint_C_1 at X=-1060.000 Y=1190.000 Z=0.000
LogFTNPC: NPC AI: Picked shopping target BP_FTShoppingPoint_C_1 at X=-1060.000 Y=1190.000 Z=0.000

확인해본 결과, Suspicious에 추가했던 Debug Text가 출력되긴 한다, 그런데, 훔치지 않고있는데도 뜬다.

로그와 비교하면서 보니 NPC가 쇼핑 타겟을 고를때마다 디버그 텍스트가 같이 깜빡이며 계속 출력되고 있다.

Shopping_Pick에서 바로 Suspicious로 넘어갔다가 다시 쇼핑 루프로 돌아가는 중일 가능성이 크다.

Shopping_Pick -> Suspicious가 문제인 듯 하다.

Shopping_Pick → Suspicious 전환 삭제

또한, Reporting으로 넘어가지 않는 이유는 Suspicious 가 2초 동안 유지되지 못하고 중간에 끊기고 있는 듯 하다.

이렇게 고치니 시야 범위 내에서 훔치는 상호작용을 할 때 Debug Text가 뜬다.

그런데 아직 신고를 하지는 않고있다.

Reporting쪽을 살펴본다.

흠... 왜 안되는건지 고민고민...하다가 Task가 눈에 들어왔다.

헉 NPCAIController = STT Enter Reporting.NPCAIController로 설정되어있다?!?

허허... 이거때문이었군. 그래서 source data cannot be accessed라는 경고가 떳던거였다.

다른 Task의 변수 값을 참조하는거니 경고가 뜰 수 밖에..

NPCAIController = AIController 으로 당장 고치자

신고게이지가 잘 오르는걸 확인했다!

내일배움캠프 언리얼트랙 43일차 - 손님NPC AI Controller, State Tree(2)

thinklikethink — Tue, 23 Jun 2026 12:32:48 +0900

계속 고치려고 하다보니 너무 꼬여서 손님NPC를 처음부터 다시 만들기로 했습니다..

문제1. 회전 회오리~~(해결)

제자리에서 계속 돌고 있음.

(문제 영상)

<해결 과정>

원인 : 

STT_PickRandomWanderTarget
→ PickRandomWanderTarget 호출
→ Finish Task Success
→ State Completed
→ Shopping으로 즉시 재진입
→ 다시 PickRandomWanderTarget 호출

손님 NPC의 목적지가 계속 바뀌는데 Move To가 제대로 이동하기 전에 다음 포인트로 계속 덮어씌워지는 상태인 듯 하다.

이런식으로 Shopping 하나였던걸 3개로 나눠보았다.

(해결영상)

이제야 잘 움직인다! 해결~~

문제2. 시야 내에서 훔치고 있는데 신고하지 않음.

손님NPC가 플레이어를 감지하긴 함.

그런데, 시야 내에서 물건을 훔치는 상호작용을 하고 있는데도 신고 게이지가 차오르지 않음. Suspicious상태가 되지 않음.

[NPC] Enter Suspicious 로그가 뜨지않음...!

<구현하고자 했던 것>

플레이어가 손님NPC의 시야 내에서 물건을 훔치면 Suspicious됨. 의심게이지가 다 차면 신고.

현재 손님NPC의 State Tree

일단, Shopping -> Suspicious의 Trigger를 On Tick 으로 변경하였다.

이렇게 변경하고 플레이 해보니...

뭔가 경고가 왕창 뜬다.

GPT에게 물어본다.

LogStateTree: Warning:
Evaluation forced to false: source data cannot be accessed
(e.g. enter conditions trying to access inactive parent state)

StateTree 바인딩/조건 위치 문제라고 한다. 의미는

StateTree 조건에서 어떤 데이터를 읽으려고 했는데,
그 데이터가 현재 활성 상태에서 접근 불가능해서
조건 평가를 강제로 false 처리했다

라고하네요.

추정 원인...

Shopping -> Suspicious 조건에서 TargetActor, bHasSeenTarget, bIsTargetStealing을 읽을 때, 그 값이 상태 내부 Task의 Instance Data나 비활성 상태의 데이터로 잡혀 있을 가능성..

이건 내일 해결해보려합니다.

내일배움캠프 언리얼트랙 42일차 - 손님NPC AI Controller, State Tree

thinklikethink — Mon, 22 Jun 2026 11:07:34 +0900

문제 1. 손님 NPC 태그 액터로 이동하지 않는 문제.

<구현하고자 했던 목표>

쇼핑 타겟으로 액터 태그를 가진 액터를 목표로 이동. 어느정도 머물렀다가 다음 타겟으로 이동.

<문제 분석>

일단, 쇼핑 타겟 선택까지는 잘 작동함. 로그도 찍힘.

LogFTNPC: NPC AI: Picked shopping target BP_ShoppingTestActor_C_1 at X=1060.000 Y=-280.000 Z=69.500

즉, PickRandomShoppingTarget() 호출 문제는 아님.

컨트롤러 컴포넌트 상태 확인.

PathFollowingComponent = inactive
NPCStateTreeAIComponent = inactive

흠... 문제가 있군요.

GPT에게 물어보니 State Tree가 타겟 선택 Task까지 실행한 후 끝났거나 Move To Task가 실행되지 않고 있다고 힘.

=> State Tree의 Task에 문제가 있다!

Shopping 상태 안에 고작 이거 하나 넣어놨는데... 음.

아무래도 Shopping 상태가 끝났을 때 다시 Shopping이 실행되지 않는 듯 하다.

랜덤 위치 선택 → 이동 → 대기 → 랜덤 위치 선택 → 이동 → 대기

이런식으로 구현하려 했다.

<해결 과정>

Root
  Shopping
    Task 1: PickRandomShoppingTarget
    Task 2: Move To
      Target Location = AIController.ShoppingTargetLocation
      Acceptable Radius = 50~100
    Task 3: Wait
      Duration = 1~2
    Transition:
      On State Completed → Shopping

이렇게 구현해보았다.

Task 1: PickRandomShoppingTarget은 언리얼 기본 제공 Task가 아니라 직접 만든다.

StateTree Task 생성

StateTreeTaskBlueprintBase

이렇게 만들고

Shopping의 Task에 추가해보았다.

쇼핑 위치 선택
-> 이동
-> 대기
-> 쇼핑 위치 선택
-> 이동
-> 대기
-> ...

잘 작동되기를 기원하며 실행...!

했는데 또 안움직이네 이거;;

이번엔 STT쪽 문제 같아서 Print string 노드를 추가해서 어디서 안되고 있는지 확인해보았다.

(1) 성공했을 경우의 뒤에 Print String 추가.

출력이 안뜸. 즉, 성공하지 않았음.

디버거를 보면...

Current State:
[Root]
[Shopping]

Tasks:
[STT Pick Random Shopping Target]
[Move To]
[Delay Task]

이렇게 나오는데 이 말은 즉슨, Shopping 상태에는 들어갔지만, STT 내부의 Blueprint 이벤트가 실행되지 않았거나 Print가 화면에 안 찍히는 상태. Print는 잘 찍힌다고 가정하고 이벤트가 실행되지 않았을 가능성 존재.

(2) 이벤트가 실행은 되고있는지 확인하기 위해 이벤트노드 바로 뒤에 Print String 추가.

Print가 잘 되는 모습. 그렇다면, 이벤트는 실행되고 있다는 뜻인데..

ShoppingTargetLocation 값은 설정됐지만 Move To가 그 위치로 이동하지 못하고 바로 실패/종료됨

(3) Get Actor Location 뒤에 Print String을 추가해 실제 좌표가 나오는지 확인.

=> 나오지 않음.

그럼 원인은 Get Actor Location까지 흐름이 도달하지 못한다는 뜻!

(4) Get All Actors Of Class 뒤에 Print String을 추가해 쇼핑 타겟으로 액터 태그를 가진 액터를 찾고는 있는지 확인

잘 나옴.

쇼핑 타겟은 정상적으로 찾고 있음. 허허...

(5) Branch True 이후 흐름을 확인하기 위해 Branch의 False에 Print String 추가. 그리고 뒤쪽에 있는 Cast Fail 에도 Print String 추가.

에라이.

원인은 Cast 실패였다.

즉, 지금 Get AIController가 반환한 값이 BP_FTNPCController가 아니라는 뜻.

대부분 Get AIController의 Controlled Actor 입력이 비어 있거나 잘못 들어간 경우 이다.

Controlled Actor가 비어있는 탓일까~ 뚠뚠

StateTree Task 블루프린트에서 Cast 대상이 잘못된 듯 하다...

노드를 찾는건 좀 귀찮으니 C++코드로 바꿔버린다.

여전히 움직이지 않는다. 대신 로그가 계속 뜨고있다.

FT Pick Random Shopping Target에서 Move To까지 못 가고 상태가 다시 들어가는 상태같다.

PickRandomShoppingTarget()가 계속 반복 호출되고있다.

if (NPCAIController->bHasShoppingTarget)
{
	return EStateTreeRunStatus::Running;
}

return NPCAIController->PickRandomShoppingTarget()
	? EStateTreeRunStatus::Running
	: EStateTreeRunStatus::Failed;

방어코드를 추가해준다.

한 번 타겟을 고르면 bHasShoppingTarget == true가 되니까 같은 상태에 들어가더라도 계속 새 타겟을 찾지 않을거다.

이제 로그가 쭈르륵 뜨지 않는다.

... 이 문제는 내일 다시 해결해봐야겠다.

내일배움캠프 언리얼트랙 41일차 - 보안요원 State Tree

thinklikethink — Fri, 19 Jun 2026 12:18:07 +0900

플러그인 활성화

StateTree AI Compponent 선택

트러블슈팅

비상~하향평준화되어버림;; 주말동안 수리 예정..

1. 감지 범위 밖으로 벗어나 있는 상태인데도 계속 추격함. (해결)

원래 구현 목표는 감지범위(노랑, 초록, 시야각)을 벗어나면 마지막으로 목격했던 곳으로 보안요원이 이동하는것입니다. 계속 플레이어를 추격하면 안됨.

2. 공격범위 내에 들어갔다 나오면 추격이 아예 멈춤. 감지범위를 들락날락거려도 가만히있음. (해결)

원래 구현 목표는 공격 범위 안에 있으면 공격을 당하고 그 범위를 벗어나는 즉시 다시 플레이어 추격을 진행.

3. 플레이어가 감지범위 내에 있는 상황에서 ft.Security.TestCall를 했을 때 플레이어를 추격하는게 아닌 신고된 위치로 먼저 이동함. 이동 중 만약 플레이어가 감지범위를 벗어나려하면 그때 플레이어를 추격함. (해결)

원래 구현 목표는 ft.Security.TestCall를 했을 때 플레이어가 감지범위 안에 잇으면 바로 플레이어 추격, 감지 범위 밖에 있다면 신고된 위치로 이동.

bHasSeenTarget을 Perception 이벤트에만 의존하지 않게 변경
매 Tick마다 실제 거리, 시야각, LoseSightRadius, Line of Sight 기준으로 bHasSeenTarget 갱신
ft.Security.TestCall 직후에도 즉시 현재 보이는지 계산
State Tree에서 쓰기 쉽게 bIsTargetInAttackRange, TargetDistance 추가

FTSecurityAIController.h에 추가

UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "FT|Security")
bool bIsTargetInAttackRange = false;

UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "FT|Security")
float TargetDistance = 0.0f;


void UpdateTargetState();
bool IsTargetCurrentlyVisible() const;

FTSecurityAIController.cpp에 추가

void AFTSecurityAIController::UpdateTargetState()
{
	const APawn* ControlledPawn = GetPawn();
	if (!ControlledPawn || !TargetActor)
	{
		TargetDistance = 0.0f;
		bHasSeenTarget = false;
		bIsTargetInAttackRange = false;
		return;
	}

	TargetDistance = FVector::Dist(ControlledPawn->GetActorLocation(), TargetActor->GetActorLocation());
	bIsTargetInAttackRange = TargetDistance <= AttackRange;
	bHasSeenTarget = IsTargetCurrentlyVisible();
}

bool AFTSecurityAIController::IsTargetCurrentlyVisible() const
{
	const APawn* ControlledPawn = GetPawn();
	if (!ControlledPawn || !TargetActor || !SightConfig)
	{
		return false;
	}

	const FVector ToTarget = TargetActor->GetActorLocation() - ControlledPawn->GetActorLocation();
	if (ToTarget.SizeSquared() > FMath::Square(SightConfig->LoseSightRadius))
	{
		return false;
	}

	const FVector Forward = ControlledPawn->GetActorForwardVector();
	const FVector DirectionToTarget = ToTarget.GetSafeNormal();
	const float Dot = FVector::DotProduct(Forward, DirectionToTarget);
	const float AngleDegrees = FMath::RadiansToDegrees(FMath::Acos(FMath::Clamp(Dot, -1.0f, 1.0f)));
	if (AngleDegrees > SightConfig->PeripheralVisionAngleDegrees)
	{
		return false;
	}

	return LineOfSightTo(TargetActor);
}

기존 State Tree

Idle -> Chase
조건 :
AIController.bSecurityCalled == True
&&
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Idle -> Investigate
조건 :
AIController.bSecurityCalled == True
&&
AIController.bHasSeenTarget == False
&&
AIController.TargetActor is Valid

Investigate -> Chase
조건 : 
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Chase -> Attack
조건 : 
Distance from GetActorLocation(Actor) to GetActorLocation(AIController.TargetActor) <= AIController.AttackRange
&&
AIController.TargetActor is Valid

Chase -> Investigate
조건 :
AIController.bHasSeenTarget == False

Attack -> Chase
조건 :
Distance from GetActorLocation(Actor) to GetActorLocation(AIController.TargetActor) > AIController.AttackRange
&&
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Attack -> Investigate
조건 :
AIController.bHasSeenTarget == False

State Tree 조건 변경

Idle -> Chase
조건 :
AIController.bSecurityCalled == True
&&
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Idle -> Investigate
조건 :
AIController.bSecurityCalled == True
&&
AIController.bHasSeenTarget == False
&&
AIController.TargetActor is Valid

Investigate -> Chase
조건 : 
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Chase -> Attack
조건 : 
Distance from GetActorLocation(Actor) to GetActorLocation(AIController.TargetActor) <= AIController.AttackRange
&&
AIController.TargetActor is Valid

Chase -> Investigate
조건 :
AIController.bHasSeenTarget == False

Attack -> Chase
조건 :
Distance from GetActorLocation(Actor) to GetActorLocation(AIController.TargetActor) > AIController.AttackRange
&&
AIController.bHasSeenTarget == True
&&
AIController.TargetActor is Valid

Attack -> Investigate
조건 :
AIController.bHasSeenTarget == False

트리거 On Tick으로 변경

변경 후 생긴 문제 1 (해결)

보안요원이 움직이지 않음. 감지는 잘 되고있는 것으로 확인됨.

(문제 영상) 이면서 이전 문제들의 해결 영상. 감지는 잘 됨.

구조 정리

수정 전

TargetDistance = FVector::Dist(ControlledPawn->GetActorLocation(), TargetActor->GetActorLocation());
bIsTargetInAttackRange = bHasSeenTarget && TargetDistance <= AttackRange;
bHasSeenTarget = IsTargetCurrentlyVisible();

수정 후

TargetDistance = FVector::Dist(ControlledPawn->GetActorLocation(), TargetActor->GetActorLocation());
bHasSeenTarget = IsTargetCurrentlyVisible();
bIsTargetInAttackRange = bHasSeenTarget && TargetDistance <= AttackRange;

bIsTargetInAttackRange가 이전 프레임의 bHasSeenTarget을 보고 계산되던 순서를 수정

(해결 영상 이 영상은 왜 링크밖에 안뜨지;;)

https://youtu.be/1_ETtdWHgzc

문제 2 (해결)

보안요원의 공격범위(빨간 스피어)에서 Idle 상태가 되고 공격하지 않음.

(문제 영상)

Idel -> Chase 추가하여 해결

조건:

bSecurityCalled == true
&& bHasSeenTarget == true
&& bIsTargetInAttackRange == false
&& TargetActor is Valid

(해결 영상)

내일배움캠프 언리얼트랙 40일차 - 보안요원 AI Controller

thinklikethink — Thu, 18 Jun 2026 11:55:34 +0900

MoveToLocation

	const FVector StartLocation = ControllPawn->GetActorLocation();
	const FVector TargetLocation = StartLocation + FVector(500.0f, 0.0f, 0.0f);
	
	MoveToLocation(TargetLocation);
	UE_LOG(LogTemp, Warning, TEXT("Security AI: MoveToLocation Test Started"));

MoveToActor

	APawn* PlayerPawn = UGameplayStatics::GetPlayerPawn(this,0);
	if (!PlayerPawn)
	{
		UE_LOG(LogTemp, Warning, TEXT("Security AI: PlayerPawn is null"));
		return;
	}
	MoveToActor(PlayerPawn);

AI Perception, AI Sense Config

헤더 추가
#include "Perception/AIPerceptionComponent.h"
#include "Perception/AISenseConfig_Sight.h"
#include "Perception/AIPerceptionTypes.h"

객체 생성

SecurityPerceptionComponent = CreateDefaultSubobject<UAIPerceptionComponent>(TEXT("SecurityPerceptionComponent"));
SightConfig = CreateDefaultSubobject<UAISenseConfig_Sight>(TEXT("SightConfig"));

UAIPerceptionComponent는 AI의 감지 기능을 담당하는 컴포넌트

UAISenseConfiig_Sight는 시야 범위, 시야각, 감지 유지 거리 등의 설정을 담당하는 객체

SightConfig->SightRadius = 1500.0f;
SightConfig->LoseSightRadius = 1800.0f;
SightConfig->PeripheralVisionAngleDegrees = 80.0f;
SightConfig->SetMaxAge(3.0f);

SightRadius = 처음 대상을 감지하는 거리

LoseSightRadius = 이미 감지한 대상을 놓치는 거리

PeripheralVisionAngleDegrees = 시야각

SetMaxAge = 감지 정보를 기억하는 시간

SightConfig->DetectionByAffiliation.bDetectEnemies = true;
SightConfig->DetectionByAffiliation.bDetectFriendlies = true;
SightConfig->DetectionByAffiliation.bDetectNeutrals = true;

DetectionByAffiliation = 적/아군/중립 감지 여부

SecurityPerceptionComponent->ConfigureSense(*SightConfig);
SecurityPerceptionComponent->SetDominantSense(SightConfig->GetSenseImplementation());
SetPerceptionComponent(*SecurityPerceptionComponent);

ConfigureSense()를 통해 시야 설정을 PerceptionComponent에 적용 가능

SecurityPerceptionComponent->OnTargetPerceptionUpdated.AddDynamic(
	this,
	&AFTSecurityAIController::OnTargetPerceptionUpdated
);

OnTargetPerceptionUpdated = 감지 상태가 바뀔 때 호출됨

즉, 플레이어를 발견하거나 놓쳤을 때 실행됨.

Broadcast

헤더 추가
#include "GameFramework/GameplayMessageSubsystem.h"
#include "ProjectFT/Message/FTGameplayTags.h"
#include "ProjectFT/Struct/FTNPCReportPayloadStruct.h"

FFTNPCReportPayloadStruct Payload;
Payload.TargetActor = PlayerPawn;
Payload.ReportLocation = PlayerPawn->GetActorLocation();
Payload.ReportAmount = 100.0f;
Payload.ReportProgress = 1.0f;

UGameplayMessageSubsystem::Get(World).BroadcastMessage(
	TAG_FT_Event_SecurityCalled,
	Payload
);

BroadCastMessage() = 특정 GameplayTag 채널로 메시지를 보내는 코드

위 코드에선 콘솔 명령어 ft.Security.TestCall을 실행하면 Event.Security.Called 메시지를 발행한다.

FTNPCReportPayloadStruct에 다음 정보를 담아 전달한다.

TargetActor = 신고된 대상

ReportLocation = 신고 위치

ReportAmount = 신고 수치

ReportProgress = 신고 진행도

Listener

SecurityCalledListenerHandle = MessageSubsystem.RegisterListener(
	TAG_FT_Event_SecurityCalled, 
	this, 
	&ThisClass::OnSecurityCalled
);

RegisterListener() = 특정 메시지를 듣기 위해 등록하는 코드

위 코드에서는 TAG_FT_Event_SecurityCalled 메시지가 발행되면 OnSecurityCalled() 함수가 자동으로 호출됨.

void AFTSecurityAIController::OnSecurityCalled(
	FGameplayTag Channel,
	const FFTNPCReportPayloadStruct& Payload
)
{
	// 신고 메시지 처리
}

if (SecurityCalledListenerHandle.IsValid())
{
	UGameplayMessageSubsystem::Get(this).UnregisterListener(SecurityCalledListenerHandle);
}

UnregisterListener() = AIController가 사라질 때 등록된 리스너를 해제하는 코드.

이렇게 해제하지 않으면 이미 사라진 객체가 메시지를 받으려고 해서 문제가 생길 수 있음.

정리

BroadcastMessage()
→ “신고 발생!” 메시지를 보냄

RegisterListener()
→ “신고 발생!” 메시지를 기다림

OnSecurityCalled()
→ 메시지를 받았을 때 실제 행동 결정

AI Perception
→ 이동 중 플레이어를 직접 감지하면 추격 시작

트러블 슈팅

1. 보안요원의 감지 범위 밖에서 호출됐는데도 플레이어를 따라옴

- 원래 구현하고자 했던 방향 : 감지 범위 밖에서 호출되면 호출 된 위치로만 이동. 감지 범위 내에서 호출됐을 때 플레이어를 감지하면 플레이어를 추격.

신호 받음
↓
TargetActor 유효성 확인
↓
보안요원 기준으로 TargetActor까지 거리 계산
↓
LoseSightRadius 안쪽이면
    → SetTargetActor()
    → StartChase()
↓
LoseSightRadius 바깥이면
    → SetTargetActor()는 해두되
    → MoveToLocation(Payload.ReportLocation)
    → 추격은 하지 않음
↓
이동 중 Perception이 TargetActor를 감지하면
    → OnTargetPerceptionUpdated()
    → StartChase()

- 원인 : 현재 MoveToActor(TargetActor)는 범위 밖이어도 Actor 자체를 계속 추적하기 때문에, 플레이어가 움직이면 그대로 따라감.

void AFTSecurityAIController::OnSecurityCalled(FGameplayTag Channel, const FFTNPCReportPayloadStruct& Payload)
{
	// 보안 호출 메시지에 추적 대상이 없으면 처리 불가
	if (!Payload.TargetActor)
	{
		UE_LOG(LogTemp, Warning, TEXT("Security AI: Security called but TargetActor is null"));
		return;
	}

	// 메시지로 전달받은 플레이어를 현재 추적 대상으로 설정
	SetTargetActor(Payload.TargetActor);

	// 추격 시작
	StartChase();

	UE_LOG(LogTemp, Log, TEXT("Security AI: Security called, chasing %s"), *Payload.TargetActor->GetName());
}

< 해결 >

TargetActor가 LoseSightRadius 안에 있음
→ StartChase()
→ MoveToActor(TargetActor)

TargetActor가 LoseSightRadius 밖에 있음
→ MoveToLocation(Payload.ReportLocation)
→ 호출 당시 위치로 이동
→ 실제 추격은 Perception으로 다시 감지됐을 때 시작

void AFTSecurityAIController::OnSecurityCalled(FGameplayTag Channel, const FFTNPCReportPayloadStruct& Payload)
{
	// 신고 메시지에 추적 대상이 없으면 처리할 수 없으므로 종료
	if (!Payload.TargetActor)
	{
		UE_LOG(LogTemp, Warning, TEXT("Security AI: TargetActor is null"));
		return;
	}

	// AI가 조종 중인 Pawn 또는 시야 설정이 없으면
	// 거리 판단이 불가능하므로 종료
	const APawn* ControlledPawn = GetPawn();
	if (!ControlledPawn || !SightConfig)
	{
		UE_LOG(LogTemp, Warning, TEXT("Security AI: ControlledPawn or SightConfig is null"));
		return;
	}

	// 신고된 플레이어를 현재 추적 대상으로 저장
	// (즉시 추격 여부는 아래 거리 검사 후 결정)
	SetTargetActor(Payload.TargetActor);

	// 보안요원과 플레이어 사이의 현재 거리 계산
	const float DistanceToTarget = FVector::Dist(
		ControlledPawn->GetActorLocation(),
		Payload.TargetActor->GetActorLocation()
	);

	// 플레이어가 감지 유지 범위(LoseSightRadius) 안에 있다면
	// 즉시 추격 시작
	if (DistanceToTarget <= SightConfig->LoseSightRadius)
	{
		StartChase();

		UE_LOG(LogTemp, Log,
			TEXT("Security AI: Target in range, chasing %s"),
			*Payload.TargetActor->GetName());

		return;
	}

	// 플레이어가 감지 범위 밖에 있다면
	// 신고가 들어온 위치를 조사하러 이동
	const FVector InvestigateLocation =
		Payload.ReportLocation.IsNearlyZero()
		? Payload.TargetActor->GetActorLocation() // 신고 위치가 없으면 현재 위치 사용
		: Payload.ReportLocation;                 // 신고 위치가 있으면 해당 위치 사용

	// 조사 위치로 이동
	const EPathFollowingRequestResult::Type MoveResult =
		MoveToLocation(InvestigateLocation, 150.0f);

	UE_LOG(LogTemp, Log,
		TEXT("Security AI: Investigating location %s, result %d"),
		*InvestigateLocation.ToString(),
		static_cast<int32>(MoveResult));
}

TargetActor 없음 → 종료
Pawn / SightConfig 없음 → 종료
TargetActor 저장
거리 계산
LoseSightRadius 안 → StartChase()
LoseSightRadius 밖 → ReportLocation으로 이동

2. 플레이어와 접촉 후 추격 멈춤

플레이어를 추격하다가 접촉하면 보안요원의 감지 범위 내에 있어도 플레이어 추격을 멈춤. 감지 범위를 벗어나려 하면 그제서야 다시 추적함.

- 원래 구현하고자 했던 방향 : 추격하다가 플레이어가 공격 범위 안에 들어오면 공격(공격구현은 아직). 감지 범위 내에 있으면 계속 추적.

- 원인 : MoveToActor()가 한 번 “도착 완료”로 끝나버림, MoveToActor(TargetActor)AI Perception의 OnTargetPerceptionUpdated는 계속 보이는 중에는 매 프레임 호출되고 있지 않음.

현재 흐름
Security.Called
→ MoveToActor(TargetActor)
→ 보안요원이 플레이어에게 접근
→ 플레이어와 캡슐 충돌/겹침 또는 근접
→ AI가 “목표에 도착했다”고 판단
→ 이동 요청 종료

즉, 플레이어가 게속 시야안에 있으면 새 이벤트가 없음. -> MoveToActor()를 다시 호출할 일이 없어서 추격을 멈춤.

그런데! 플레이어가 보안요원의 시야각을 벗어나려고 하면 Perception 상태가 변함 -> OnTargetPerceptionUpdated()가 호출되어 그제서야 MoveToActor()를 실행함.

~~애가 일머리가 읎어...~~

문제점 정리
부딪힘
→ MoveToActor 완료 처리
→ Perception은 계속 보이는 상태라 새 이벤트 없음
→ 이동 명령이 다시 안 들어감
→ 멈춤
→ 시야를 벗어나려 하면 Perception 이벤트 발생
→ 다시 MoveToActor 호출
→ 다시 따라옴

GPT에게 물어보니 Tick에서 매 프레임 호출하는 것으로 구현을 하면 가능하다는데.. 말고도 StateTree로도 이 문제를 해결할 수 있다고 한다. 내일 StateTree로 이 문제를 해결해 볼 예정이다.

오늘의 영상

https://youtu.be/vvaRqGFa4yE?si=CaE1INz-pxfuAWAr

내일배움캠프 언리얼트랙 38일차 - 심화반 2강

thinklikethink — Tue, 16 Jun 2026 23:26:55 +0900

4대 핵심 클래스

클래스 명	비유	핵심 특징
AGameMode	Rule Maker (심판)	규칙을 정하고 승패를 판정. 서버에만 존재.
AGameState	Scoreboard (전광판)	현재 점수, 남은 시간 등 모두가 봐야 하는 정보를 공유함.
APlayerState	개인 수첩	개별 이름, 득점 등 개인 데이터를 기록함.
UGameInstance	총관리자	레벨이 끝나고 다음 레벨로 넘어가도 절대 사라지지 않음.

AGameMode

키워드 : 규칙, 서버 전용, 오직 명령만(내게 명령하지마라. 명령은 내가 한다.)

역할

게임의 룰 관리
- 승리하려면 몇점을 내야하는지, 제한 시간은 얼마나 되는지 등 규칙을 가짐.
Spawn 결정
- 플레이어에게 어떤 Pawn을 줄지, PlayerStart를 어디로 할지를 결정.
게임 흐름 제어
- 스테이지 시작, 관전모드 전환, 게임오버 등 굵직한 판정을 내림.

특징

Server Only. 서버에만 산다!
- 멀티플레이 게임을 만들 때 가장 많이 하는 실수가 클라이언트에서 GameMode를 찾으려고 하는것.
- AGameMode는 오직 서버(Host) 메모리에만 존재한다. 즉, A라는 유저의 컴퓨터(클라이언트)에는 GameMode가 아예 존재하지 않음!
- 클라이언트에 GameMode가 있으면 게임의 규칙을 바꿔버릴 수 있기 때문에 보안을 위해 서버에만 둔다.

Base vs 일반

AGameModeBase (가벼운 기본형)
- 싱글 플레이 게임이나 오픈월드RPG처럼 "시작과 끝이 단순한 게임"에 적합
AGameMode (매치 시스템이 있는 무거운 버전)
- FPS처럼 먕확한 단계(State Machine)가 필요한 게임에 사용

핵심 구현 패턴

결정만 하고 AGameState에 넘기기!

AGameMode는 결정하는 고귀한 아이. 동네방네 소문내는 입이 가벼운 아이가 아님!

void AMyGameMode::StartMatch()
{
	bMatchInProgress = true;
    
    // 1. GameMode가 매치 시작이라고 결정
    if(AMyGameState* GS = GetGameState<AMyGameState>())
    {
    	// 2. 그 사실을 GameState에 넘겨서 모두가 볼 수 있게 함
        GS->NotifyMatchStarted(MatchDuration);
    }
}

만약 GameMode가 남은 시간 변수를 직접 가지고 있으면, 클라이언트들은 GameMode를 볼 수 없으니 화면에 남은 시간이 뜨지 않는 대참사가 발생함.

즉, GameMode는 명령만 내리고, 변수는 모두가 볼 수 있는 AGameState에 적어두는것이 정석이다.

AGameState

키워드 : 네트워크 복제, 읽기 전용

역할

GameMode 가 내린 결정이나 게임의 현재 상황을 담아서 모든 유저가 볼 수 있도록 동기화.

특징

클라이언트와 UI가 읽기만 해야한다. 데이터를 직접 수정하는 결정은 GameMode의 역할이다.

APlayerState

키워드 : 개인 데이터의 영속성(Persistence), 모두에게 복제(Replication), 한 레벨에 유지

역할 / 특징

내 캐릭터가 죽으면 그 캐릭터는 월드에서 파괴되거나 사라진다. 만약 캐릭터에 점수/킬카운트를 저장했다면 캐릭터가 죽어서 사라질 때 내 점수와 킬카운트값도 공중분해 영영 빠이빠이 되어버린다. 흑흑. 리스폰 했더니 내 화려한 전적이 0이 되어버림..

따라서 캐릭터(Pawn)은 언제든 갈아치우는 일회용 몸뚱이로 쓰고 절대 사라지면 안되는 내 데이터(이름, 점수, 팀, 핑...)는 PlayerState라는 개인 수첩에 보관하는 것이다. 이렇게 하면 캐릭터가 죽어도 수첩의 내용은 그대로이니 완전안심!

APlayerController는 나와 서버만 볼 수 있다. 즉, 다른 사람의 화면이나 컴퓨터에는 보이지 않는다.

APlayerState는 서버가 모든 클라이언트에세 복제(Replication)을 해준다.

-> 점수판을 확인할때 다른 사람들의 점수와 이름도 다 보여야하니까! PlayerController는 나한테 안보이지만 PlayerState는 모두에게 공유되기 때문에 점수판UI를 만들땐 항상 PlayerState를 뒤져서 데이터를 가져온다!

접근 방법

// ❌ 절대 금지 (안티 패턴): 전광판 배열에서 그냥 0번 인덱스 꺼내기
// 싱글 게임에선 돌아갈지 몰라도, 멀티게임에선 누가 0번일지 장담할 수 없습니다!
AMyPlayerState* BadPS = GetWorld()->GetGameState()->PlayerArray[0];

//  올바른 방법 1: 내 컨트롤러에게 "내 수첩 줘"라고 하기 (내 UI 갱신할 때)
AMyPlayerState* MyPS = MyController->GetPlayerState<AMyPlayerState>();

//  올바른 방법 2: 클라이언트가 점수를 얻고 싶을 때 (핵 방지용 RPC 요청)
// "내 수첩아, 나 50점 먹었으니까 서버에 적용해줘!"
MyPlayerState->Server_AddScore(50);

GameInstance

키워드 : 불사신, 레벨 전환 이사 전문

역할

전체 누적 데이터 관리
- 플레이어의 총 누적 골드, 여태까지 클리어 한 스테이지 번호 등 게임 전체를 관통하는 데이터를 들고있기에 가장 좋다.
레벨 전환의 총지휘관
- 레벨을 열고 닫는 권환을 실행하기 가장 좋은 위치이다.

특징

수명
- 게임 프로그램을 킬 때 태어나서, 게임을 완전히 종료할 때 죽는다.
불사신
- 로비 레벨, 마을 레벨 심지어 메인 메뉴 화면으로 돌아가더라도 GameInstance만큼은 메모리에서 절대 사라지지 않고 단 하나만 계속 유지된다.

APlayerController

내가 이 캐릭터의 영혼이다 중생들아

유저가 키보드를 누르고 마우스를 움직이는 모든 행동을 게임 속 세계로 전달하는 컨트롤러 역할

하는 일

입력 처리 (Input Binding)
- 플레이어의 입력을 받아 처리한다.
육체 빙의 (Possess / UnPossess)
- 월드에 배치된 캐릭터(APawn)에 영혼을 불어넣는 역할을 한다. 캐릭터가 죽으면 빠져나오고 부활하면 새 캐릭터에 다시 빙의한다.
카메라 및 UI 관리
- PlayerCameraManager를 관리하고, 화면에 마우스 커서를 띄우거나 마우스 클릭 기반의 HUD/UMG 위젯 UI를 생성하고 조작하는 주체가 된다.

서버와 본인 컴퓨터에만 존재

멀티플레이에서 컨트롤러의 메모리 구조는 대단히 독특함!

서버 (HOST)
- 모든 점속자의 PlayerController를 전부 가지고 관리한다.
- 누가 무슨 행동을 하느지 알아야하니까!
내 컴퓨터 (로컬 클라이언트)
- 오직 내 것 하나만 존재한다. 다른 사람의 PlayerController는 내 컴퓨터 메모리에 아예 생성되지 않는다.
다른 사람 컴퓨터
- 내 PlayerController가 존재하지 않는다.

AIController

사람이 조종하는 캐릭터가 아닌, 컴퓨터가 조종하는 몬스터나 NPC의 영혼역할을 맡는다.

입력이나 UI를 처리하는 기능이 쏙 빠져있는 대신, Behavior Tree나 주변을 감지하는 UAIPerceptionComponent를 장착해서 스스로 Pawn을 조종하게 된다.

APawn vs ACharacter

움직이는 육체들의 등급

컨트롤러(영혼)가 빙의할 수 있는 모든 물리적인 몸뚱이는 APawn에서 출발한다. 언리얼은 이를 크게 두 가지로 나누어 제공한다.

APawn

특징

인간이 아닌 형태의 탈것이나 물체를 만들 때 주로 상속 받는다.

아주 기본적인 이동 컴포넌트(MovementComponent)만 가지고 있어서, 하늘을 날거나 구르는 물리 로직을 개발자가 커스텀하기에 좋다.

ACharacter

특징

사람처럼 두 발로 걷고, 달리고, 점프하는 캐릭터를 만들 때 쓴다. RPG나 FPS게임의 주인공들은 99% 이 녀석을 상속받는다.

언리얼이 미리 엄청난 기능들을 기본으로 추가해두었다.

CharacterMovementComponent
- 걷기, 달리기, 점프, 수영, 비행 등 인간형 이동 로직이 이미 완벽하게 구현되어있다.
CapsuleComponent
- 부딪히는 물리 충돌 체형
SkeletalMeshComponent
- 애니메이션을 입힐 수 있는 뼈대 메쉬

특수 Pawn

ADefaultPawn

자유 비행 카메라용. 에디터/디버깅에서 자주 쓰인다.

ASpectatorPawn

매치 관전 모드용. 충돌 없이 자유 이동 가능.

Framework 로딩 순서 (LifeCycle)

1단계: 가장 먼저 태어나는 맏형 (GameInstance)

게임이 켜지자마자 UGameInstance::Init()이 실행된다.
주의: 이때는 아직 월드(World)도 없고, 다른 4대장들도 아예 안 태어난 상태. 여기서 GetWorld()나 GetPlayerController()를 호출하면 무조건 튕긴다!

2단계: 레벨이 열리며 태어나는 동생들 (응애 응애)

맵이 로드되면 GameMode => GameState => PlayerController => PlayerState => Pawn 순서로 순식간에 스폰됨.

3단계: PostLogin()과 StartPlay()

많은 초보자가 BeginPlay()에서 모든 걸 해결하려고 한다. 하지만 BeginPlay는 애들의 호출 순서가 뒤죽박죽이라 위험!
가장 안전한 타이밍: 심판(GameMode)의 PostLogin() 함수. 이 함수가 실행되는 시점에는 플레이어의 영혼(PlayerController)과 수첩(PlayerState)이 완벽하게 세팅되어 연결된 상태이므로, 멀티플레이어 초기화 코드를 짜기에 가장 안전의 정석이다.

내일배움캠프 언리얼트랙 35일차 - TA 1강

thinklikethink — Thu, 11 Jun 2026 16:41:29 +0900

즐거운 과제

1. 선택한 게임과 액션
- 오버워치, 라인하르트 돌진 액션

2. 시작 이벤트
이 액션은 어떤 입력 또는 이벤트에서 시작되는가?
- 플레이어가 Shift 키 입력

- 입력 시스템이 Charge 스킬 실행 요청

- 스킬 사용 가능 여부 확인 (쿨타임, 상태 이상 여부)

- 조건 충족 시 돌진 State 진입

3. 필요한 리소스
- Mesh: 라인하르트 캐릭터 메시, 로켓 해머 메시, 충돌 판정용 콜리전
- Animation: Charge Start, Charge Loop, Impact, Charge End
- VFX: 발 밑 먼지 효과, 돌진 불꽃 효과, 충돌 스파크 효과, 벽 충돌 이펙트
- Material: 갑옷 발광 효과, 돌진 추진기 발광 머티리얼, 피격 플래시 머티리얼
- Sound: 돌진 시작 음향, 추진기 엔진 소리, 적 명중 효과음, 벽 충돌 효과음
- Camera: FOV 확대, 카메라 쉐이크, 속도감 연출
- UI: 스킬 아이콘, 쿨타임 표시, 적 명중 표시

4. 연결 흐름
1) 플레이어가 Shift 입력
2) 스킬 사용 가능 여부 검사
3) Charge 애니메이션 재생 + 이동 속도 증가(돌진 가속)
4) 전방으로 돌진하며 충돌 판정 검사
5) 적 또는 벽과 충돌 시 피해 적용/애니메이션 전환/스킬 종료 및 쿨타임 시작

5. 역할 분리
- 개발자 담당: 입력 처리/상태머신구현/충돌판정/피해계산/쿨타임/네트워크동기화
- 아티스트 담당: 캐릭터 애니메이션/충돌VFX/추진기효과/사운드리소스 제작
- TA 관점에서 확인할 부분: 애니메이션과 이동 속도 싱크/VFX발생 위치 정확성/충돌 타이밍과 이펙트 타이밍 일치/카메라연출성능최적화/네트워크 환경에서 이펙트 동기화

6. 정리
이 액션에서 가장 중요하다고 생각한 연결 지점은 무엇인가?

충돌 판정 <= => 애니메이션 <= => 피해적용

입력 => 상태전환 => 애니메이션 => 이동 => 충돌 => 피해 => VFX/SFX => 카메라 연출

내일배움캠프 언리얼트랙 34일차 - 과제04

thinklikethink — Wed, 10 Jun 2026 16:34:00 +0900

과제 04 필수구현기능

1. C++ Pawn 클래스 및 컴포넌트 구성

Pawn 클래스 생성

컴포넌트 추가
- CapsuleComponent (또는 Box/Sphere 중 택 1)
- SkeletalMeshComponent
- SpringArmComponent
- CameraComponent

	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category= "Component")
	UCapsuleComponent* CapsuleComp;
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category= "Component")
	USkeletalMeshComponent* SkeletalMeshComp;
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category= "Camera")
	USpringArmComponent* SpringArmComp;
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category= "Camera")
	UCameraComponent* CameraComp;

DefaultPawn 설정 : GameMode 클래스에서 DefaultPawnClass를 본인이 만든 Pawn으로 지정.

	DefaultPawnClass = AMyCharacter::StaticClass();

Physics 설정 : 루트 충돌체 및 Mesh의 Simulate Physics를 false로 설정. (물리 대신 코드로 직접 제어)
계층 구조 설정 : 충돌 컴포넌트를 RootComponent로 설정하고, 나머지 컴포넌트들을 부착.

	CapsuleComp = CreateDefaultSubobject<UCapsuleComponent>(TEXT("CapsuleComp"));
	SetRootComponent(CapsuleComp);
	CapsuleComp->SetSimulatePhysics(false);
	
	SkeletalMeshComp = CreateDefaultSubobject<USkeletalMeshComponent>(TEXT("SkeletalMeshComp"));
	SkeletalMeshComp->SetupAttachment(RootComponent);
	SkeletalMeshComp->SetSimulatePhysics(false);
	
	SpringArmComp = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComp"));
	SpringArmComp-> SetupAttachment(RootComponent);
	SpringArmComp-> TargetArmLength = 300.0f;
	SpringArmComp -> bUsePawnControlRotation = false;
	
	CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));
	CameraComp->SetupAttachment(SpringArmComp, USpringArmComponent::SocketName);
	CameraComp -> bUsePawnControlRotation = false;

2. Enhanced Input 매핑 & 바인딩

입력 액션(IA) 생성 : 두 가지 액션을 생성. (타입 : Vector2D)
- IA_Move (WASD 이동용)
- IA_Look (마우스 회전용)

IMC 매핑 : 생성한 액션들을 Input Mapping Context에 등록하고 키를 할당.
액션 바인딩 : SetupPlayerInputComponent()에서 입력 처리 함수와 액션들을 바인딩.

void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
	Super::SetupPlayerInputComponent(PlayerInputComponent);
	if (UEnhancedInputComponent* EnhancedInput = Cast<UEnhancedInputComponent>(PlayerInputComponent))
	{
		if (AMyPlayerController* PlayerController = Cast<AMyPlayerController>(GetController()))
		{
			if (PlayerController -> MoveAction)
			{
				EnhancedInput->BindAction(
					PlayerController -> MoveAction,
					ETriggerEvent::Triggered,
					this,
					&AMyCharacter::Move
					);
			}
			
			if (PlayerController -> LookAction)
			{
				EnhancedInput->BindAction(
					PlayerController -> LookAction,
					ETriggerEvent::Triggered,
					this,
					&AMyCharacter::Look
					);
			}
		}
	}
}

3. 이동 및 회전 로직 구현

프레임 독립성 : DeltaTime을 사용하여 프레임 속도와 관계없이 일정한 속도로 움직이도록 구현.
이동 구현 : AddActorLocalOffset()등을 활용해 WASD 입력에 따라 Pawn이 움직이도록 작성.
- 이동 방향은 Pawn의 Forward/Right 벡터를 기준으로 결정.

void AMyCharacter::Move(const FInputActionValue& value)
{
	if (!Controller) return;

	const FVector2D MoveInput = value.Get<FVector2D>();
	const float DeltaTime = GetWorld()->GetDeltaSeconds();

	const FVector Forward = GetActorForwardVector();
	const FVector Right = GetActorRightVector();
	
	FVector DeltaLocation = FVector::ZeroVector;
	DeltaLocation.X = MoveInput.X * MovementSpeed * DeltaTime;
	DeltaLocation.Y = MoveInput.Y * MovementSpeed * DeltaTime;
	DeltaLocation.Z = 0.0f;

	AddActorLocalOffset(DeltaLocation, true);
}

회전 구현 : AddActorLocalRotation() 등을 활용해 마우스 입력에 따라 회전하도록 작성.
- 마우스 입력값으로 Yaw와 Pitch를 직접 계산하여 구현
- 주의 : AddControllerYawInput(), AddControllerPitchInput() 등 엔진 기본 제공 함수는 사용하지 않습니다.

void AMyCharacter::Look(const FInputActionValue& value)
{
	if (!Controller) return;

	const FVector2D LookInput = value.Get<FVector2D>();
	const float DeltaTime = GetWorld()->GetDeltaSeconds();

	// 좌우 회전: 캐릭터 몸 전체 회전
	const float DeltaYaw = LookInput.X * RotationSpeed * DeltaTime;
	AddActorLocalRotation(FRotator(0.0f, DeltaYaw, 0.0f));

	// 상하 회전: SpringArm만 회전
	const float DeltaPitch = LookInput.Y * RotationSpeed * DeltaTime * -1;

	FRotator SpringArmRotation = SpringArmComp->GetRelativeRotation();
	SpringArmRotation.Pitch += DeltaPitch;

	SpringArmRotation.Pitch = FMath::Clamp(SpringArmRotation.Pitch, -60.0f, 30.0f);
	SpringArmRotation.Yaw = 0.0f;
	SpringArmRotation.Roll = 0.0f;

	SpringArmComp->SetRelativeRotation(SpringArmRotation);
}

제한 사항 : 평면 상에서의 이동과 회전만 처리하며, 중력이나 낙하 효과는 고려하지 않습니다.

내일배움캠프 언리얼트랙 33일차

thinklikethink — Wed, 10 Jun 2026 01:54:30 +0900

팀프로젝트 준비

NPC 성향 맹인 주인공이 파악하는 단서

NPC 성향	맹인 주인공이 파악하는 단서
보호형	몬스터 쪽으로 뛰어가는 발소리, “뒤로 가!” 같은 대사
안내형	길 설명, 위험 구역 경고
겁쟁이	떨리는 목소리, 멀어지는 발소리
이기적	문 잠그는 소리, 숨죽이는 소리
배신형	일부러 틀린 길 안내, 몬스터를 부르는 소리
약탈형	가방 뒤지는 소리, 아이템 무게 변화

AIController

-> NPC 조종.

ex)

저기로 이동해/플레이어를 따라가/문을 닫아/도망쳐/몬스터를 막아

Behavior Tree

-> AI의 행동 순서표.

-> 어떤 조건일 때 어떤 행동을 할지를 시각적으로 짜는 시스템.

ex) 겁쟁이 NPC인 경우.
몬스터를 봤는가?
→ 봤다
→ 도망갈 장소가 있는가?
→ 있다
→ 도망간다

ex) 보호형 NPC인 경우.
플레이어가 위험한가?
→ 위험하다
→ 몬스터에게 접근한다
→ 시간을 번다

Blackboard

-> AI가 참고하는 메모장.

-> Behavior Tree가 판단하기 위해서는 정보가 필요함.

-> Behavior Tree는 Blackboard 값을 보고 판단함.

ex)
PlayerActor = 현재 플레이어
MonsterActor = 근처 몬스터
CurrentState = Escape
NPCType = Coward
TargetLocation = 숨을 장소 위치

Finite Statr Machine, FSM

-> 상태기계.

-> 햔재 상태를 정해놓고 상태에 따라 다르게 행동하는 방식.

-> NPC가 지금 무슨 모드인지를 관리하는 구조.

ex) NPC 상태

Idle
Talk
Follow
RunAway
Hide
CloseDoor
Report
Loot

ex) 겁쟁이 NPC
Idle 상태
↓ 몬스터 발견
RunAway 상태
↓ 숨을 곳 도착
Hide 상태

ex) 배신형 NPC
Idle 상태
↓ 플레이어가 도둑질하는 걸 봄
Report 상태
↓ 몬스터에게 위치 전달
RunAway 상태

NPC Base Class

-> 모든 NPC가 공통으로 쓰는 기본 설계도.

NPC 종류마다 클래스를 따로 만드는 상속구조보다는

NPC클래스는 하나만 만들고, 성향 데이터로 행동을 바꾸는 데이터 기반으로 채택.

Environment Query System, EQS

-> AI용 위치 추천기.

-> AI가 환경을 평가하여 최적의 위치를 선택하는 시스템.

플레이어가 NPC 근처 접근
↓
ANPCBase가 상호작용 감지
↓
NPCPersonalityData 확인
↓
현재 상황 판단
몬스터 있음? / 도난 목격? / 플레이어 위험?
↓
FSM 상태 변경
↓
Behavior Tree가 행동 실행
↓
NPC 행동
도망 / 숨기 / 문 닫기 / 신고 / 약탈 / 안내 / 보호

정리

ANPCBase

공통 기능

NPCPersonalityData

성향 데이터

ENPCState

현재 상태

NPC_AIController

AI 실행

Blackboard

판단용 정보 저장

Behavior Tree

행동 선택