seonhwan2547 님의 블로그

Unreal 상하체 분리 애니메이션 적용하기

seonhwan2547 — Wed, 25 Mar 2026 19:09:24 +0900

카잔 게임을 모작하는 과정에서, 공격 이후 다시 로코모션 상태로 전환될 때 창을 정비하며 방향을 틀고 걷는 애니메이션이 필요했다.

하지만 해당 동작에 사용된 애니메이션들은 모두 전신 애니메이션이였기 때문에, 원하는 표현을 위해서는 상체와 하체의 동작을

분리해서 적용해야 했다.

이에 따라 하체는 이동과 회전에 맞는 Run 모션을 유지하고, 상체는 창을 정비하는 동작을 재생하도록 구성하여 두 동작이 자연스럽게 동시에 보이도록 구현했다.

왼쪽 Run Motion 오른쪽 Attack Motion

해당 두 개의 모션을 섞은 결과

khazan 애니메이션 상하체 분리 애니메이션 적용

Layered blend per bone을 사용하여 상하체 분리 애니메이션 적용

Layer Blend Per Bone 노드를 활용하여 상체와 하체 애니메이션을 분리하여 재생하였다.

Base Pose 에는 기본적으로 전체 움직임을 담당하는 원래 애니메이션을 연결하고, Blend Pose 0 에는 상체에만 적용할 애니메이션을 연결하였다.

이후 Blend Pose 0의 블렌드 기준이 되는 본을 저장하여, 해당 본을 기준으로 상위 계층의 뼈들은 Default Slot 몽타주 애니메이션이 덮어쓰도록 설정하였다.

여기서는 상체 동작을 확실하게 적용하기 위해 Blend Weight 값을 1.0으로 주어, 지정한 상체 영역이 해당 애니메이션으로 완전히 대체되도록 구성하였다.

또한 몽타주에 재생되는 상체 애니메이션의 길이와 타이밍에 맞춰 자연스럽게 전환되도록, Default Slot의 재생 상태를 기준으로 상체 애니메이션의 진행 시점을 동기화 하였다.

Blueprint 공부 일기 7 (Camera Shake, State Alias(점프), UI 이벤트)

seonhwan2547 — Mon, 23 Mar 2026 12:34:40 +0900

Camera Shake

게임을 만들다 보면 캐릭터가 공격을 맞거나, 패링에 성공하거나, 강한 타격을 가했을 때

화면에 순간적인 흔들림 연출이 필요할 때가 있습니다.

이런 연출은 타격감과 액션의 몰입감을 높여주는 중요한 요소이며, 언리얼 엔진에서는 이를 Camera Shake 기능으로

비교적 쉽게 구현할 수 있습니다.

이번에는 언리얼 Blueprint에서 Camera Shaking을 적용하는 기본 방법에 대해 정리해 보겠습니다.

1. Character에 Camera Shake Source 컴포넌트 추가하기

먼저 카메라 흔들림의 기준이 될 수 있도록 캐릭터 블루프린트에 Camera Shake Source 컴포넌트를 추가합니다.

이 컴포넌트는 특정 위치를 기준으로 카메라 쉐이크 효과를 발생시키는 역할을 하며, 보통 플레이어 캐릭터나 몬스터, 혹은 타격이 발생하는 오브젝트에 부착하여 사용합니다.

2. Camera Shake Blueprint 생성 및 설정하기

다음으로는 Camera Shake Blueprint를 생성한 뒤, 흔들림의 패턴과 강도를 성정해줍니다.

생성한 블루프린트의 Class Defaults에서는 카메라가 어떤 방식으로 흔들릴지 세부적으로 조절할 수 있습니다.

Camera Shake 설정하기

Jump 구현해보기

점프 기능을 구현할 때는 애니메이션 상태 머신에서 State Alias를 활용하면 편리합니다.

State Ailas는 모든 상태를 직접 선으로 연결하지 않아도, 특정 상태에서 원하는 상태로 전환할 수 있도록 도와주는 기능입니다.

즉, Idle, Run, Walk처럼 여러 상태에서 각각 Jump로 일일이 연결하지 않아도,

State Alias를 통해 공통적으로 점프 전환을 처리할 수 있어 상태 머신을 훨씬 깔끔하게 구성할 수 있습니다.

State Alias 추가

State Ailas의 사용 방법으로는 먼저 상태 머신에 State Alias를 추가한 뒤, 점프 상태로 연결해줍니다.

이후 오른쪽 Details 패널에서 이 Alias가 어떤 상태들에서 동작할지를 설정할 수 있습니다.

여기서 "어떤 상태일 때만 해당 전환을 허용할지" 체크해주면, 원하는 상태에서만 점프가 가능하도록 재현할 수 있습니다.

예를 들어 Idle, Walk, Run 상태에서는 Jump로 전환되도록 허용하고, 공격 중이거나 피격 상태에서는 점프가 되지 않도록 설정할 수 있습니다.

Door 배치 및 상호작용

문배치를 통한 상호작용에 대해 구현해보겠습니다.

문 구현 영상

문과의 상호작용을 통해 문이 닫히는 기능을 구현할 때,

해당 로직은 개별 문 오브젝트만의 동작이라기보다 현재 월드의 진행 규칙과 연결되는 경우가 많습니다.

그래서 이번 구현에서는 이러한 흐름을 게임의 전반적인 규칙을 관리하는 GameMode에서 다루는 것이 적절하다고 판단했습니다.

구현 순서

1. GameMode에서 레벨 로드와 이벤트 호풀 처리하기

- 먼저 GameMode에서 레벨 로드와 이벤트 호출 처리하기

BP_GameMode Event Graph

2. Door 블루프린트에서 GameStart 이벤트 바인드하기

- 다음으로 Door 블루프린트에서는 GameMode의 GameStart 이벤트에 Bind 합니다.

이후 이벤트가 호출되면 문이 닫히도록 Door의 회전값을 설정합니다.

BP_Door의 Event Graph

3. BP_GameStartActor를 통해 트리거 조건 만들기

- 마지막으로 BP_GameStartActor를 생성하여, 플레이어가 특정 구역에 들어왔는지를 Overlap으로 감지하도록 구성합니다.

해당 엑터와 플레이어가 Overlap 되면 BP_GameStartActor가 GameMode 블루 프린트의 GameStart 이벤트를 호출하고

이 호출을 받은 Door 블루프린트는 회전값을 0으로 변경하여 문이 닫히도록 구현합니다.

BP_GameStarter

UI 추가하기

- 게임의 진행 상태를 플레이어에게 직관적으로 전달하기 위해 UI를 구성해보겠습니다.

언리얼 엔진에서는 User Interface의 Widget Blueprint를 생성한 뒤, 해당 에디터 공간에서 버튼, 텍스트, 이미지와 같은 UI요소를 배치하며 화면을 구성할 수 있습니다.

이번에는 Main Widget을 중심으로 게임의 상태를 관리하도록 구성했습니다.

플레이어가 실패했을 때는 Game Over UI를 띄워 현재 게임이 종료되었음을 알리고, 이 화면에서는 Quit Game 버튼을 통해

게임을 종료할 수 있도록 했습니다.

MainUI_Widget

반대로 스테이지를 클리어 했을 때는 Stage Clear UI를 출력하여 완료 상태를 보여주고, 이 화면에서는 Reset Game 버튼을 통해 게임을 다시 시작할 수 있도록 구성했습니다.

해당 사진에서 그린 빨간색 박스 영역에 대해 설명드리겠습니다.

USER CREATED : 사용자가 직접 만든 위젯 영역

해당 영역에서 자신이 만든 Widget Blueprint를 재사용할 수 있게 모아둔 항목입니다.

해당 항목을 이용하여 제가 만든 UI 3가지를 Main Ui Widget에 넣고 ZOrder를 통해 우선순위를 조절하여 화면에 그릴 예정입니다.

Stage Clear UI Event Graph

KillCount Event Graph

GameOver Event Graph

이제 대략적인 흐름에 대해 설명 드리겠습니다.

전체 구조는 몬스터의 죽음 -> GameMode 판정 -> Player Controller 전달 -> UI 업데이트 순서로 이루어 집니다.

몬스터의 죽음
- 우선 BP_Bear가 사망 상태에 들어가면, 자신의 죽음 상태를 Game Mode에 알리게 됩니다.
GameMode는 이 알림을 받은 뒤 현재 처치 수를 반영하여 킬 수 UI를 업데이트하는 이벤트를 호출하고,
동시에 스테이지 클리어 조건이 충족되었는지 검사합니다.
GameMode 판정
- 이후 처치해야 할 목표 수를 모두 만족했다면, GameMode는 On Stage Clear 이벤트를 호출하여 스테이지
클리어 상태가 되었음을 전달합니다.
하지만 실제로 화면에 UI를 출력하는 역할은 GameMode가 아니라 PlayerController가 담당합니다
PlayerController 전달
- PlayerController에서는 미리 바인딩된 이벤트를 통해 이 신호를 전달받고,
화면에 표시할 UI 클래스(위젯)를 생성하거나 활성화한 뒤, 해당 UI 내부의 Custom Event를 호출하여 필요한
내용을 갱신합니다.
UI 업데이트 - 마지막으로 각 UI 위젯은 자신의 EventGraph에서 이 커스텀 이벤트를 받아 Stage Clear 문구를 띄우거나,
처치 수를 갱신하는 방식으로 최종 화면을 구성하게 됩니다.

구현 영상

NPC 대사 MultiLine 기능

설정 방법

해당 Default 값에 shift + Enter로 줄바꿈을 하면서 대사를 작성할 수 있다.

Blueprint 공부 일기 6 (AI Perception, UI , Billboard , Data Table)

seonhwan2547 — Fri, 20 Mar 2026 10:08:41 +0900

AI Perception

AI Perception은 AI가 주변 환경을 감지하고 상황을 인식하는 시스템이다.

플레이어처럼 입력을 받는 것이 아니라, 시야,소리,피해 등의 정보를 기반으로 행동을 결정하기 위한 감각 시스템 역할을 한다.

BP_Bear에 AI Perception Component 추가하기

AI Perception Component를 추가하는 방법은 일반 Component 추가하는 방법과 같다.

대신 AI Percption이 인식하는 물체들은 AI Perception StimuliSource를 통해 감지될 속성을 고를 수 있다.

물론 없어도 감지된다.

BP_Player에 AI Perception StimuliSource를 추가

그리고 Sight(시야)에 의해 체크 받도록 다음과 같이 설정해준다.

그리고 BP_Bear에서는 Detection by Affiliation에서 Neutrals로 설정해준다.

왜냐하면 Blueprint에서는 Neutrals만 가능하기 때문이다.

Unreal Engine 공식 문서 설명

