캐릭터 무브먼트 설정

1. 먼저 에픽게임즈 런처 에 로그인하고 추가(New) > 게임(Games) > 기본(Blank) 을 차례대로 선택한 후 CharacterMovement 라는 프로젝트를 생성합니다.

   

2. 캐릭터를 애니메이팅하기 위해 필요한 애니메이션 스타터 팩(Animation Starter Pack) 은 에픽게임즈 마켓플레이스에서 무료로 다운로드할 수 있습니다. 무료(Free) 버튼을 클릭하여 애니메이션 스타터 팩을 다운로드하고 에픽게임즈 라이브러리(Epic Games Library) 에 추가합니다.

   

3. 라이브러리(Library) 에서 애니메이션 스타터 팩(Animation Starter Pack) 을 찾아 프로젝트에 추가(Add to Project) 를 클릭한 다음, 에셋을 추가할 프로젝트 선택(Select the Project to Add Asset to) 메뉴에서 CharacterMovement 프로젝트 파일을 찾아 선택하고 프로젝트에 추가(Add to Project) 를 클릭합니다.

   

4. 애니메이션 스타터 팩을 프로젝트에 추가하면 콘텐츠 브라우저(Content Browser) 에 해당 스타터 팩이 표시됩니다.

   

1. 먼저 추가(New) > 게임(Games) > 기본(Blank) 을 차례대로 선택한 후 CharacterMovement 라는 C++ 프로젝트를 생성합니다.

   

2. 캐릭터를 애니메이팅하기 위해 필요한 애니메이션 스타터 팩(Animation Starter Pack) 은 에픽게임즈 마켓플레이스에서 무료로 다운로드할 수 있습니다. 무료(Free) 버튼을 클릭하여 애니메이션 스타터 팩을 다운로드하고 에픽게임즈 라이브러리(Epic Games Library) 에 추가합니다.

   

3. 라이브러리(Library) 에서 애니메이션 스타터 팩(Animation Starter Pack) 을 찾아 프로젝트에 추가(Add to Project) 를 클릭한 다음, 에셋을 추가할 프로젝트 선택(Select the Project to Add Asset to) 메뉴에서 CharacterMovement 프로젝트 파일을 찾아 선택하고 프로젝트에 추가(Add to Project) 를 클릭합니다.

   

4. 애니메이션 스타터 팩을 프로젝트에 추가하면 콘텐츠 브라우저(Content Browser) 에 해당 스타터 팩이 표시됩니다.

   

플레이어가 캐릭터를 제어하려면 캐릭터(Character) 클래스를 생성해야 합니다. 캐릭터는 캐릭터 무브먼트 컴포넌트(Character Movement Component)와 연동되는 폰(Pawn)으로서 인간형 캐릭터가 월드를 활보할 수 있는 로코모션 시스템을 지원합니다. 캐릭터를 단계적으로 설정하는 방법은 다음과 같습니다.

1. 추가/임포트(Add/Import) 버튼을 클릭하여 BP_PlayerCharacter 라는 새로운 블루프린트 캐릭터(Character) 클래스를 생성합니다.

   

2. BP_PlayerCharacter 를 더블클릭하여 클래스 디폴트 를 연 다음, 컴포넌트(Components) 탭에서 메시 (CharacterMesh0) 스켈레탈 메시 컴포넌트(Skeletal Mesh Component) 를 선택하고 디테일 패널 로 이동합니다.

   이미지를 클릭하면 확대됩니다.

3. 메시(Mesh) 카테고리 에서 스켈레탈 메시(Skeletal Mesh) 변수 옆에 있는 드롭다운 화살표를 선택하고 드롭다운 메뉴에서 SK_Mannequin 을 선택합니다.

   

4. 디테일 패널 에서 트랜스폼(Transform) 카테고리 로 이동하여 메시의 위치(Location) 와 회전(Rotation) 을 (0 , 0 , -90 ) 으로 설정합니다.

   

5. 이제 캐릭터의 스켈레탈 메시 가 아래 이미지에 보이는 것처럼 앞쪽 화살표 컴포넌트(Arrow Component) 방향을 향하게 됩니다.

   

6. 컴포넌트(Components) 탭 으로 이동하여 메시(Mesh) 컴포넌트를 선택한 후 컴포넌트 추가(Add Component) 를 클릭하고 드롭다운 메뉴에서 SpringArm을 찾아 선택한 다음, 스프링 암 컴포넌트(Spring Arm Component) 의 이름을 'SpringArmComp '로 지정합니다.

   

7. 디테일 패널 로 이동하여 카메라 세팅(Camera Settings) 카테고리에 있는 폰 제어 회전 사용(Use Pawn Control Rotation) 을 활성화합니다.

   

   폰 제어 회전 사용을 활성화하면 카메라가 스프링 암을 기준으로 회전합니다.

8. 카메라(Camera) 카테고리 에서 소켓 오프셋(Socket Offset) 을 (0, 0, 30 )으로 설정한 다음, 트랜스폼(Transform) 카테고리 로 이동하여 SpringArmComp의 위치 를 (0, 0, 50 )으로 설정합니다.

   

9. SpringArmComp를 선택한 상태에서 컴포넌트 추가(Add Component) 버튼을 클릭한 다음, 드롭다운 메뉴에서 카메라를 찾아 선택하여 CameraComp 라는 카메라 컴포넌트(Camera Component) 를 추가합니다.

   