BP_Bear의 AI Perception 설정

AI를 각각의 데이터로 분해해서 사용하게 해주는 노드

Break AIStimulus는 AI가 감지한 정보(AIStimulus 구조체)를 각각의 데이터로 분해해서 사용할 수 있게 해주는 노드이다.

쉽게 말하면, AI가 감지한 결과를 꺼내서 분석하는 노드이다.

AI Perception을 Debugging 하는 모습

해당 Debugging방법으로는 실행중 어퍼스토리피 키 " ' " 를 입력해주고 Number 키 4번을 눌러주면 해당 정보를 실시간으로 디버깅 할 수 있다.

다음 디버깅 하는 단축키는 Project Settings의 GamePlay Debugger 에 나와있다.

Project Setting Game Debugger

HP UI 제작해보기

Widget Blueprint란?

Widget Blueprint는 게임 화면에 표시되는 UI를 제작하기 위한 비주얼 스크립트 기반 UI 시스템이다.

쉽게 말하면, 플레이어에게 보여지는 모든 UI를 만드는 도구이다.

다음은 Widget Blueprint를 추가하는 방법이다.

Widget Blueprint 추가하기

Widget Blueprint Desginer Editor 창

상단 위의 Designer을 선택하면 해당 UI의 design요소를 건들 수 있다.

그 옆에 있는 Graph를 선택한다면, 해당 UI의 로직을 설정할 수 있다.

Widget Blueprint Graph Editor 창

HP_Bar의 디자인 요소는 간단히 빨간색 네모칸으로 채운다.

Monster의 위에 HP Bar를 설치하고 화면에 나타내보기

UI Widget을 BP_Bear에 Widget을 Component로 추가해주기

그런데 한가지 문제점이 발생한다. 바로 UI의 방향이 카메라의 방향과 연동되어 바뀌지 않으므로,

캐릭터가 몬스터 뒤를 바라보면 HP_Bar가 안 보이는 현상이 발생한다.

그래서 엔진에서 제공하는 Screen 방식을 사용한다면,

Screen 옵션

카메라의 회전에 따라 계속 UI가 보이도록 유지는 되지만,

몬스터가 벽에 가려져 있음에도 불구하고 계속 보이는 현상이 발견되어 문제가 생긴다.

따라서 이러한 부분을 해결하기 위해 Billboard 기법을 자체적으로 기능을 넣어 해결해보려고 한다.

우선, Billboard기법은 카메라의 회전에 따라 물체의 Forward vector가 카메라를 바라보도록 만드는 방법이다.

그러므로 일단 Custom Component로 BP_Billboard라는 Scene Component를 만들어 보겠다.

Scene Component로 만든 이유는 Transform이 있기 때문이다.

BP_Billboard의 Blueprint

해당 Blueprint에서는 Billboard 로직을 구현해볼려고 한다.

카메라의 회전 방향을 얻기 위해서는 Player Controller를 가져온다.

Player Controller는 Control Rotation을 통해 카메라의 회전 정보를 관리하기 때문이다.

해당 Rotation을 매 Tick마다 해당 Component의 회전으로 설정한다.

여기까지 진행한다면, 카메라와 같은 방향의 foward vector를 가지게 되지만, 문제가 생긴다.

바로 이러면 카메라가 여전히 물체를 뒤에서 바라볼 때 물체의 뒷면을 보게 되므로 Culling에 의해 안보이게 된다.

따라서 이제 이 widget에서 z축각도를 180도 회전해주면 된다.

hp bar widget Detail 설정

해당 HP_Bar는 BP_Billboard을 Root로 두면서 하위 자신에서는 z축 으로 180도 회전하면 빌보드 방식이 완성된다.

구현 영상

HP 변경 이벤트 추가 및 HP Bar에 퍼센트 적용

HP가 감소할 때 UI에 이를 반영하기 위해서는 데이터(HP) -> 이벤트 -> UI 갱신 흐름으로 여결해주는 구조가 필요하다.

1. 몬스터가 데미지를 받으면 HP Controller의 Receive Damage Custom Event를 호출하고

BP_Bear에서 데미지를 받았을때 Reveive Damage Custom Event 호출

2. 호출된 이벤트는 HP_Controller에서 다시 이벤트 On Hp Changed 델리게이트 이벤트 (함수포인터) 를 Call한다.

HP_Controller의 ReceiveDamage

3. BP_Bear에서 미리 Bind된 Event On Hp Changed가 실행된다.

BP_Bear에서 On Hp Changed Event에 Bind된 내용

4. 해당 이벤트가 실행되면 우리가 만든 UI WBP_HP Bar의 hp 퍼센트를 조절하기 위해 Update Hp Percent Custom Event를 호출한다.

WBP_HPBar의 이벤트 그래프

5. 호출받은 해당 Custom Event는 다시 percent를 세팅하여 퍼센트 만큼 보이도록 설정하고 죽었을 경우 보이지 않도록 Collapsed 설정을 한다.

몬스터 데이터 도입 ( CSV / 데이터 테이블 )

몬스터의 능력치를 보다 효율적으로 관리하기 위해

Data Table을 활용하여 데이터를 외부에서 관리하는 방식을 적용하였다.

1. 우선 Data Table 사용하기 위해 몬스터의 능력치 정보를 담은 CSV 형식의 파일을 생성한다.

예를 들어 Attack, Defense, WalkSpeed, ChaseSpeed, MaxHp등을 컬럼으로 구성하여 각 몬스터의 데이터를 정리한다.

MonsterData.csv

2. CSV에 정의한 데이터를 Unreal에서 사용하기 위해 해당 값을 담을 구조체(Struct)를 생성한다.

이 구조체는 CSV의 컬럼과 동일한 변수들로 구성되며, 각 데이터 값을 Unreal Engine에서 읽어오기 위한 기반이 된다.

Structure 만들기

Structure에 미리 변수 값과 자료형 타입 지정해주기

3. Data Table 생성

Data Table 생성하기

준비한 CSV 파일을 Unreal Engine 에디터에 Drag and Drop하면 Data Table로 변환할 수 있다.

이때, 앞에서 생성한 구조체를 지정하면 CSV 데이터가 해당 구조체 형태로 매핑되어 Data Table이 구성된다.

4. BP_Bear Blueprint에 BP_MonsterData(Actor Component) 추가 해주기

BP_MonsterData GetCurrentLevel 함수

해당 함수의 변수를 Level Data Category를 만드는 방법은 변수를 추가하고 Default에 있던 부분을 직접 지우고 Level Data로 해당 칸에 타이핑 하면 된다.

변수 추가

여기서 Pure 의 check의미는 실행핀이 없는 함수를 만들 기 위해서이다.

다음으로 Component를 추가해준다 그래야 Monster Data를 BP_Bear에 연결시킬 수 있기 때문이다.

여기서 Get Current Level Data는 Pure이므로 하얀색 실행핀이 없음을 볼 수 있다.

BP_Bear의 Begin Play에서 해당 Level Data 연결시켜 각 능력치를 Data Asset 기준으로 초기화 시켜주기

마지막 작업으로 MonsterData의 현재 Level 및 Data 적용 시켜주기

MonsterData Blueprint 변수 설정

구현 영상

Blueprint 공부 일기 5 ( Pawn Sensing 기반 몬스터 탐지 Behavior Tree, Debug 명령어)

seonhwan2547 — Thu, 19 Mar 2026 14:03:31 +0900

Pawn Sensing Component

오늘은 언리얼 엔진에서 몬스터가 플레이어를 탐지하고 공격하도록 만드는 기능을 구현해보겠습니다.

다음의 빨간색 박스는 Pawn Sensing의 옵션 값을 의미하며,

각 값을 조정함으로써 AI가 플레이어를 인식하는 범위(시야,청각)등을 상황에 맞게 설정할 수 있습니다.

Pawn Sensing이란?

Pawn Sensing은 Unreal Engine에서 AI가 주변의 플레이어(Pawn)을 감지할 수 있도록 해주는 컴포넌트이다.
Pawn Sensing Component는 두 가지 감지 기능을 제공한다.
- Sight ( 시야 감지 )
  - 일정 거리 안에 있는 Pawn을 감지
  - 시야각(Fov)안에 들어와야 감지됨
  - 벽 등에 가려지면 감지 불가
- Hearing ( 소리 감지 )
  - Pawn이 발생시킨 Noise 감지
  - 거리 기반으로 감지 여부 결정

Pawn Sensing을 이용하여 Monster가 Player 감지해보기

Pawn Sensing을 BP_Bear의 Component로 추가하기

BP_Bear에 Pawn Sensing Component 추가

다음으로 OnSeePawn을 Event를 추가해준다.

해당 이벤트는 Pawn Sensing Component가 일정 주기마다 주변을 검사하여, 시야 범위 내에 Pawn이 감지되었을 때 엔진에 의해 자동으로 호출된다.

시야 감지 로직 관련

시야 감지 로직

시야 감지 로직의 순서는 다음과 같다.

1. 현재 몬스터의 State가 현재 Locomotion State 상태 인지 확인한다.

2. Has Tag를 통해 감지된 Pawn이 Player 인지 판별한다.

3. 감지된 대상을 Blackboard의 Object 타입 Key에 참조 형태로 저장한다.

4. 이후 AI 상태를 탐지 상태에 맞게 갱신한다.

몬스터 상태 변경 이벤트(Custom Event UpdateState)

1. 먼저 몬스터의 현재 상태가 Dead 상태인지 확인한다.

2. Dead 상태가 아니라면, Blackboard의 Enum 타입 Key를 State Key의 기본값(Default)으로 초기화 한다.

3. 이후 해당 State 값을 기준으로 Switch 문을 통해 각 상태별 Max Walk Speed를 설정한다.

BehaviorTree 노드 수정

Behavior Tree가 어떻게 수정되었는지 설명해보자면

Blackboard Decorator 추가하기

Blackboard Decorator를 추가하여 Blackboard에 저장된 데이터(변수)들을 통해 조건을 체크하여 해당 시퀀스의 실행 여부를 결정한다.

Blackboard의 어떤 변수를 사용할 지 및 여러 비교 옵션들

Blackboard Decorator의 Detail에 대해 설명해 보고자한다.

Notify Observer : Blackboard 값이 변경될 때 Decorator가 다시 평가되도록 하는 옵션이다.
- On Value Change : Blackboard에 저장된 값 자체가 변경될 때마다 Decorator를 재평가하는 방식이다.
- On Result Change : Blackboard 값의 변화로 인해 조건의 결과(True/False)가 바뀌었을 때만 Decorator를 재평가하는 방식이다.
Observer Abort : 조건이 바뀌었을 때, 현재 실행 중인 Behavior를 중단(Abort)할 범위를 결정하는 옵션
- None : 아무 것도 중단 안함
- Self : 현재 실행 중인 자기 노드만 중단
- Lower Priority : 자기보다 우선순위 낮은 노드들을 중단
- Both : Self의 성격 + Lower Priority 성격 으로 현재 실행중인 노드 중단 + 낮은 우선순위 노드 전부 중단

BlackBoard 의 Tab에서는 Blackboard Key를 설정하고 Key value를 설정해주자.

그리고 조건문을 Key Query에서 조정해 주면 된다.

Dead 상태일 시 발생하는 행동트리의

Monster의 State가 Dead일 때면 몬스터가 죽은 상태이므로 더 이상 행동트리를 바꿔 줄 필요가 없으므로

Notify Observer는 On Result Change로 그리고 Observer aborts는 None으로 설정한다.

Dead 상태에서 다른 행동트리로 옮겨갈 경우가 없기 때문이다.

State가 Chase일 시 발생하는 행동트리

Monster의 상태가 Chase일 시 Attack 상태로 전이될 수 도 있기 때문에 Notify Observer는 On Value Change 혹은 On Result Change 둘 중 하나를 사용해도 문제없다.

다만 Observer aborts에서는 Both를 선택하여 해당 상태가 아니라면 다른 상태로 넘어갈 수 있도록 즉시 중단하도록 설정해야 한다.

State가 Attack일 시 발생하는 행동트리

Monster의 상태가 Attack에서 Chase, Dead 상태로 전이될 수 도 있기 때문에 Notify Observer는 On Value Change 혹은 On Result Change 둘 중 하나를 사용해도 문제없다.

다만 Observer aborts에서는 Both를 선택하여 해당 상태가 아니라면 다른 상태로 넘어갈 수 있도록 즉시 중단하도록 설정해야 한다.

Set State Task Blue Print

여기서는 해당 행동트리가 완료된다면 다음 상태로 전이시켜주기 위해 Blackboard의 Enum 변수 state값과 BP_Bear에 있는 state값을 변경해주기 위해 만든 Task이다.

해당 Task가 끝나면 Finish Execute를 해주는 것을 잊지 말자!

BP_Bear의 Update State(Custom Event)

다음과 같이 BP_Bear에서의 state enum값과 blackboard에서의 enum key값을 통해 접근하여 state값을 바꾸어준다.

(Tmi. 구현 중 발생한 이슈들)

게임 실행 도중 Blueprint의 변수값을 바꿀경우

Health Power의 값을 게임 실행 도중 바꾸었더니 이벤트 Call 호출은 되지만 Bind 해준 Event가 호출이 안되는 에러가 발생했다.

Chatgpt에 물어보니 다음과 같이 대답이다.

오류 발생 원인

다음과 같으니 게임 도중 변수값을 바꾸지 않도록 하자.

몬스터의 패턴 복귀 설정해보기 ( 추적->거리이탈 -> 정찰 복귀 흐름)

몬스터의 경우 플레이어와 너무 멀어지면 플레이어를 계속 쫓아오는 것이 아닌 일정이상 거리가 차이가 난다면,

다시 정찰 페이즈로 넘어가도록 설정해보겠다.

BP_Bear의 Event Graph

Event Graph에서 Event Tick함수를 활용하여 현재 상태에 따라 각각의 함수를 실행하도록 설정하였다.

그 중 Chase 상태일때 플레이어와의 거리가 멀면 다시 Locomotion(정찰)로 넘어가도록 설정해보겠다.

BP_Bear의 OnChase 함수

해당 함수 구현을 살펴보면 플레이어의 위치를 Get Location으로 받아오고 해당 몬스터도 마찬가지로 위치를 가져와

두 벡터의 distance를 계산하여 현재 몬스터와 플레이어 사이의 거리를 구하고 현재 감지되는 pawn Sensing의 반지름보다 떨어진 거리가 더 길다면 현재 Chase state에서 Locomotion으로 변하도록 설정하였다.

구현 영상

Debug할 때 알면 좋은 명령어들

Show Collision

Show Collision을 통해 게임 실행 중에 콜라이더의 상태를 확인할 수 있다.

ShowDebug Collision
- 현재 해당하는 엑터와 충돌되고 있는 정보를 디버깅할 수 있다.
Stat FPS
- 현재 FPS 정보를 알려준다.

Stat Game
- 게임 로직이 실행 되는 시간 (cpu game thread)을 분석하는 명령어

Stat sceneRendering
- 화면을 그리는 과정(Rendering)의 세부 비용을 보여주는 명령어

Blueprint 공부 일기 4 ( 충돌 Channel 및 이펙트, 피격효과, Behavior Tree )

seonhwan2547 — Wed, 18 Mar 2026 10:12:49 +0900

Object Channel 생성 및 Collider 상호작용

오늘은 콜리전 채널 추가 및 충돌 처리에 대해 다뤄보고 아이템 박스와 Player Weapon의 충돌을 시켜보겠습니다.

Collision Channel 설정

Object Channel : "충돌 대상의 타입"

Trace Channel : "Ray Cast시 사용할 필터 기준 "

이제 아이템 박스를 만들어보자

위에서는 PlayerWeapon 과 Item 채널을 추가해주었다.

BP_Box BluePrint Event Graph

다음과 같이 세부 설정을 한다 Object Type은 Item이고 Player Weapon만 충돌 처리를 할 수 있도록 설정하고

Event Graph에서는 원래 해당 Actor가 무엇인지 체크해야하지만 현재는 Player Weapon 하나만 검사하므로 그냥 Get Actor를 통해 받아온다 ( 원래 이러면 안됨!)

이제 박스와 충돌할 PlayerWeapon을 설정해보자

BP_Weapon의 BluePrint

다음과 같이 Item만 충돌 검사를 하도록 설정한다.

마지막으로 아이템과 충돌했을때 아이템이 터지는 이펙트가 나오도록 EventGraph 설정

BP_Box의 Event Graph에서 이펙트 설정

애니메이션 이펙트 추가해보기

Anim notify에 Trail 추가하기

추가하고 이펙트를 출력할 위치를 start와 end 장소 설정하기 ( Effect Start , Effect End )

Effect가 출력될 곳의 부분 설정하기

다시 몽타주로 돌아와서

Trail Detail 설정

Trail이 나올 위치 설정을 Trail notify를 클릭 후 Detail에서 사용할 trail effect와 소켓 위치 설정해주기

파티클 이펙트 추가해보기

Add Notify한 후 Play Particle Effect 추가하기

Particle Effect가 나올 위치 지정 및 이펙트 설정하기

시연 영상

몬스터 추가 및 피격효과 추가해보기

우선 몬스터를 추가해주자

몬스터는 추가하는 과정은 다음과 같다.

Character 클래스를 상속받은 Blueprint 생성
해당 몬스터가 사용할 Animation Blueprint 생성
해당 몬스터의 상태를 나타낼 Enum 자료형 Enumeration Blueprint 만들기
PlayerWeapon과 충돌 체크 및 BP_Weapon에서도 Monster와 충돌 체크하기

해당 작업까지 마쳤으면, BP_Monster의 Animation의 Anim Class를 만들어준 Anmation Blueprint 설정해주기.

몬스터를 추가하기

이제 다음 작업으로는 몬스터가 피격 당했을 시 충돌처리와 충돌 처리를 받았을 때 피격효과를 나타내 볼려고 한다.

우선 해당 몬스터의 Material로 들어가 현재 어떻게 노드 구성이 이루어 졌는지 확인해보자.

Bear Material

다음과 같이 나와있으며, 해당 노드에 이제 피격효과를 주기 위해서

외곽선 효과 추가

Fresnel 효과를 통한 즉 외곽선만 빨간색으로 칠해주는 효과를 주어봤다.

잠시 효과를 확인하기 위해 HitValue의 Default Value을 1로 설정했으므로 다시 0으로 바꾸고 저장하자.

그리고 해당 Material을 Instance로 만들어 Parameter만 쉽게 따로 관리할 수 있도록 하자.

Matreial Instance 생성

Material Instance 에디터 화면

이제 해당 Material을 다시 적용하기 위해 BP_Bear로 돌아가준다.

BP_Bear Event Graph 설정

빨간 박스를 유의 깊에 체크하면서 설정하자.

Paramet Name은 Material에서 설정한 해당 Parameter Name 으로 그리고 Material은 만들어준 Instance로 교체하자

여기서 HitEffect은 Add Timeline을 통해 추가한 Component로 더블 클릭하면 다음과 같은 창이 열린다

Timeline Template

해당 창에서는 이제 Material Parameter에 설정한 HitValue 값을 1에서 0으로 감소하는 그래프를 만들어 줄 것이다 .

해당 점을 추가하는 방법은 마우스 우클릭을 통해 추가해주면 된다.

해당 component는 tick처럼 작동하여 해당 시간동안 계속해서 업데이트 되어 Value 값을 세팅해준다.

구현 영상

몬스터에게 데미지 전달하기

몬스터에게 데미지를 전달하기 위해서는 다음과 같은 순서가 필요합니다

BP_Weapon의 Attack Collision의 OnComponentBeginOverLap 이벤트에서 Apply Damage 이벤트를 통해 데미지를 전달
Apply Damage 이벤트를 받기 위해서는 Event AnyDamage 이벤트를 받아와야 한다.
따라서 데미지를 받을 BP_Bear에 Event Any Damage 노드를 추가
데미지를 받는다면 Monster의 Hp가 깍여야 하므로 몬스터에 Hp Component를 추가 하여 hp를 관리
Hp를 담당하는 Actor Component ( BP_HpController)를 추가한다
BP_Controller에서는 데미지를 받을 시 어떤식으로 hp을 깍을 지 계산하고 hp가 0보다 작다면 Dead 이벤트를 Call한다.

Monster Death 이펙트 ( Dissolve 표현해보기 )

Dissolve Effect를 Material에서 표현하기

일단 Dissolve Effect를 표현하기 위해서는 투명도를 설정하는 기능의 노드를 풀어줘야한다.

그 노드가 바로 Opacity이다.

우선 Opacity Mask를 사용하기 위해 왼쪽 Detail에서 Blend Mode를 Masked으로 바꾼다.

그래서 Opacity Mask 값이 1이면 완전 투명 0이면 불투명으로 바꿔준다.

Material을 조작할 때 편의성을 위해 Parameter화 하기

Matreial을 다룰 때 Conver to Parameter 하여 Material Instance에서 다음과 같이 조절하면서 볼 수 있으니깐 잊지말자!.

위와 같이 노드를 설정하고 나서 BP_Bear에서 다음과 같이 Material Parameter 로직 처리를 진행한다.

BP_Bear Blueprint

Death Effect Timeline

몬스터 행동트리 만들어보기