10. 컴포넌트(Components) 탭에서 캐릭터 무브먼트 컴포넌트(Character Movement Component) 를 선택한 다음, 디테일 패널 로 이동하여 캐릭터 무브먼트(회전 세팅)(Character Movement (Rotation Settings)) 카테고리에 있는 컨트롤러 선호 회전 사용(Use Controller Desired Rotation) 과 무브먼트 방향으로 회전 조정(Orient Rotation to Movement) 을 활성화합니다.

    

11. 캐릭터 무브먼트: 걷기(Character Movement: Walking) 카테고리에 있는 베이스 회전 무시(Ignore Base Rotation) 변수를 활성화합니다.

    

    베이스 회전 무시를 활성화하면 캐릭터가 현재 월드 회전을 유지하고 캐릭터가 서 있는 베이스의 회전에 발생한 모든 변화를 무시합니다.

12. 캐릭터 무브먼트 내비 무브먼트(Character Movement Nav Movement) 카테고리 에서 무브먼트 기능(Movement Capabilities) 으로 이동한 후 추가 변수 세팅이 나타나도록 드롭다운 화살표를 선택한 다음, 크라우치 가능(Can Crouch) 부울 을 클릭하여 활성화합니다.

    

13. 컴파일(Compile) 하고 저장(Save) 합니다.

    

플레이어가 캐릭터를 제어하려면 캐릭터(Character) 클래스를 생성해야 합니다. 캐릭터는 캐릭터 무브먼트 컴포넌트(Character Movement Component)와 연동되는 폰(Pawn)으로서 인간형 캐릭터가 월드를 활보할 수 있는 로코모션 시스템을 지원합니다. 캐릭터를 단계적으로 설정하는 방법은 다음과 같습니다.

1. C++ 클래스 마법사(C++ Class Wizard) 에서 PlayerCharacter 라는 새로운 캐릭터(Character) 클래스를 생성한 다음, PlayerCharacter.h 파일로 이동하여 아래의 클래스 정의를 선언합니다.

        protected:
   
        //스프링 암 컴포넌트가 플레이어 뒤에 있는 카메라를 따라갑니다.
        UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
        class USpringArmComponent* SpringArmComp;
   
        //플레이어가 카메라를 따라갑니다.
        UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
        class UCameraComponent* CameraComp;
   
   Copy full snippet

   protected: //스프링 암 컴포넌트가 플레이어 뒤에 있는 카메라를 따라갑니다. UPROPERTY(VisibleAnywhere, BlueprintReadWrite) class USpringArmComponent* SpringArmComp; //플레이어가 카메라를 따라갑니다. UPROPERTY(VisibleAnywhere, BlueprintReadWrite) class UCameraComponent* CameraComp;

2. PlayerCharactor.cpp 파일로 이동하여 아래의 클래스 라이브러리를 추가합니다.

        #include "Camera/CameraComponent.h"
        #include "GameFramework/SpringArmComponent.h"
        #include "GameFramework/CharacterMovementComponent.h"
   
   Copy full snippet

   #include "Camera/CameraComponent.h" #include "GameFramework/SpringArmComponent.h" #include "GameFramework/CharacterMovementComponent.h"

3. APlayerCharactor::APlayerCharacter 생성자 메서드에서 아래와 같이 선언합니다.

        // 클래스 컴포넌트 인스턴스화
   
        SpringArmComp = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComp"));
   
        CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));
   
        //캐릭터 메시 트랜스폼의 위치와 회전을 설정합니다.
   
        GetMesh()->SetRelativeLocationAndRotation(FVector(0.0f, 0.0f, -90.0f), FQuat(FRotator(0.0f, -90.0f, 0.0f)));
   
        // 클래스 컴포넌트를 디폴트 캐릭터의 스켈레탈 메시 컴포넌트에 어태치합니다.
   
        SpringArmComp->SetupAttachment(GetMesh());
   
        CameraComp->SetupAttachment(SpringArmComp,USpringArmComponent::SocketName);
   
        //스프링 암의 클래스 변수를 설정합니다.
   
        SpringArmComp->bUsePawnControlRotation = true;
   
        //캐릭터 무브먼트 컴포넌트의 클래스 변수를 설정합니다.
   
        GetCharacterMovement()->bOrientRotationToMovement = true;
   
        GetCharacterMovement()->bUseControllerDesiredRotation = true;
   
        GetCharacterMovement()->bIgnoreBaseRotation = true;
   
   Copy full snippet

   // 클래스 컴포넌트 인스턴스화 SpringArmComp = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComp")); CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp")); //캐릭터 메시 트랜스폼의 위치와 회전을 설정합니다. GetMesh()->SetRelativeLocationAndRotation(FVector(0.0f, 0.0f, -90.0f), FQuat(FRotator(0.0f, -90.0f, 0.0f))); // 클래스 컴포넌트를 디폴트 캐릭터의 스켈레탈 메시 컴포넌트에 어태치합니다. SpringArmComp->SetupAttachment(GetMesh()); CameraComp->SetupAttachment(SpringArmComp,USpringArmComponent::SocketName); //스프링 암의 클래스 변수를 설정합니다. SpringArmComp->bUsePawnControlRotation = true; //캐릭터 무브먼트 컴포넌트의 클래스 변수를 설정합니다. GetCharacterMovement()->bOrientRotationToMovement = true; GetCharacterMovement()->bUseControllerDesiredRotation = true; GetCharacterMovement()->bIgnoreBaseRotation = true;

4. 코드를 컴파일(Compile) 합니다.