몬스터 Ai를 만들기 위해서는 3가지가 필요하다

AIController
- Pawn을 조종하는 컨트롤러로 사람이 조종하면 Player Controller 이며 AI가 조종하면 AIController이다.
- 실제 역활로는 Behavior Tree 실행 및 Blackboard 값을 관리한다.
behavior Tree
- 행동을 트리로 나눠서 관리하는 장소
- Root(시작점) 트리 시작 노드로 Blackboard와 연결된다.
- Composite(흐름 제어)로 어떤 행동을 실행할지 결정한다.
  - Sequence ( 순차 실행 ) : 위에서 아래로 순차적으로 실행하며 다 성공해야 원활하게 움직이며 하나라도 실패하면 중단한다.
  - Selector ( 우선 순위 ) : 왼쪽에서 오른쪽으로 조건 체크하면서 가능한 것 하나라도 성공하면 "OK"
  - Task ( 실제 행동 ) : 진짜 실행되는 코드
black board
- AI가 사용하는 공유 변수 저장소 ( 기억 공간으로 메모장으로 생각해도 좋다 )
- 즉, 판단하려면 데이터가 필요한데 이 데이터를 저장하는 곳이 Blackboard 이다.

Behavior Tree를 만들기 위한 3가지 요소 만들기

그 다음 우선 데이터로 사용할 변수들을 blackboard에 만들어 주자

BlackBoard에 key값 생성해주기

이러면 3개의 변수가 생성된다

그 다음으로는 해당 행동 트리를 동작시킬 AIController를 생성해주자

AIController Blueprint 생성하기

우선 Event on Possess를 블록을 만들어준다

Event On Possess란?

AIController가 Pawn(캐릭터)을 점유하는 순간 호출되는 이벤트이다.
즉 AI의 초기화 이벤트라고 보면 될 것 같다

정확히 언제 호출되는가?

레벨 시작 시 (Auto Possess AI)
Spawn된 Pawn을 AlController가 소유할 때
Controller가 Pawn을 바꿔 탈 때

AIController 의 실행 명령 순서

실행 명령 순서는 다음과 같다.

1. Sequnce Then 0 으로 Use Blackboard block을 실행하여 사용할 Blackboard을 설정해준다.

2. Sequnce Then 1 으로 Behavior Tree를 실행 시켜 준다.

3. Sequnce Then 2 으로 Blackboard에사 저장한 Home Location 키값을 통해 해당 변수에 값을 저장해준다.

(반드시 Default 값을 키 값으로 저장할 것 HomeLocation 으로 외부에 보이는 key는 내가 지어준 것 )

4. Sequnce Then 3 으로 Blackboard에서 마찬가지로 저장한 키값을 통해 해당 변수에 값을 저장해준다.

Debug 하고 싶을 때는 해당 BP를 선택 해준다.

오른쪽 상단 위의 빨간 박스에서 디버깅 할 Controller을 설정해 주어야만 Behavior Tree또한 simulate과정이 진행된다.

여기까지가 Blackboard와 AIController을 설정한 것이다.

다음으로는 BehaviorTree을 생성하고 위에서 만든 것을 넣어서 연결해보자

Behavior Tree Blueprint

행동트리 블루프린트를 만들면 일단 Root에서 어떤 Blackboard을 사용할 것인지 선택해주어야 한다.

다음으로는 Sequnce block을 만들어주고 다음으로는 3가지 Task가 있는데 왼쪽부터 살펴보겠다.

Wait Blackboard Time
- 언리얼에서 기본 제공하는 Task 노드로 blackboard에서 시간을 가져온다

Task에 blackboard에 설정한 변수 설정하는 작업

설정한 변수의 시간만큼 대기하다 FinsishExecute를 반환하여 다음 Task을 진행 시키도록 한다.

BTTask_SelectPatrolLocation

해당 Task는 내가 만든 Task Node로 Blueprint 생성에서

Task Blueprint 만드는 과정

다음 메뉴를 선택해주면 된다.

BTTask_SelectPatrolLocation 의 Event Graph

해당 블루프린트에서는 네비게이션을 기반으로 랜덤으로 이동 가능한 위치를 검색하는 Task를 담당한다.

간단하게 HomeLocation을 시작지점을 기준으로 반지름 400인 원의 범위 만큼 주위를 배회하도록 랜덤으로 값을 제공해주는 기능

이다.

Move To Task

Move To Task는 AIController가 Navigation 시스템(NaviMesh)을 기반으로 목표 위치까지의 경로를 계산하고, Pawn의 Movement Component를 통해 해당 위치로 이동시키는 Task이다.

이렇게 하면 간단한 몬스터 AI가 완성되고 적용하는 방법은 다음과 같다.

BP_Bear에 AIController 설정하여 행동트리가 실행될 수 있도록 하기

NaviMesh 설치하는 방법

Navi Mesh 설치하기

다음 사진과 같이 Navi Mesh를 설치하기 위해서는 Place Actors 에 Bolumes를 선택하고 Nav Mesh Bounds Volume를 드래그하면 된다.

드래그 한 후 크기를 넓혀 네비매쉬의 범위를 설정한다

Navi mesh bound volume size 조정후의 모습

해당 네비 매쉬를 바닥에 설치할때는 MainLevel에서 설치해주어야 한다.

또한 해당 사진처럼 영역을 보기 위해서는 Lit 옵션이나 혹은 p를 누르면 볼 수 있다.

Navi Mesh를 생성한 뒤 Build Path 하기

Nav Build Paths를 하는 이유는 네비 매쉬를 배치한 이후 언리얼이 지형을 분석하고 이동 가능한 영역 판별하고 경사 및 장애물 체크를 하고 Nav Mesh를 최종적으로 생성하기 때문이다.

구현 결과

Blueprint 공부 일기 3 ( Player Camera Manager, Animation Montage)

seonhwan2547 — Tue, 17 Mar 2026 14:01:21 +0900

언리얼에서 Player 카메라의 회전 범위를 조절하기 위해서는 Player Camera Blueprint로 범위를 제한할 수 있다.

Player Camera Blueprint 만들기

Player Camera Manager Blueprint의 회전 각도 조절하는 옵션 값들

현재는 위 아래 회전각도인 Pitch값의 범위를 -45도에서 45도 사이로 제한 해 둔 것을 볼 수있다.

이제 해당 Player Camera Manager는 Controller에 적용시키면 게임에 적용된다.

다시 BP_Controller로 돌아가서 설정을 한다.

BP_Controller에서 Player 카메라 매니저 설정하기

공격 애니메이션 넣어보기

(갑작스런 Tmi, AnimInstance에서 Event Graph가 AnimGraph보다 먼저 실행된다.)

공격 애니메이션을 넣기 전에 일단 고민해봐야 할 것들이 있다.

상태를 어디에 넣어줄 지 즉, 캐릭터의 상태를 어느 객체가 관리할 지를 결정해야 한다.

일반적으로는 로직을 담당하는 블루프린트 or C++에서 상태를 관리하는게 일반적이다.

이전 Directx11 프로젝트를 진행할 때 enum값을 통해 상태를 관리함으로써 각 상태에 따른 로직을 명확하게 분리하고

유지보수를 용이하게 만들 수 있었다.

따라서 Unreal Engine에서도 마찬가지로 Enum 기반의 상태 관리 방식을 적용하여 보다 직관적이고 안정적인 캐릭터 상태 관리를 구현하고자 한다.

우선 캐릭터의 상태를 Enum값으로 보관할 Enumeration을 만들자.

Enum 자료형 만들기

해당 Enum 자료형을 열면

Enum 값 설정하기

다음과 같이 Enum 값을 설정해 줄 수 있다.

이제 본격적으로

Character Blueprint Event Graph 작업

Character Class에서 Input_Action 을 가져와서 해당 Input에 입력 ( started = 입력이 들어오는 한 순간)을 체크해서

해당 입력이 들어온다면서 현재 상태를 switch case문으로 분류하고 만약 현재 상태가 Locomotion 이라면 현재 State 를 Battle 로 set 해주는 것을 의미한다.

공격이 끝났을 때 상태 변경

다음은 Customer Event를 통한 공격이 끝났을 때는 다시 상태를 Locomotion으로 설정하는 블루프린트이다.

커스텀 이벤트는 엔진이 호출해주지 않아 어디에선가 직접적으로 호출 해주어야 한다.

해당 Customer Event는 notify가 호출될 때 Animation Blueprint의 EventGrpah에 로직 추가해줘 작동하게 한다.

Animation Blueprint Event Graph

프로젝트를 진행하면서 State 값을 디버깅 해야할 때가 있다.

그럴 땐 다음과 같이 블루 프린트를 디버깅하면 된다. ( F9 = breakpoint 단축키 )

블루 프린트 디버깅하기

Blueprint Debug

Blueprint Debug Window

Notify 이벤트 등록

Animation File Notify 등록

Animation Notify를 사용하는 이유

- 애니메이션 타임라인 상의 특정 시점에 이벤트를 발새시키기 위한 기능이다.

즉, 단순히 애니메이션을 재생하는 것을 넘어 정확한 타이밍에 로직을 실행하기 위해 사용된다.

(예를 들어, 공격 모션 중 칼이 적에게 닿는 순간, 발이 땅에 닿는 순간, 스킬이 발동되는 타이밍 기타 등등 )

Notify 이벤트가 호출을 가져오는 방법

Animation Blueprint EventGraph

Animation Noitfy를 가져오는 방법

다음과 같이 Animation notify가 호출되면 다음과 같이 실행되도록 처리할 수 있다.

Montage 와 일반 Animation 시스템 차이 정리

State Machine 기반 Animation

State Machine은 조건(상태)에 따라 애니메이션을 전환한다.
상태가 변경되면 현재 애니메이션과 관계없이 즉시 다음 상태의 애니메이션으로 전이된다.

즉, 상태 변화가 곧 애니메이션 변경이다.

Montage

Montage는 State Machine과 독립적으로 재생된다.
Slot을 통해 최종 애니메이션 위에 덮여씌워지는 구조로 동작한다

따라서

상태가 Idle -> Run으로 바뀌더라도 Montage는 영향을 받지 않고 계속 재생된다.

즉, 상태와 무관하게 재생이 유지된다.

왜 Montage는 끊기지 않는가?

State Machine은 상태 기반 -> 즉시 전이됨
Montage는 명령 기반 -> 한 번 실행되면 유지됨

그래서 State 변화로 인해 애니메이션이 중간에 끊기는 일이 발생하지 않는다.

Montage를 실행하는 방법

Montage을 넣은 Character Blueprint

AnimGraph안의 Battle State

Character Blueprint에서 Montage Animation을 실행하면서 State안에서는 현재 실행되고 있는 애니메이션 포즈와 현재 시간의 몽타주 포즈를 블랜드(A자세에서 B자세로 섞는거 즉 자연스럽게 애니메이션을 전환하기 위한 보간 작업이라고 보면 된다) 하여 진행하면서 애니메이션을 실행시킨다

블랜딩 하는 시간은 따로 설정 값을 통해 조정할수있다.

몽타주 애니메이션을 이용한 콤보 공격 구현 방법

Montage Combo Attack Section

각 Montage의 Section 마다 마우스 클릭을 통한 Attack의 모션을 바꿀려고 한다.

해당 작업을 하기 위해서는 일단 마우스 좌클릭으로 인한 콤보 Attack의 넘버링을 바꿔줄려고 한다.

Character Blueprint 에서 Montage Section name 구분 짓기

Weapon을 캐릭터에 붙히는 방법 2가지

1. Socket에 Weapon을 붙혀넣기

Weapon position을 preview로 미리 붙혀넣어서 해당 위치 확인하기

해당 화면은 해당 모델의 skeleton으로 들어가면 확인할 수 있다.

Character Mesh의 하위에 Skeletal Mesh Component를 추가하여 무기를 부착

해야할 것으로는 무기 위치에 해당할 Parent Socket 값 넣기 그리고 매쉬 Asset 추가하기

2. 이벤트 방식으로 ( 칼과 충돌했을 때 플레이어와 붙히기 )

이벤트 방식으로 칼을 획득하게 하기 위해서는 다음과 같은 과정이 필요하다.

무기에 Collider Componnet를 부착하여 충돌 속성을 부여하고 해당 충돌 발생 이벤트를 OnComponent Begin Overlap를 사용하여 충돌한 Actor 객체를 가져와서 해당 Actor의 custom Event를 호출한다.

BP_Weapon Event Graph Blueprint

BP_Character Event Graph Blueprint

Socket Name : 부착할 위치를 지정하는 곳 ( 캐릭터의 Bone 또는 Socket 이름을 사용한다 )
Location Rule : 부착 시 대상 컴포넌트의 위치를 어떤 기준으로 맞출지 결정하는 규칙
Rotation Rule : 부착 시 회전을 어떤 기준으로 적용할지 결정하는 규칙
Scale Rule : 부착 시 스케일을 어떤 기준으로 유지 또는 적용할지 결정하는 규칙

각 Rule에 적용되는 옵션들

Keep Relative : 기존 상대 위치 유지
Keep World : 월드 위치 유지
Snap to Target : 대상 위치에 정확히 맞춤

구현

특정 순간에만 Collider를 On/Off 구현

다음과 같은 과정으로 구현할 예정이다.

1. Animation Notify 발생

공격 애니메이션 타임라인에 설정된 Notify가 호출된다.

2. AnimBlueprint Event Graph에서 처리

해당 Notify 이벤트를 수신한다
현재 애니메이션을 재생 중인 Pawn을 가져온 뒤, Character로 캐스팅 한다.

3. Character로 이벤트 전달

캐릭터의 Custom Event를 호출한다 ( BP_Character의 OnAttackCheckBegin, BP_Character의 OnAttackCheckEnd )

4. Weapon Mesh로 전달

캐릭터는 자신이 소유한 Weapon Mesh에 접근하여 Weapon의 Custom Event를 호출한다. ( BP_Weapon의 OnAttackCheckBegin, BP_ Weapon의 OnAttackCheckEnd )

우선 Animation notify를 사용하여 어느 애니메이션 key frame에 Collider을 키고 어느 key Frame에 Collider를 끌 지를

각각 notify 이름으로 "AttackCheckBegin" , "AttackCheckEnd"으로 설정합니다.

Animation Montage에 notify를 추가

주의할 점으로는 ComboCheck 뒤에 notify를 설정하면 jump section하면서 notify가 호출이 안될 수 있기 때문에 앞에다가 설정하도록 하자.

Animation Blueprint

다음과 같이 Animation Event Graph를 설정하여 Anim notify를 호출 받으면 Character의 Custom Event를 호출하도록 한다.

Character Event Graph에서 BP_Weapon의 Custom Event 호출하기

BP_Weapon의 Attack Collider On/Off 제어

위에서 주의 깊게 봐야할 것은 바로 Set Collision Enabled의 New Type의 속성으로

No Collision
- 충돌을 전혀 수행하지 않음
- 물리 충돌 및 충돌 검사( = 트레이스 ) 모두 비활성화
Query Only
- 물리적인 충돌 반응은 없지만 충돌 검사 ( 트레이스 , 오버랩 등)는 가능
- 즉, 실제로 부딪히지는 않지만, 충돌 판정은 체크할 수 있는 상태

EVENT DISPATCHERS 사용해보기

Event Dispatcher는 Blueprint에서 사용하는 Delegate 입니다.

Delegate란?

- 함수 포인터의 확장 개념으로 이벤트를 등록하고 호출하는 시스템 입니다. ( 옵저버 패턴! )

Bind -> 이벤트 연결

Call -> 이벤트 실행

무기 줍는 이벤트

무기 줍는 이벤트에 공격 판정 시작 및 종료 이벤트 함수를 연결(Bind) 하는 과정

전체 구조

이벤트를 Call(실행) 하는 과정

Blueprint 공부 일기 2 (플레이어 움직임 및 애니메이션, Level Streaming)

seonhwan2547 — Mon, 16 Mar 2026 12:48:20 +0900

오늘은 플레이어의 움직임을 블루프린트로 구현해보겠습니다.

플레이어 생성 및 입력 처리

플레이어가 움직이기 위해서는 단순히 위치를 이동시키는 것뿐만 아니라,

컨트롤러(Controller), 입력 처리(Input), 그리고 Movement Component와 같은 요소들이 함께 필요합니다.

먼저 기본적인 구조를 이해하기 위해 Pawn을 생성하여 간단한 이동을 구현해보고,

이후 보다 확장된 기능을 제공하는 Character 클래스를 활용하여 움직임을 제어해보겠습니다.

우선 플레이어의 움직임을 구현하기 위해서는 입력 처리 과정이 필요합니다.

이를 위해 먼저 Input Action과 Input Mapping Context를 생성해보겠습니다.

Input Action (Move)

위에서 생성한 Input Action은 어떤 입력 값을 받아올지 정의하는 Data Asset으로, 이번 예제에서는 키보드 입력(WASD)을 처리하기 위해 Value Type을 Axis 2D(Vector2D)로 설정하였습니다.

이를 통해 W,A,S,D 입력을 각각 하나의 벡터 값으로 받아와, 플레이어의 이동 방향을 보다 직관적으로 제어할 수 있도록 구성했습니다.

Input Mapping Context ( IMC_Game)

위에서 생성한 IMC_Game은 Input Mapping Context로, 앞서 선언한 IA_Move(Input Action)에 대해 어떤 키 입력이 어떤 축 값(X,Y)으로 들어갈지 정의하는 역할을 합니다.

즉, IMC는 단순히 키를 등록하는 것이 아니라

입력값을 하나의 방향 데이터 (Vector2D)로 변환해주는 관리 역할을 한다고 볼 수 있습니다.

계속해서 살펴보면,

키보드 입력은 기본적으로 0 또는 1의 1차원 값으로 들어오기 때문에 이 단계에서 어떤 값이 X축인지, Y축인지 직접 매핑해주어야 합니다.

이를 위해 Swizzle Input Axis을 사용하여 입력 값을 원하는 축으로 재배치해줍니다.

예를 들어,

W/S 입력을 Y축으로 사용하고 싶다면 Swizzle을 통해 해당 값을 Y축으로 전달하도록 설정합니다.

(Tmi. 입력은 기본적으로 PlayerController에서 처리된 후 Pawn으로 전달되는 구조입니다.

따라서 입력을 Controller에서 직접 처리할 수도 있고, Pawn(또는 Character)에서 처리할 수도 있으며, 프로젝트 구조에 맞게 적절한 위치를 선택하여 구현할 수 있습니다.)

BP_Pawn Event Graph

다음으로는, 앞서 설정한 입력을 실제로 받아 움직일 캐릭터를 구현해보겠습니다.

캐릭터가 이동하기 위해서는 Movement Component가 필요하며,

이번 예제에서는 중력의 영향을 받지 않는 FloatingPawnMovement를 추가하여 기본적인 이동을 구현하엿습니다.

(Tmi, 만약 이동처리를 offset을 이용해 한다면 충돌처리가 되지 않는다.)

BP_GameMode

다음으로는, 앞서 생성한 IMC(Input Mapping Context)과 플레이어를 실제 게임에 적용하기 위해 GameMode Blueprint를 설정해보겠습니다.

GameMode는 해당 월드에서 사용할 기본 클래스(플레어어, 컨트롤러 등)를 결정하는 역할을 합니다.

따라서 월드 설정에서 Game Mode를 BP_GameMode로 지정해주어야 우리가 설정한 입력 시스템과 플레이어 로직이 정상적으로 작동하게 됩니다.

플레이어 애니메이션 동작

이제 플레이어(캐릭터)를 만들고 플레이어 에 애니메이션을 적용하여, 단순한 이동 구현을 넘어 실제 게임과 같은 형태로 확장해보겠습니다.

BP_Character Viewport

우선 플레이어에 기본적으로 추가된 Component를 살펴보자

Capsule Component : 캐릭터의 충돌을 담당하는 컴포넌트
Arrow Component : 캐릭터의 Forward 방향(전방 방향)을 나타내는 기준
Character Movement : 플레이어의 이동 및 물리 동작을 처리하는 컴포넌트

이제 플레이어를 화면에 비추기 위해 카메라 설정이 필요합니다.

이를 위해 Add 버튼을 통해 Spring Arm을 추가하고, 해당 Spring Arm 끝에 Camera를 부착하여 플레이어를 따라다니는 카메라를 구성합니다.

Player Event Graph

다음은 플레이어에 전달된 입력 값을 실제 이동으로 처리하는 Event Graph 입니다.

입력 값은 Vector2D로 전달되기 때문에, 이를 각각 분리하여 앞/뒤 이동(Y축) 과 좌/우 이동(X축)에 사용합니다.

이후 각 축의 값을 Add Movement Input 노드에 전달하여 플레이어가 입력 방향에 맞게 이동하도록 구현합니다.

하지만, 이렇게 구현하면 플레이어는 단순히 이동만 하고 방향은 바뀌지 않는 문제가 발생합니다.

따라서 이번에는 카메라 기준으로 회전까지 함께 적용해보겠습니다.

회전을 추가한 노드

회전을 적용하기 위해 사용하는 핵심 노드는 Get Control Rotation 입니다.

Get Control Rotation이란? → 현재 카메라(컨트롤러)가 바라보는 방향(회전값)을 의미합니다.