5. 에디터 에서 C++ 클래스(C++ Classes) 폴더 로 이동한 다음, PlayerCharacter 클래스를 우클릭하고 C++ 클래스 액션(C++ Class Actions) 드롭다운 메뉴에서 PlayerCharacter 기반 블루프린트 클래스 생성(Create Blueprint class based on PlayerCharacter) 을 선택합니다. 블루프린트의 이름을 Bp_PlayerCharacter 로 지정합니다.

   이미지를 클릭하면 확대됩니다.

6. BP_PlayerCharacter 를 더블클릭하여 클래스 디폴트(Class Defaults) 를 연 다음, 컴포넌트(Components) 탭 에서 메시 (CharacterMesh0) 스켈레탈 메시 컴포넌트(Skeletal Mesh Component) 를 선택하고 디테일 패널 로 이동합니다.

   이미지를 클릭하면 확대됩니다.

7. 메시(Mesh) 카테고리 에서 스켈레탈 메시(Skeletal Mesh) 변수 옆에 있는 드롭다운 화살표를 선택하고 드롭다운 메뉴에서 SK_Mannequin 을 선택합니다.

   

8. 캐릭터의 스켈레탈 메시 가 아래 이미지에 보이는 것처럼 앞쪽 화살표 컴포넌트(Arrow Component) 방향을 향하게 됩니다.

   

9. 컴파일(Compile) 하고 저장(Save) 합니다.

   

W, A, S, D 같은 입력 키를 누르면 캐릭터가 움직이는 몇 가지 커스텀 로직을 설정해야 합니다.

1. 편집(Edit) > 프로젝트 세팅(Project Settings) > 입력(Input) 으로 이동한 다음, 바인딩(Bindings) 카테고리 에서 액션 매핑(Action Mappings) 옆의 + 부호를 클릭하여 아래의 액션 매핑을 추가합니다.

   액션 매핑	키 값
   점프	스페이스 바
   앉기	왼쪽 Ctrl
   스프린트	왼쪽 Shift

   

2. 바인딩(Bindings) 카테고리 에서 축 매핑(Axis Mappings) 옆에 있는 + 부호를 클릭하여 아래의 축 매핑 을 추가합니다.

   축 매핑	키 값	스케일
   MoveForward	W	1.0
   	S	-1.0
   오른쪽으로 이동	D	1.0
   	A	-1.0
   Turn	마우스 X	1.0
   LookUp	마우스 Y	-1.0

   

3. 콘텐츠 브라우저(Content Browser) 에서 BP_PlayerCharacter 를 더블클릭하여 클래스 디폴트(Class Defaults) 를 연 다음, 이벤트 그래프(Event Graph) 를 우클릭하고 드롭다운 메뉴에서 MoveForward 를 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

4. InputAxis MoveForward 노드의 실행 핀 을 밖으로 드래그한 후 드롭다운 메뉴에서 Add Movement Input 노드를 찾아 선택한 다음, InputAxis MoveForward 노드의 Axis Value 핀을 Add Movement Input 노드의 Scale Value 핀에 연결합니다.

   이미지를 클릭하면 확대됩니다.

5. 이벤트 그래프(Event Graph) 를 우클릭하고 컨텍스트 메뉴에서 Get Control Rotation 을 찾아 선택한 후 Return Value 핀을 밖으로 드래그한 다음, 드롭다운 메뉴에서 Break Rotator 를 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

6. Break Rotator 노드의 Z(Yaw) 핀을 밖으로 드래그한 후 드롭다운 메뉴에서 Make Rotator 를 찾아 선택한 다음, Make Rotator 노드의 Return Value 핀을 밖으로 드래그한 후 드롭다운 메뉴에서 Get Forward Vector 를 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

7. Get Forward Vector 노드의 Return Value 핀을 밖으로 드래그하여 Add Movement Input 노드의 World Direction 핀에 연결합니다.

   이미지를 클릭하면 확대됩니다.

8. 그래프를 다시 우클릭하고 입력 축 이벤트(Input Axis Event) 를 위해 오른쪽으로 이동(Move Right) 을 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

9. InputAxis MoveRight 노드의 실행 핀 을 밖으로 드래그한 후 드롭다운 메뉴에서 Add Movement Input 노드를 찾아 선택한 다음, InputAxis MoveRight 노드의 Axis Value 핀을 Add Movement Input 노드 의 스케일 값(Scale Value) 핀에 연결합니다.

   이미지를 클릭하면 확대됩니다.

10. Make Rotator 노드의 Return Value 핀을 밖으로 드래그한 후 드롭다운 메뉴에서 Get Right Vector 노드를 찾아 선택한 다음, Return Value 핀을 밖으로 드래그하여 Add Movement Input 노드의 World Direction 핀에 연결합니다.

    이미지를 클릭하면 확대됩니다.

11. 완성된 무브먼트 입력 이벤트 블루프린트 그래프는 아래와 같습니다.

    이미지를 클릭하면 확대됩니다.

12. 이벤트 그래프(Event Graph) 를 우클릭 하고 InputAxis LookUp 이벤트 노드를 찾아 선택한 다음, 우클릭하고 Add Controller Pitch Input 노드를 찾아 선택합니다.

    이미지를 클릭하면 확대됩니다.