즉, 언리얼 엔진의 기준 축으로 부터 현재 카메라의 회전량을 의미합니다.

입력값은 보통 다음과 같이 나뉩니다.

X 입력 (A/D) → 좌/우 이동
Y 입력 (W/S) → 앞/뒤 이동

이를 처리하기 위해

X 입력 → 카메라의 Right Vector 사용
Y 입력 → 카메라의 Yaw 값을 기반으로 Forward Vector 생성

여기서 Get Right Vector/ Get Foward Vector는 해당 주어진 회전값을 기준으로 해당 방향의 벡터를 생성해주는 노드입니다.

Spring Arm의 Camera Setting 체크하기

Use Pawn Control Rotation을 체크 안하면 카메라가 Control Rotation을 따라가지 않으므로

마우스가 움직임으로써 Controller 회전

위와 같은 노드에서 Control Rotation이 따라가지 않게 된다.

따라서 체크한다면

마우스 움직임 → Control Rotation 변경 → Spring Arm 회전 → 끝에 달린 카메라도 자연스럽게 회전

이런 흐름으로 작동하게 된다.

다음은 플레이어 애니메이션에 대해 조금 다뤄보겠습니다.

플레이어의 애니메이션은 보통 AnimInstance에서 관리합니다.

AnimInstance의 Evenet Graph 역할

→ 캐릭터의 상태(속도,점프 여부 등)를 기반으로 어떤 애니메이션을 재생할지 판단하기 위한 값을 업데이트하는 역할

(즉, 애니메이션에 필요한 변수들을 계산하는 곳 )

AnimInstance의 AnimGraph 역할

→ AnimGraph는 Event Graph에서 계산된 값을 기반으로 실제 애니메이션을 조합하고 최종 포즈를 만들어 출력하는 역할을 한다.

(주로, 다음애니메이션과 현재 애니메이션 사이 보간 시간 및 보간 그래프 조절 및 상태 값을 통한 애니메이션 변경 작업을 한다.)

Level Streaming이란?

Level Streaming은 하나의 큰 맵을 여러 개의 Level로 나누고, 필요한 부분만 실시간으로 로드/언로드하는 기능입니다.

Level Streaming은 왜 필요한가?

게임에서 맵이 커지면 커질수록 발새앟는 문제로 다음과 같은 경우들이 있다.

- 한 번에 모든 맵을 로드 -> 메모리 과다 사용

- 로딩시간 증가 -> 끊김 현상 발생

- FPS 저하

이러한 이유로 Unreal에서는 Level Streaming을 사용한다.

Level Streamming 자료

다음과 같은 Level Streamming을 만들기 위해서는 3개의 Level이 필요하다

Persistent Level은 전체 맵을 의미하며 그 이후로 SubLevel01, SubLevel02은 각각 나눠진 레벨 구조이다.

Levels UI 추가하는 방법

Levels 추가하면 다음과 같이 Level 구조를 확인할 수 있는 UI가 생성됩니다.

이후 원하는 Level을 Drag & Drop으로 추가하면 Sub Level 구조를 구성할 수 있습니다.

이번에 구현할 Level Streaming 방식

1. 특정 지점을 기준으로 로딩 (Trigger 방식)

→ 플레이어가 특정 경로를 지나갈 때 SubLevel02를 로딩하는 방식

Trigger Volume을 이용하여 구현
이벤트 기반 (플레이어 진입 시 로드, 즉 특정 조건 만족 시 발동)

Trigger Volume 추가하는 방법

해당 방식을 추가하기 위해서는 해당 맵을 클릭후 왼쪽 Place Actor 창에서 Volumes 항목에서 Trigger Volume을 추가하면 된다

TriggerVolume을 추가한 모습

MainLevel의 BluePrint 여는 방법

BluePrint에 Actor 넣는 방법

MainLevel의 BluePrint Event Graph

해당 방법은 Cpp로는 작성할 수 없고 오직 블루프린트로만 가능한 기능으므로 잊지말고 알고있자.

적용 후 모습

2. 카메라 위치 기반 로딩 (Level Streaming Volume 방식)

→ 카메라의 위치에 따라 자동으로 SubLevel02를 로딩을 OnOff하는 방식

Level Streaming Volume 사용
영역 기반 자동 로딩 ( = 위치 기반 자동 로딩으로 영역 진입 시 발생 )

Level Streaming Volume 추가하는 방법

LevelStreamingVolume이 추가된 모습

LevelStreamingVolume을 적용

Level streaming을 적용한 모습

(Tmi. 블루프린트로 맵을 로드 할때 잊지 말아야 할 것!)

(Tmi+. 그림자가 이상하게 남겨질때 virtual shadow -> shadow map으로 변경하면 해결!)

Blueprint 공부 일기 1 ( 오브젝트 생성 및 충돌 상호작용 )

seonhwan2547 — Fri, 13 Mar 2026 18:28:27 +0900

Level에 Object를 생성 및 Blueprint란?

Blueprint란?

- 언리얼 엔진에서 제공하는 비주얼 스크립팅 시스템으로, 노드를 연결해 로직을 구현하는 클래스 기반 시스템이다.

C++ 코드를 작성하지 않고도 게임 로직, 이벤트, 동작 등을 구현할 수 있다.

Object를 Level에 생성하는 방법

- 이번 과정에서는 블루프린트만 이용해서 오브젝트를 레벨에 배치 해보겠습니다.

Blueprint 생성

parent class를 actor로 지정

Actor로 지정한 이유는 움직이지 않을 고정 객체이며 controller를 이용하지 않을 객체이기 때문입니다.

생성하고 클릭하여 blueprint editor 창을 활성화 시킵니다.

editor 창 화면

왼쪽 Component 부분부터 살펴보겠습니다.

DefaultSceneRoot : 최상위 노드인 루트 노드로 빈 루트 컴포턴트입니다.

여기서 오브젝트와 플레이어가 상호작용하기 위해 Collider Component로 Box Collider와 해당 Collider의 위치를 표현해줄

Cube Box를 추가해줍니다.

추가 방법은 간단히 왼쪽 상단 위 "Add" 버튼을 클릭후 추가해주시면 됩니다.

다음과 같이 진행되며 Compile 후 이제 게임 로직을 다루기 위해 EventGrpah를 살펴보겠습니다.

event Graph

Event Graph에 있는 내용을 살펴보겠습니다.

Event BeginPlay : 오브젝트가 생성되고 나서 게임로직이 실행되기 전에 최초 1번 실행되는 이벤트 입니다

Event ActorBeginOverlap: 오브젝트의 Collider가 플레이어와 겹칠 때 최초 1번 발생하는 이벤트 입니다.

Event Tick: 매 프레임의 Tick마다 호출되는 이벤트 입니다.

여기서 우리는 Overlap을 이용해 간단히 Debug로 게임 실행 viewport에 메세지를 띄어 상호작용을 확인해보고자 합니다.

print string을 이용한 디버깅

언리얼에는 3개의 문자열 자료형이 있습니다.

- Name : 해시(Hash)기반 구조로 관리되는 타입으로, 이미 로드된 리소스나 객체의 이름을 빠르게 비교하교 참조하기 위해 사용됩니다. 내부적으로 해시 알고리즘을 사용하기 때문에 평균적으로 O(1)의 시간 복잡도로 이름 비교 및 조회가 가능하여 성능에 유리합니다.

- String : 일반적인 문자열 데이터를 저장하기 위한 타입으로, 문자열의 생성, 수정, 가공 등에 주로 사용됩니다.텍스트 처리나 데이터 저장과 같은 일반적인 문자열 작업에 적합한 타입입니다.

- Text : 사용자에게 표시되는 UI 문자열을 위한 타입입니다. 다국어를 지원하며, 게임 내 표시되는 텍스트나 UI 문구와 같이 번역이 필요한 문자열을 처리할 때 사용됩니다.

여기서는 간단히 디버깅용으로 문자를 띄울 것이므로 String 자료형을 사용하겠습니다.

Collision 된 상황

사진의 왼쪽 상단 위에 "Collision Enter" 문구가 뜬 것을 확인 할 수 있습니다.

다음으로는 충돌함으로써 Box에 색깔이 변하고 다시 충돌이 해제되면 원래 색으로 돌아가도록 만들어 보겠습니다.

그렇게 하기위해선 일단 해당 박스 Material 부분을 생성해주어야 합니다.

material

여기서 해당 Constant 노드는 " 마우스 LButton + 3 " 단축키를 통해 간단히 만들 수 있습니다.

단일 vector value는 " 마우스 LButton + 1 " , Lerp 도드는 " 마우스 LButton + L " 으로 만들 수 있습니다.

Lerp 노드는 A의 값에 따라

Lerp 계산식

다음과 같이 결과를 Base Color ( = Diffuse Color) 로 나타냅니다.

따라서 충돌하기전의 색깔은 "빨간색" 충돌한 후에는 "파란색"으로 나타낼 결과를 만들 예정입니다.

Box Event Graph

다음과 같이 Set Scalar Parameter Value 노드를 추가합니다. ( alpha 는 값이 1개이므로 Sclar로 합니다.)

그리고 "Parameter Name"은 반드시 Material에서 설정한 alpha 노드의 변수명과 똑같게 합니다.

충돌을 한다면 "Parameter Value"가 1이 되도록 해당 값을 1로 작성합니다.

실행 결과

이제 한 단계 더 나아가 충돌이 해제되면 다시 색깔이 원상태로 돌아가도록 만들겠습니다.

event graph

여기서는 이제 Event ActorEndOverlap Event 노드를 추가해줍니다.

해당 노드는 해당 오브젝트와 플레이어가 Overlap 겹침이 해제될 때 호출되는 이벤트입니다.

실행 결과

다음은 캐릭터와 박스가 충돌할 시 캐릭터를 위로 날려 보내 보겠습니다.

Obejct Punch Event Graph

우선 이전에 만든 박스 오브젝트를 복사하여 새로 추가한다.

이름을 BP_Punch로 바꾸고 Blueprint Event Grpah로 들어가 로직을 변경한다.

(Tmi 1: 노드를 끊을 때는 "alt"로 연결을 끊을 수 있다는 것을 알면 편하다.)

(Tmi 2: 어떠한 노드의 그룹인지 표시하고 싶으면 해당 노드들을 연속적으로 클릭 후 "C" 클릭 을 통해 다음과 같이 이름을 지을 수 있다.)

플레이어의 움직임을 제어해야 하므로 Cast 노드를 추가하여 Character로 casting한 후 노드 줄 뽑은 상태에서 Add Impulse를 추가하면 된다.

다음과 같이 노드 이은 상태에서 추가

혹시 잊을까봐 사진으로 남긴다.

그 후 impulse 부분에 어떤 방향으로 플레이어를 날릴 지 sclar 값을 적어준다.

잊지 말아야 할 것이 Vecloity Change를 체크 할 것! ( 질량을 무시안하면 땅에 그대로 있기 때문에 즉시 질량을 무시하고 속도에 영향을 받게 하기 위해서)

실행 결과

다음은 해당 플레이어를 위로 날려버리는 이벤트 후 해당 박스를 제거하고 제거하는 동시에 이펙트가 나오도록 처리해보겠습니다.

Event Graph

이펙트가 나오게 하기 위해서 "Spawn Emitter at Location" 노드를 추가하고, 이펙트가 나올 장소를 Get Actor Location 노드를 추가함으로 써 위치를 지정해 줍니다.

그 후 Destroy Actor 노드를 통해 해당 오브젝트를 삭제합니다.

실행 결과

다음은 이전에 만들었던 Object에 겹칠 때 해당 박스가 서서히 색을 변경되도록 만들어 보겠습니다.

AlphaToOne Event Graph

알파값을 서서히 변화시키기 위해서는 AlphaToOne의 노드가 추가되어야 합니다.

해당 노드를 살펴보면

AlphaToOne Node

다음과 같이 해당 값의 변화량을 조절할 수 있는 창이 나오며 "Linear, Constant" 등 그래프의 모양을 설정해 줄 수 있습니다.

다음은 teleport를 구현해보겠습니다.

Teleport Node

다음과 같이 Teleport Node를 설정해주고 해당 텔레포트 할 위치에 플레이어를 어떤 회전량과 위치를 두고 설정할 지 노드를 연결해주면 된다.

Data_Asset 및 Quater View, Shoulder View 구현

seonhwan2547 — Thu, 26 Feb 2026 15:20:10 +0900

Data Asset이란?

Data Asset은 게임 로직과 데이터를 분리하기 위해 사용하는 데이터 전용 객체입니다.

Data Asset 생성 방법

다음과 같이 Data Asset을 생성할 수 있습니다.

Data Asset이 필요한 이유

Character BluePrint

Character BluePrint의 오른쪽 Details 패널에서는 다양한 속성 값을 직접 설정할 수 있습니다.

하지만 모든 값을 블루프린트에 의존하기보다는, C++ 기반 Data Asset을 통해 필요한 데이터만 분리하여 관리할 수 있습니다.

이를 통해 데이터와 로직을 분리하고 보다 구조적으로 속성 값을 관리할 수 있습니다.

c++로 만든 Shoulder View Data Asset

- Use Controller Rotation Yaw : 카메라의 좌우 방향에 맞춰 캐릭터도 함께 회전할 지를 결정

- Orient Rotation Movement : 캐릭터가 입력방향을 바라보도록 자동 회전 시키는 옵션

- Rotation Rate : 회전 속도

- Target Arm Length : 카메라 암과 캐릭터 사이의 거리

- Releative Rotation : 카메라가 플레이어를 향해 몇도 기울어져서 바라볼 것인지를 결정

- Use Pawn Control Rotation : Pawn 안에 있는 특정 컴포넌트 (SpringArm, Camera 등)가 Pawn의 ControlRotation(= Controller의 회전값)을 사용할 지 정하는 옵션.

- Do collision Test : SpringArm이 카메라와 Pawn 사이에 장애물이 있으면 카메라를 앞으로 당겨주는 기능.

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "ABCharacterControlData.generated.h"

/**
 * 
 */
UCLASS()
class RESTUDY_API UABCharacterControlData : public UPrimaryDataAsset
{
	GENERATED_BODY()

public:
	UABCharacterControlData();

	UPROPERTY(EditAnywhere, Category = Pawn)
	bool bUseControllerRotationYaw = false; // Control Rotation의 Yaw값만 체크할지 안할지


	UPROPERTY(EditAnywhere, Category = CharacterMovement)
	bool bOrientRotationMovement = false;

	UPROPERTY(EditAnywhere, Category = CharacterMovement)
	bool bUseControllerDesiredRotation = true;

	UPROPERTY(EditAnywhere, Category = CharacterMovement)
	FRotator RotationRate;
	
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Input)
	TObjectPtr<class UInputMappingContext> InputMappingContext; 

	UPROPERTY(EditAnywhere, Category = SpringArm)
	float TargetArmLength;

	UPROPERTY(EditAnywhere, Category = SpringArm)
	FRotator RelativeRotation; 

	UPROPERTY(EditAnywhere, Category = SpringArm)
	bool bUsePawnControlRotation = false; 

	UPROPERTY(EditAnywhere, Category = SpringArm)
	bool bInheritPitch = false;
	
	UPROPERTY(EditAnywhere, Category = SpringArm)
	bool bInheritYaw = false; 

	UPROPERTY(EditAnywhere, Category = SpringArm)
	bool bInheritRoll = false;

	UPROPERTY(EditAnywhere, Category = SpringArm)
	bool bDoCollisionTest = false; 
	
};

Quater View란?

- 캐릭터를 대각선 위쪽에서 내려다보는 시점을 의미합니다.

QuterView의 모습

Quter View를 만들기 위해서는 다음과 같은 옵션 설정이 필요합니다.

- Camera는 플레이어를 45º ~ 50º 사이의 각도로 기울여진 각도에서 내려다보도록 배치합니다.

- 플레이어와의 거리를 확보하기 위해 Camera Boom(SpringArm)의 길이를 충분히 길게 설정합니다.

- 카메라의 Look(회전)은 플레이어 입력에 따라 조작되지 않도록 하여, 고정된 시점(Fixed View)을 유지합니다.

QuaterView Data Asset

Shoulder View란?

- 플레이어의 어깨 뒤쪽에서 캐릭터를 따라가며 바라보는 3인칭 시점 카메라 구조

Sholuder View 모습

Shoulder View 를 만들기 위해서는 다음과 같은 옵션 설정이 필요합니다.

- 카메라는 플레이어의 어깨 뒤쪽 위치에 배치하여 캐릭터를 등 뒤에서 바라보는 구도를 만든다.

- 플레이어와의 거리를 확보하기 위해 Camera Boom(SpringArm)의 길이를 충분히 길게 설정합니다.

- 카메라의 Look(회전)은 플레이어의 전방(Forward) 방향을 결정하는 기준이 되며, 입력에 따라 카메라가 회전하고,

그 방향을 기준으로 캐릭터가 움직이도록 구성한다.

Shoulder View Data Asset

생성한 데이터셋을 Input Mapping에 연동하여 카메라 시점 변환 구현

// Fill out your copyright notice in the Description page of Project Settings.


#include "Character/ABCharacterPlayer.h"
#include "Camera/CameraComponent.h"
#include "GameFramework/SpringArmComponent.h"
#include "InputMappingContext.h"
#include "EnhancedInputComponent.h"
#include "EnhancedInputSubsystems.h"
#include "Character/ABCharacterControlData.h"




AABCharacterPlayer::AABCharacterPlayer()
{
	//Camera 
	CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
	CameraBoom->SetupAttachment(RootComponent);
	CameraBoom->TargetArmLength = 400.0f; 
	CameraBoom->bUsePawnControlRotation = true; 


	FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
	FollowCamera->SetupAttachment(CameraBoom, USpringArmComponent::SocketName);
	FollowCamera->bUsePawnControlRotation = false; 

	//Input
	//static ConstructorHelpers::FObjectFinder<UInputMappingContext> InputMappingContextRef(TEXT("/Game/Input/IMC_Default.IMC_Default"));
	//
	//if(InputMappingContextRef.Object)
	//{
	//	DefaultMappingContext = InputMappingContextRef.Object;
	//}

	static ConstructorHelpers::FObjectFinder<UInputAction> InputActionJumpRef(TEXT("/Game/Input/Actions/IA_Jump.IA_Jump"));

	if (InputActionJumpRef.Object)
	{
		JumpAction = InputActionJumpRef.Object;
	}

	
	static ConstructorHelpers::FObjectFinder<UInputAction> InputChnageActionRef(TEXT("/Game/Input/Actions/IA_ChangeControl.IA_ChangeControl"));
	if(nullptr!= InputChnageActionRef.Object)
	{
		ChangeControlAction = InputChnageActionRef.Object;
	}
	
	
	static ConstructorHelpers::FObjectFinder<UInputAction> InputActionShoulderMoveRef(TEXT("/Game/Input/Actions/IA_ShoulderMove.IA_ShoulderMove"));
	if (nullptr != InputActionShoulderMoveRef.Object)
	{
		ShoulderMoveAction = InputActionShoulderMoveRef.Object;
	}
	
	
	static ConstructorHelpers::FObjectFinder<UInputAction> InputActionShoulderLookRef(TEXT("/Game/Input/Actions/IA_ShoulderLook.IA_ShoulderLook"));
	if (nullptr != InputActionShoulderLookRef.Object)
	{
		ShoulderLookAction = InputActionShoulderLookRef.Object;
	}
	
	
	static ConstructorHelpers::FObjectFinder<UInputAction> InputActionQuaterMoveRef(TEXT("/Game/Input/Actions/IA_QuaterMove.IA_QuaterMove"));
	if (nullptr != InputChnageActionRef.Object)
	{
		QuaterMoveAction = InputActionQuaterMoveRef.Object;
	}

	CurrentCharacterControlType = ECharacterControlType::Quater;


}

void AABCharacterPlayer::BeginPlay()
{
	// 입력 매핑 컨테스트를 할당하는 역할 ( 키보드로 입력받을지,  다른 플랫폼으로 입력받을지등)
	
	Super::BeginPlay();

	SetCharacterControl(CurrentCharacterControlType);

	//APlayerController * PlayerController = CastChecked<APlayerController>(GetController());


	//if (ULocalPlayer* LocalPlayer = PlayerController->GetLocalPlayer())
	//{
	//	if (UEnhancedInputLocalPlayerSubsystem* SubSystem =
	//		ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(LocalPlayer))
	//	{
	//		SubSystem->AddMappingContext(DefaultMappingContext, 0);
	//	}
	//}

	





}

void AABCharacterPlayer::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
	// 언리얼 엔진 입력시스템에서 액션 함수를 매핑시켜주는 곳 

	Super::SetupPlayerInputComponent(PlayerInputComponent);

	UEnhancedInputComponent* EnhancedInputComponent = CastChecked<UEnhancedInputComponent>(PlayerInputComponent);

	EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Triggered, this, &ACharacter::Jump);
	EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Completed, this, &ACharacter::StopJumping);
	EnhancedInputComponent->BindAction(ChangeControlAction, ETriggerEvent::Triggered, this, &AABCharacterPlayer::ChangeCharacterControl);
	EnhancedInputComponent->BindAction(ShoulderMoveAction, ETriggerEvent::Triggered, this, &AABCharacterPlayer::ShoulderMove);
	EnhancedInputComponent->BindAction(ShoulderLookAction, ETriggerEvent::Triggered, this, &AABCharacterPlayer::ShoulderLook);
	EnhancedInputComponent->BindAction(QuaterMoveAction, ETriggerEvent::Triggered, this, &AABCharacterPlayer::QuaterMove);
	
}