13. InputAxis LookUp 노드의 Axis Value 핀을 밖으로 드래그하여 Add Controller Pitch Input 노드의 Val 핀에 연결합니다. InputAxis LookUp 노드의 실행 출력 핀 을 밖으로 드래그하여 Add Controller Pitch Input 노드의 실행 입력 핀 에 연결합니다.

    이미지를 클릭하면 확대됩니다.

14. 이벤트 그래프(Event Graph) 를 우클릭한 후 InputAxis Turn 이벤트 노드를 찾아 선택한 다음, 우클릭하고 Add Controller Yaw Input 노드를 찾아 선택합니다.

    이미지를 클릭하면 확대됩니다.

15. Turn 입력 축 노드의 Axis Value 핀에서 드래그하여 Add Controller Yaw Input 노드의 Val 핀에 연결합니다. InputAxis Turn 노드의 실행 출력 핀 을 밖으로 드래그하여 Add Controller Yaw Input 노드의 실행 입력 핀 에 연결합니다.

    이미지를 클릭하면 확대됩니다.

16. 컴파일(Compile) 과 저장(Save) 을 클릭합니다.

    

미완성된 블루프린트

현재 프로세스 시점에서 블루프린트 그래프는 아래의 이미지와 유사합니다.

이미지를 클릭하면 확대됩니다.

W, A, S, D 같은 입력 키를 누르면 캐릭터가 움직이는 몇 가지 커스텀 로직을 설정해야 합니다.

1. 편집(Edit) > 프로젝트 세팅(Project Settings) > 입력(Input) 으로 이동한 다음, 바인딩(Bindings) 카테고리 에서 액션 매핑(Action Mappings) 옆의 + 부호를 클릭하여 아래의 액션 매핑 을 추가합니다.

   액션 매핑	키 값
   점프	스페이스 바
   앉기	왼쪽 Ctrl
   스프린트	왼쪽 Shift

   

2. 바인딩(Bindings) 카테고리 에서 축 매핑(Axis Mappings) 옆에 있는 + 부호를 클릭하여 아래의 축 매핑 을 추가합니다.

   축 매핑	키 값	스케일
   MoveForward	W	1.0
   	S	-1.0
   오른쪽으로 이동	D	1.0
   	A	-1.0
   Turn	마우스 X	1.0
   LookUp	마우스 Y	-1.0

   

3. PlayerCharacter.h에 아래의 클래스 메서드를 선언합니다.

        protected:
   
        //앞쪽/뒤쪽 입력을 위해 호출합니다.
   
        void MoveForward(float InputAxis);
   
        //왼쪽/오른쪽 입력을 위해 호출합니다.
   
        void MoveRight(float InputAxis);
   
   Copy full snippet

   protected: //앞쪽/뒤쪽 입력을 위해 호출합니다. void MoveForward(float InputAxis); //왼쪽/오른쪽 입력을 위해 호출합니다. void MoveRight(float InputAxis);

4. PlayerCharacter.Cpp에서 APlayerCharacter::MoveForward 및 APlayerCharacter::MoveRight 클래스 메서드에 적용될 아래의 로직을 구현합니다.

        void APlayerCharacter::MoveForward(float AxisValue)
        {
            if ((Controller != nullptr) && (AxisValue != 0.0f))
            {
                // 앞쪽 찾기
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);
   
                // 앞쪽 벡터 구하기
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
                AddMovementInput(Direction, AxisValue);
            }
        }
   
        void APlayerCharacter::MoveRight(float AxisValue)
        {
            if ((Controller != nullptr) && (AxisValue != 0.0f))
            {
                // 오른쪽 찾기
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);
   
                // 오른쪽 벡터 구하기
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);
   
                // 해당 방향으로 이동 추가
                AddMovementInput(Direction, AxisValue);
            }
        }
   
   Copy full snippet

   void APlayerCharacter::MoveForward(float AxisValue) { if ((Controller != nullptr) && (AxisValue != 0.0f)) { // 앞쪽 찾기 const FRotator Rotation = Controller->GetControlRotation(); const FRotator YawRotation(0, Rotation.Yaw, 0); // 앞쪽 벡터 구하기 const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X); AddMovementInput(Direction, AxisValue); } } void APlayerCharacter::MoveRight(float AxisValue) { if ((Controller != nullptr) && (AxisValue != 0.0f)) { // 오른쪽 찾기 const FRotator Rotation = Controller->GetControlRotation(); const FRotator YawRotation(0, Rotation.Yaw, 0); // 오른쪽 벡터 구하기 const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y); // 해당 방향으로 이동 추가 AddMovementInput(Direction, AxisValue); } }

5. 그런 다음, APlayerCharacter::SetupPlayerInputComponent 메서드로 이동하여 아래의 코드를 구현합니다.

        //함수 기능을 입력에 바인딩하기 위해 호출
        void APlayerCharacter::SetupPlayerInputComponent(UInputComponent*)
        {
            Super::SetupPlayerInputComponent(PlayerInputComponent);
   
            PlayerInputComponent->BindAxis("MoveForward", this, &APlayerCharacter::MoveForward);
            PlayerInputComponent->BindAxis("MoveRight", this, &APlayerCharacter::MoveRight);
            PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput);
            PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput);
   
        }
   
   Copy full snippet

   //함수 기능을 입력에 바인딩하기 위해 호출 void APlayerCharacter::SetupPlayerInputComponent(UInputComponent*) { Super::SetupPlayerInputComponent(PlayerInputComponent); PlayerInputComponent->BindAxis("MoveForward", this, &APlayerCharacter::MoveForward); PlayerInputComponent->BindAxis("MoveRight", this, &APlayerCharacter::MoveRight); PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput); PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput); }

6. 코드를 컴파일(Compile) 합니다.

작업 중인 코드

PlayerCharacter.h

		#include "CoreMinimal.h"
		#include "GameFramework/Character.h"
		#include "PlayerCharacter.generated.h"

		UCLASS()
		class CHARACTERMOVEMENT_API APlayerCharacter : public ACharacter
		{
			GENERATED_BODY()

		public:
			//이 캐릭터의 프로퍼티에 적용되는 디폴트값 설정
			APlayerCharacter();

		protected:
			// 게임 시작 또는 스폰 시 호출
			virtual void BeginPlay() override;

			//스프링 암 컴포넌트가 플레이어 뒤에 있는 카메라를 따라갑니다.
			UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
			class USpringArmComponent* SpringArmComp;

			//플레이어가 카메라를 따라갑니다.
			UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
			class UCameraComponent* CameraComp;

			//앞쪽/뒤쪽 입력을 위해 호출합니다.
			void MoveForward(float InputAxis);

			//왼쪽/오른쪽 입력을 위해 호출합니다.
			void MoveRight(float InputAxis);

		public:
			// 프레임마다 호출
			virtual void Tick(float DeltaTime) override;

			//함수 기능을 입력에 바인딩하기 위해 호출
			virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;
		};

Copy full snippet

PlayerCharacter.Cpp

		#include "PlayerCharacter.h"
		#include "Camera/CameraComponent.h"
		#include "GameFramework/SpringArmComponent.h"
		#include "GameFramework/CharacterMovementComponent.h"

		// 디폴트값 설정
		APlayerCharacter::APlayerCharacter()
		{
			// 이 캐릭터가 프레임마다 Tick()을 호출하도록 설정합니다.  이 설정이 필요 없는 경우 비활성화하면 퍼포먼스가 향상됩니다.
			PrimaryActorTick.bCanEverTick = true;

			// 클래스 컴포넌트 인스턴스화
			SpringArmComp = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComp"));
			CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));

			//캐릭터 메시 트랜스폼의 위치와 회전을 설정합니다.
			GetMesh()->SetRelativeLocationAndRotation(FVector(0.0f, 0.0f, -90.0f), FQuat(FRotator(0.0f, -90.0f, 0.0f)));

			// 클래스 컴포넌트를 디폴트 캐릭터의 스켈레탈 메시 컴포넌트에 어태치합니다.
			SpringArmComp->SetupAttachment(GetMesh());
			CameraComp->SetupAttachment(SpringArmComp,USpringArmComponent::SocketName);

			//스프링 암의 클래스 변수를 설정합니다.
			SpringArmComp->bUsePawnControlRotation = true;

			//캐릭터 무브먼트 컴포넌트의 클래스 변수를 설정합니다.
			GetCharacterMovement()->bOrientRotationToMovement = true;
			GetCharacterMovement()->bUseControllerDesiredRotation = true;
			GetCharacterMovement()->bIgnoreBaseRotation = true;

		}

		// 게임 시작 또는 스폰 시 호출
		void APlayerCharacter::BeginPlay()

		{
			Super::BeginPlay();

		}

		void APlayerCharacter::MoveForward(float AxisValue)

		{
			if ((Controller != nullptr) && (AxisValue != 0.0f))
			{
				// 앞쪽 찾기
				const FRotator Rotation = Controller->GetControlRotation();
				const FRotator YawRotation(0, Rotation.Yaw, 0);

				// 앞쪽 벡터 구하기
				const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
				AddMovementInput(Direction, AxisValue);
			}
		}

		void APlayerCharacter::MoveRight(float AxisValue)
		{
			if ((Controller != nullptr) && (AxisValue != 0.0f))
			{
				// 오른쪽 찾기
				const FRotator Rotation = Controller->GetControlRotation();
				const FRotator YawRotation(0, Rotation.Yaw, 0);

				// 오른쪽 벡터 구하기
				const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

				// 해당 방향으로 이동 추가
				AddMovementInput(Direction, AxisValue);
			}
		}

		// 프레임마다 호출
		void APlayerCharacter::Tick(float DeltaTime)
		{
			Super::Tick(DeltaTime);

		}

		//함수 기능을 입력에 바인딩하기 위해 호출
		void APlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
		{
			Super::SetupPlayerInputComponent(PlayerInputComponent);
			PlayerInputComponent->BindAxis("MoveForward",this, &APlayerCharacter::MoveForward);
			PlayerInputComponent->BindAxis("MoveRight", this, &APlayerCharacter::MoveRight);
			PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput);
			PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput);
		}
Copy full snippet

이렇게 해서 전방 이동(Move Forward), 오른쪽으로 이동(Move Right), 올려 보기(LookUp), 회전(Turn) 입력 이벤트에 적용될 블루프린트 스크립팅 로직이 완성되면 점프(Jump), 앉기(Crouch), 스프린트(Sprint) 입력 이벤트에 적용될 액션 매핑(Action Mappings)을 구현해야 합니다.

1. 이벤트 그래프(Event Graph) 를 우클릭한 다음, 이 블루프린트에 대한 모든 액션(All Actions for this Blueprint) 드롭다운 메뉴에서 Jump 액션 이벤트(Action Event) 를 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

2. Jump 입력 액션(InputAction Jump) 노드의 Pressed 실행 핀을 밖으로 드래그한 다음, 드롭다운 메뉴에서 캐릭터 함수 Jump 를 찾아 선택합니다.

   