void AABCharacterPlayer::ChangeCharacterControl()
{
	// 누르면 
	if(CurrentCharacterControlType == ECharacterControlType::Quater)
	{
		SetCharacterControl(ECharacterControlType::Shoulder);
	}

	else if (CurrentCharacterControlType == ECharacterControlType::Shoulder)
	{
		SetCharacterControl(ECharacterControlType::Quater);
	}

}

void AABCharacterPlayer::SetCharacterControl(ECharacterControlType NewCharacterControlType)
{
	UABCharacterControlData* NewCharacterControl = CharacterControlManager[NewCharacterControlType];
	check(NewCharacterControl);

	SetCharacterControlData(NewCharacterControl);

	APlayerController* PlayerController = CastChecked<APlayerController>(GetController());

	ULocalPlayer* LocalPlayer = PlayerController->GetLocalPlayer();


	if(UEnhancedInputLocalPlayerSubsystem* SubSystem = ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(LocalPlayer))
	{
		SubSystem->ClearAllMappings();
		UInputMappingContext* NewMappingContext = NewCharacterControl->InputMappingContext; 
		if(NewMappingContext)
		{
			SubSystem->AddMappingContext(NewMappingContext, 0);
		}
	}

	CurrentCharacterControlType = NewCharacterControlType;

}

void AABCharacterPlayer::SetCharacterControlData(const UABCharacterControlData* CharacterControlData)
{
	Super::SetCharacterControlData(CharacterControlData);

	CameraBoom->TargetArmLength = CharacterControlData->TargetArmLength;
	CameraBoom->SetRelativeRotation(CharacterControlData->RelativeRotation);
	CameraBoom->bUsePawnControlRotation = CharacterControlData->bUsePawnControlRotation;
	CameraBoom->bInheritPitch = CharacterControlData->bInheritPitch;
	CameraBoom->bInheritYaw = CharacterControlData->bInheritYaw;
	CameraBoom->bInheritRoll = CharacterControlData->bInheritRoll;
	CameraBoom->bDoCollisionTest = CharacterControlData->bDoCollisionTest;

}

void AABCharacterPlayer::ShoulderMove(const FInputActionValue& Value)
{
	FVector2D MovementVector = Value.Get<FVector2D>(); 
	
	const FRotator Rotation = Controller->GetControlRotation();
	const FRotator YawRotation(0, Rotation.Yaw, 0);


	const FVector FowardDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);	
	const FVector RightDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);	

	

	AddMovementInput(FowardDirection, MovementVector.X);	
	AddMovementInput(RightDirection, MovementVector.Y);	
}

void AABCharacterPlayer::ShoulderLook(const FInputActionValue& Value)
{
	FVector2D LookAxisVector = Value.Get<FVector2D>(); 
	
	AddControllerYawInput(LookAxisVector.X);
	AddControllerPitchInput(LookAxisVector.Y);
	
}


void AABCharacterPlayer::QuaterMove(const FInputActionValue& Value)
{
	FVector2D MovementVector = Value.Get<FVector2D>();

	float InputSizeSquared = MovementVector.SquaredLength();
	float MovementVectorSize = 1.0f; 
	float MovementVectorSizeSquared = MovementVector.SquaredLength();

	if (MovementVectorSizeSquared > 1.0f)
	{
		MovementVector.Normalize();
		MovementVectorSizeSquared = 1.0f; 
	}

	else
	{
		MovementVectorSize = FMath::Sqrt(MovementVectorSizeSquared);
	}


	FVector MoveDirection = FVector(MovementVector.X, MovementVector.Y, 0.0f);
	GetController()->SetControlRotation(FRotationMatrix::MakeFromX(MoveDirection).Rotator());
	AddMovementInput(MoveDirection, MovementVectorSize);


}

해당 작업을 진행 중 몰랐던 부분.

Sholder View 컨트롤러를 구현하던 과정

UInputAction의 Input Value Type을 Vector2D로 설정하면, 입력 값은 (X,Y) 형태로 전달된다.

하지만, W,A,S,D와 같은 Digital Input(키보드 입력)은 눌렀을 때 1, 눌리지 않았을 때 0을 반환한다.

따라서 실제 전달되는 값은 다음과 같다.

W 입력 → (1,0)
입력 없음 → (0,0)

그래서 Input Mapping에서 해당 키의 Scalar 값을 (0,1,0)으로 설정하면 입력값에 곱해지는 결과가

(1 * 0 , 0 * 1 , 0 * 0 ) 이므로 최종 Vector2D 값이 (0,0)이 되면서 ShoulderMove()함수가 호출되지 않는 상황이 발생했다.

해당 문제는 Swizzle Modifier를 활용하여 X축으로 들어오는 입력 값을 Y축으로 재매핑하는 방식으로 해결하였다.

즉 (1,0) 입력값이 들어오면 (0,1)로 해주는 것이다.

구현 결과

A-star 알고리즘 구현 및 적용

seonhwan2547 — Tue, 24 Feb 2026 16:28:40 +0900

A-Star 알고리즘이란?

A*는 시작점에서 목표까지의 최단 경로를 찾기 위해

현재까지의 비용(g(n)) + 목표까지의 예상 비용(h(n)) 를기준으로 탐색하는 알고리즘 입니다.

g(n) : 시작점에서 현재 노드까지 가는데 드는 비용

h(n) : 현재 노드에서 목표 노드까지 가는데 드는 비용

f(n) : 총 예상 비용 ( g(n) + f(n) )

출처 https://recall.tistory.com/40#google_vignette

A-Star 알고리즘 동작 과정

출처 https://recall.tistory.com/40#google_vignette

1. 해당 노드 주변의 열린 노드의 g(n), h(n), f(n) 비용 구하기

- 열린노드(Open Node)는 현재 위치 노드에 인접한 노드들을 의미합니다.

- g(n)의 비용을 구하는 방식은 바로 유클리디안 거리(점과 점사이의 거리)을 사용하여 나타낸다.

- h(n)의 비용을 구하는 방식은 휴리스틱 거리 측정값을 통해 이동 비용을 구한다.

(격자에서는 가로, 세로 Manhattan 거리 방식을 이용하며, 그 외는 점과 점 사이의 거리 공식을 이용해 표현)

- f(n)의 비용 = g(n) + h(n) 이다.

2. 경로 탐색

출처 https://recall.tistory.com/40#google_vignette

현재 노드의 오픈 노드를 모아둔 오픈 리스트에서 가장 낮은 f(n)을 우선 방문합니다.

따라서 현재 그림상에서는 오른쪽 대각선 위 f(n) = 44인 노드를 방문합니다.

방문한 후에는 ClosedList에 해당 노드를 넣고 재방문을 하지 않도록 합니다.

(하늘색 윤곽선으로 그려진 노드는 ClosedList에 들어간 것입니다.)

3. 1,2번 반복 하여 Best_Route 구하기

출처 https://recall.tistory.com/40#google_vignette

A*가 왜 최적의 루트를 제공하는가?

해당 알고리즘을 공부하면서 의문이 들기도 했습니다.

이거 BFS와 마찬가지고 queue를 이용하여 모든 경로를 다 탐색하는거 아니야? 라는 생각을 처음에는 가졌습니다.

하지만 A* 알고리즘과 BFS의 탐색범위에 차이가 있습니다.

BFS 알고리즘 탐색 범위 vs A* 알고리즘 탐색 범위

A* 알고리즘은 무작정 모든 방향을 탐색하는 것이 아니라, 목표 지점에 더 가까워 보이는 노드를 우선적으로 확장합니다.

탐색 도중 장애물을 만나거나 비효율적인 경로임이 판단되면, Open list에 저장된 다른 후보 노드를 선택해 탐색을 이어갑니다.

이러한 방식 덕분에 BFS보다 불필요한 탐색을 줄이고, 더 빠르게 최적 경로를 찾을 수 있습니다.

코드 구현

bool CNavigation::Make_Route(int iStartIndex, int iGoalIndex)
{
	priority_queue<NodeInfo, vector<NodeInfo>,PQCompare> OpenQueue;

	NodeInfo node;

	node.index = iStartIndex; 
	node.g_Cost.x = 0;
	node.g_Cost.y = 0;
	node.Cost = 0; 

	OpenQueue.push(node);
	
	m_ClosedList.clear();
	
	
	while(!OpenQueue.empty())
	{
		// 여기서 계산하고 맨 위에거 가져온거 
		int CurIndex = OpenQueue.top().index;
		int Cur_gCoost_x = OpenQueue.top().g_Cost.x;
		int Cur_gCoost_y = OpenQueue.top().g_Cost.y;

		OpenQueue.pop();


		if (CheckClose(CurIndex))
			continue;

		if (CurIndex == iGoalIndex)
			return true; 
			

		m_ClosedList.push_back(CurIndex);	

		//여기서 이제 다시 오픈리스트에 넣고 계산하기 
		for (auto& pCell : m_vecCellAbj[CurIndex])
		{
			if (!CheckClose(pCell->Get_Index()) && pCell->Get_Option() != 1) // 장애물 체크 
			{


				//여기서 계산하기 (나중에 함수화하기) 
				int gCost_x = abs(m_vecCell[CurIndex]->Get_Position().x - pCell->Get_Position().x) + Cur_gCoost_x;
				int gCost_y = abs(m_vecCell[CurIndex]->Get_Position().y - pCell->Get_Position().y) + Cur_gCoost_y;

				int hCost_x = abs(m_vecCell[iGoalIndex]->Get_Position().x - pCell->Get_Position().x);
				int hCost_y = abs(m_vecCell[iGoalIndex]->Get_Position().y - pCell->Get_Position().y);

				// 여기서도 g_value가 더 낮다면을 가정해야함 
				if ((gCost_x + gCost_y) < pCell->Get_gValue())
				{
					pCell->Set_ParentIndex(CurIndex);
					pCell->Set_gValue(gCost_x + gCost_y);

					int fResult = gCost_x + gCost_y + hCost_x + hCost_y;


					NodeInfo node;
					node.index = pCell->Get_Index();
					node.Cost = fResult;
					node.g_Cost.x = gCost_x;
					node.g_Cost.y = gCost_y;
					
					OpenQueue.push(node);
				}
			}
		}
	}



	return false; 
}

구현 결과

A-star 구현