3. Jump 입력 액션(InputAction Jump) 노드의 실행 핀 을 Jump 노드의 실행 핀 에 연결합니다.

   이미지를 클릭하면 확대됩니다.

4. Jump 입력 액션(InputAction Jump) 노드의 Released 실행 핀을 밖으로 드래그한 다음, 드롭다운 메뉴에서 캐릭터(Character) 함수 Stop Jumping 을 찾아 선택합니다.

   이미지를 클릭하면 확대됩니다.

5. 이벤트 그래프(Event Graph) 를 우클릭하고 드롭다운 메뉴에서 Sprint 입력 액션(InputAction Sprint) 을 찾아 선택합니다.

   

6. 컴포넌트(Components) 탭 으로 이동한 다음, 캐릭터 무브먼트 컴포넌트(Character Movement Component) 를 클릭하여 이벤트 그래프(Event Graph) 로 드래그합니다.

   이미지를 클릭하면 확대됩니다.

7. Character Movement 핀 을 밖으로 드래그한 다음, 드롭다운 메뉴에서 Set Max Walk Speed 노드를 찾아 선택합니다. Max Walk Speed 플로트 값을 1000 으로 설정한 다음, Sprint 입력 액션(InputAction Sprint) 노드의 눌림(Pressed) 실행 핀 을 Set Max Walk Speed 노드의 입력 실행 핀에 연결합니다.

   이미지를 클릭하면 확대됩니다.

8. Character Movement 핀 을 밖으로 드래그한 다음, 또 다른 Set Max Walk Speed 노드를 찾아 선택합니다. Max Walk Speed 플로트 값을 600 으로 설정한 다음, Sprint 입력 액션(InputAction Sprint) 노드의 Released 실행 핀을 Set Max Walk Speed 노드의 실행 입력 핀에 연결합니다.

   이미지를 클릭하면 확대됩니다.

9. 이벤트 그래프(Event Graph) 를 우클릭하고 드롭다운 메뉴에서 Crouch 입력 액션 을 찾아 선택합니다.

   

10. Crouch 입력 액션(InputAction Crouch) 노드의 Pressed 실행 핀을 밖으로 드래그한 다음, 드롭다운 메뉴에서 캐릭터 클래스 함수 Crouch 를 찾아 선택합니다.

    이미지를 클릭하면 확대됩니다.

11. Crouch 입력 액션(InputAction Crouch) 노드의 Released 실행 핀을 밖으로 드래그한 다음, 드롭다운 액션 메뉴에서 캐릭터 클래스 함수 Un Crouch 를 찾아 선택합니다.

    이미지를 클릭하면 확대됩니다.

12. 블루프린트를 컴파일(Compile) 하고 저장(Save) 합니다.

    

완성된 블루프린트

완성된 블루프린트는 아래의 이미지와 유사합니다.

이미지를 클릭하면 확대됩니다.

이렇게 해서 전방 이동(Move Forward) , 오른쪽으로 이동(Move Right) , 올려 보기(LookUp) , 회전(Turn) 입력 이벤트 에 적용될 코드 스크립팅 로직이 완성되면 점프(Jump) , 앉기(Crouch) , 스프린트(Sprint) 입력 이벤트에 적용될 액션 매핑(Action Mappings) 을 구현해야 합니다.

1. PlayerCharacter.h 파일로 이동하여 아래의 클래스 메서드를 선언합니다.

        protected:
   
            //캐릭터 무브먼트 속도를 스프린트 값으로 설정합니다.
            void BeginSprint();
   
            //캐릭터 무브먼트 속도를 디폴트 속도 값으로 다시 설정합니다.
            void EndSprint();
   
            //캐릭터에게 앉기를 요청합니다.
            void BeginCrouch();
   
            //캐릭터에게 앉기 종료를 요청합니다.
            void EndCrouch();
   
   Copy full snippet

   protected: //캐릭터 무브먼트 속도를 스프린트 값으로 설정합니다. void BeginSprint(); //캐릭터 무브먼트 속도를 디폴트 속도 값으로 다시 설정합니다. void EndSprint(); //캐릭터에게 앉기를 요청합니다. void BeginCrouch(); //캐릭터에게 앉기 종료를 요청합니다. void EndCrouch();

2. PlayerCharacter.cpp 파일에서 APlayerCharacter::BeginSprint 및 APlayerCharacter::EndSprint 클래스 메서드에 적용될 아래의 로직을 구현합니다.

        void APlayerCharacter::BeginSprint()
        {
            GetCharacterMovement()->MaxWalkSpeed = 1000.0f;
        }
   
        void APlayerCharacter::EndSprint()
        {
            GetCharacterMovement()->MaxWalkSpeed = 600.f;
        }
   
   Copy full snippet

   void APlayerCharacter::BeginSprint() { GetCharacterMovement()->MaxWalkSpeed = 1000.0f; } void APlayerCharacter::EndSprint() { GetCharacterMovement()->MaxWalkSpeed = 600.f; }

3. APlayerCharacter::BeginCrouch 및 APlayerCharacter::EndCrouch 메서드에 적용될 아래의 로직을 구현합니다.

       void APlayerCharacter::BeginCrouch()
       {
           Crouch();
       }
   
       void APlayerCharacter::EndCrouch()
       {
           UnCrouch();
       }
   
   Copy full snippet

   void APlayerCharacter::BeginCrouch() { Crouch(); } void APlayerCharacter::EndCrouch() { UnCrouch(); }

4. APlayerCharacter:: ::SetupPlayerInputComponent 메서드로 이동하여 다음 코드를 선언합니다.

        void APlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
        {
   
            PlayerInputComponent->BindAction("Jump",IE_Pressed,this,&ACharacter::Jump);
            PlayerInputComponent->BindAction("Jump",IE_Released,this,&ACharacter::StopJumping);
            PlayerInputComponent->BindAction("Crouch",IE_Pressed,this,&APlayerCharacter::BeginCrouch);
            PlayerInputComponent->BindAction("Crouch",IE_Released,this,&APlayerCharacter::EndCrouch);
            PlayerInputComponent->BindAction("Sprint",IE_Pressed,this,&APlayerCharacter::BeginSprint);
            PlayerInputComponent->BindAction("Sprint",IE_Released,this,&APlayerCharacter::EndSprint);
   
        }
   
   Copy full snippet

   void APlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) { PlayerInputComponent->BindAction("Jump",IE_Pressed,this,&ACharacter::Jump); PlayerInputComponent->BindAction("Jump",IE_Released,this,&ACharacter::StopJumping); PlayerInputComponent->BindAction("Crouch",IE_Pressed,this,&APlayerCharacter::BeginCrouch); PlayerInputComponent->BindAction("Crouch",IE_Released,this,&APlayerCharacter::EndCrouch); PlayerInputComponent->BindAction("Sprint",IE_Pressed,this,&APlayerCharacter::BeginSprint); PlayerInputComponent->BindAction("Sprint",IE_Released,this,&APlayerCharacter::EndSprint); }

5. 코드를 컴파일(Compile) 합니다.

완성된 코드

PlayerCharacter.h

		#pragma once

		#include "CoreMinimal.h"
		#include "GameFramework/Character.h"
		#include "PlayerCharacter.generated.h"

		UCLASS()
		class CHARACTERMOVEMENT_API APlayerCharacter : public ACharacter
		{
			GENERATED_BODY()

		public:
			//이 캐릭터의 프로퍼티에 적용되는 디폴트값 설정
			APlayerCharacter();

		protected:
			// 게임 시작 또는 스폰 시 호출
			virtual void BeginPlay() override;

			//스프링 암 컴포넌트가 플레이어 뒤에 있는 카메라를 따라갑니다.
			UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
			class USpringArmComponent* SpringArmComp;

			//플레이어가 카메라를 따라갑니다.
			UPROPERTY(VisibleAnywhere, BlueprintReadWrite)
			class UCameraComponent* CameraComp;

			//앞쪽/뒤쪽 입력을 위해 호출합니다.
			void MoveForward(float InputAxis);

			//왼쪽/오른쪽 입력을 위해 호출합니다.
			void MoveRight(float InputAxis);

			//캐릭터 무브먼트 속도를 스프린트 값으로 설정합니다.
			void BeginSprint();

			//캐릭터 무브먼트 속도를 디폴트 속도 값으로 다시 설정합니다.
			void EndSprint();

			//캐릭터에게 앉기를 요청합니다.
			void BeginCrouch();

			//캐릭터에게 앉기 종료를 요청합니다.
			void EndCrouch();

		public:

			// 프레임마다 호출
			virtual void Tick(float DeltaTime) override;

			//함수 기능을 입력에 바인딩하기 위해 호출
			virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

		};

Copy full snippet

PlayerCharacter.cpp

		#include "PlayerCharacter.h"
		#include "Camera/CameraComponent.h"
		#include "GameFramework/SpringArmComponent.h"
		#include "GameFramework/CharacterMovementComponent.h"

		// 디폴트값 설정
		APlayerCharacter::APlayerCharacter()
		{
			// 이 캐릭터가 프레임마다 Tick()을 호출하도록 설정합니다.  이 설정이 필요 없는 경우 비활성화하면 퍼포먼스가 향상됩니다.
			PrimaryActorTick.bCanEverTick = true;

			// 클래스 컴포넌트 인스턴스화
			SpringArmComp = CreateDefaultSubobject<USpringArmComponent>(TEXT("SpringArmComp"));
			CameraComp = CreateDefaultSubobject<UCameraComponent>(TEXT("CameraComp"));

			//캐릭터 메시 트랜스폼의 위치와 회전을 설정합니다.
			GetMesh()->SetRelativeLocationAndRotation(FVector(0.0f, 0.0f, -90.0f), FQuat(FRotator(0.0f, -90.0f, 0.0f)));

			// 클래스 컴포넌트를 디폴트 캐릭터의 스켈레탈 메시 컴포넌트에 어태치합니다.
			SpringArmComp->SetupAttachment(GetMesh());
			CameraComp->SetupAttachment(SpringArmComp,USpringArmComponent::SocketName);

			//스프링 암의 클래스 변수를 설정합니다.
			SpringArmComp->bUsePawnControlRotation = true;

			//캐릭터 무브먼트 컴포넌트의 클래스 변수를 설정합니다.
			GetCharacterMovement()->bOrientRotationToMovement = true;
			GetCharacterMovement()->bUseControllerDesiredRotation = true;
			GetCharacterMovement()->bIgnoreBaseRotation = true;
		}

		// 게임 시작 또는 스폰 시 호출
		void APlayerCharacter::BeginPlay()
		{
			Super::BeginPlay();

		}

		void APlayerCharacter::MoveForward(float AxisValue)
		{
			if ((Controller != nullptr) && (AxisValue != 0.0f))
			{
				// 앞쪽 찾기
				const FRotator Rotation = Controller->GetControlRotation();
				const FRotator YawRotation(0, Rotation.Yaw, 0);

				// 앞쪽 벡터 구하기
				const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
				AddMovementInput(Direction, AxisValue);
			}
		}

		void APlayerCharacter::MoveRight(float AxisValue)
		{
			if ((Controller != nullptr) && (AxisValue != 0.0f))
			{
				// 오른쪽 찾기
				const FRotator Rotation = Controller->GetControlRotation();
				const FRotator YawRotation(0, Rotation.Yaw, 0);

				// 오른쪽 벡터 구하기
				const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

				// 해당 방향으로 이동 추가
				AddMovementInput(Direction, AxisValue);
			}
		}

		void APlayerCharacter::BeginSprint()
		{
		GetCharacterMovement()->MaxWalkSpeed = 1000.0f;
		}

		void APlayerCharacter::EndSprint()
		{
			GetCharacterMovement()->MaxWalkSpeed = 600.f;
		}

		void APlayerCharacter::BeginCrouch()
		{
			Crouch();
		}

		void APlayerCharacter::EndCrouch()
		{
			UnCrouch();
		}

		// 프레임마다 호출
		void APlayerCharacter::Tick(float DeltaTime)
		{
			Super::Tick(DeltaTime);
		}

		//함수 기능을 입력에 바인딩하기 위해 호출
		void APlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
		{
			Super::SetupPlayerInputComponent(PlayerInputComponent);
			PlayerInputComponent->BindAxis("MoveForward",this, &APlayerCharacter::MoveForward);
			PlayerInputComponent->BindAxis("MoveRight", this, &APlayerCharacter::MoveRight);
			PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput);
			PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput);
			PlayerInputComponent->BindAction("Jump",IE_Pressed,this, &ACharacter::Jump);
			PlayerInputComponent->BindAction("Jump",IE_Released,this, &ACharacter::StopJumping);
			PlayerInputComponent->BindAction("Crouch",IE_Pressed,this,&APlayerCharacter::BeginCrouch);
			PlayerInputComponent->BindAction("Crouch",IE_Released,this,&APlayerCharacter::EndCrouch);
			PlayerInputComponent->BindAction("Sprint",IE_Pressed,this, &APlayerCharacter::BeginSprint);
			PlayerInputComponent->BindAction("Sprint",IE_Released,this, &APlayerCharacter::EndSprint);
		}

Copy full snippet

게임 모드는 게임의 여러 규칙을 정의합니다. 게임을 실행할 때 플레이어가 스폰되는 디폴트 폰(Pawn)도 이러한 규칙에 포함됩니다. 생성한 플레이어 캐릭터를 스폰하려면 규칙을 설정해야 합니다.

1. 콘텐츠 브라우저(Content Browser) 에서 추가/임포트(Add/Import) 버튼을 클릭하고 새로운 블루프린트(Blueprint) 클래스를 생성합니다. 이때 부모 클래스 선택(Pick a Parent Class) 메뉴가 나타나면 게임 모드 베이스(Game Mode Base) 를 선택하고, 새로운 게임 모드 클래스의 이름을 Bp_GameMode 로 지정합니다.

   이미지를 클릭하면 확대됩니다.

2. Bp_GameMode 를 더블클릭하여 클래스 디폴트를 연 다음, 디테일 패널의 클래스(Classes) 카테고리 로 이동하여 디폴트 폰 클래스(Default Pawn Class)로 Bp_PlayerCharacter 를 선택합니다.

   

3. 블루프린트를 컴파일(Compile) 하고 저장(Save) 합니다.

   

4. 편집(Edit) > 프로젝트 세팅(Project Settings) > 맵 & 모드(Maps & Modes) 로 이동하여 디폴트 모드(Default Modes) 카테고리 에서 Bp_GameMode 를 선택합니다.

   이미지를 클릭하면 확대됩니다.

게임 모드는 게임의 여러 규칙을 정의합니다. 게임을 실행할 때 플레이어가 스폰되는 디폴트 폰(Pawn)도 이러한 규칙에 포함됩니다. 생성한 플레이어 캐릭터를 스폰하려면 규칙을 설정해야 합니다.

1. 에디터(Editor)에서 C++ 클래스 폴더로 이동합니다. CharacterMovementGameModeBase를 우클릭하고 C++ 클래스 액션(C++ Class Actions) 메뉴 에서 CharacterMovementGameModeBase 기반 블루프린트 클래스 생성(Create Blueprint class based on your CharacterMovementGameModeBase) 을 선택하여 새로운 게임 모드 클래스의 이름을 Bp_GameMode** 로 지정합니다.

   이미지를 클릭하면 확대됩니다.

2. Bp_GameMode 를 더블클릭하여 클래스 디폴트 를 연 다음, 디테일 패널의 클래스(Classes) 카테고리 로 이동하여 디폴트 폰 클래스(Default Pawn Class)로 Bp_PlayerCharacter를 선택합니다.

   

3. 블루프린트를 컴파일(Compile) 하고 저장(Save) 합니다.

   

4. 편집(Edit) > 프로젝트 세팅(Project Settings) > 맵 & 모드(Maps & Modes) 로 이동하여 디폴트 모드(Default Modes) 카테고리 에서 Bp_GameMode 를 선택합니다.

   이미지를 클릭하면 확대됩니다.