한 캐릭터가 여러 종류의 무기(권총, 소총, 저격총 등)를 사용한다고 하면, 각 무기 타입마다 애니메이션이 다를 것이다. 이것을 각 무기마다 Anim Graph에 직접 노드를 추가한다면 유지보수가 매우 어려워지게 된다.
언리얼의 Lyra 프로젝트의 경우도 무기가 여러 종류가 있는데, "Anim Layer Interface"를 사용해서 각 무기별 애니메이션 로직을 레이어별로 분리하여 처리하였다. 이 설계 방향은 무기나 상태 확장에 유연하고 애니메이션 그래프의 복잡도가 크게 감소하게 된다.
✅ Anim Layer Interface 생성 및 적용
에디터에서 Animation Layer Interface를 생성하고 클래스 이름을 "ALI_Hero"로 명명하였다. 기본 Animation Layer 이름을 "ArmedLocomotionState"로 변경해주었고, 이게 설정 끝이다.
기본적으로 설정되어있는 ABP_Hero에서 Property Access 노드를 추가한다. OwningHeroCharacter→HeroCombatComponent→CurrentEquippedWeaponTag를 설정한다.
Locomotion을 다음과 같이 정리한다. 현재 이 AnimInstance를 소유하고 있는 캐릭터의 CombatComponent에 접근하여, 현재 장착중인 무기 Tag를 확인한다. 유효하다면 ArmedLocomotionState를 사용하고 현재 장착 중인 무기가 없다면, 비무장 Locomotion으로 설정한다.
마지막으로 앞서 만들었던 Animation Layer Interface인 ALI_Hero를 설정해준다 이 인터페이스로 무기별로 AnimInstance가 달라도 하나의 인터페이스로 공통 동작을 호출할 수 있게 된다.
✅ Anim Layer Interface를 상속 받은 ABP_Layer 구현
이전에 AnimInstacne 구조 설계할 때 생성했던 "WarriorHeroLinkedAnimLayer" 클래스로 각 무기 전용 Anim Layer(ABP)를 만들 것이다.
🔹 WarriorHeroLinkedAnimLayer.h
#pragma once
#include "CoreMinimal.h"
#include "AnimIstances/RPGBaseAnimInstance.h"
#include "WarriorHeroLinkedAnimLayer.generated.h"
class UWarriorHeroAnimInstance;
UCLASS()
class RPG_API UWarriorHeroLinkedAnimLayer : public URPGBaseAnimInstance
{
GENERATED_BODY()
public:
UFUNCTION(BlueprintPure, meta = (BlueprintThreadSafe))
UWarriorHeroAnimInstance* GetHeroAnimInstance() const;
};
지금 만든 "MasterAnimLayer_Hero" 클래스를 상속받는 ABP 클래스를 생성한다. 이 클래스를 상속받는 ABP가 각 무기마다 전용 Animation을 담는 클래스가 될 것이다.
이 Axe 무기 전용 Layer에 BlendSpace만 설정해준다. 앞선 포스팅에서 BlendSpace 1D 만드는 과정을 서술했으므로 BS를 만드는 과정은 따로 정리하지 않는다.
✅ 각 무기 클래스에 AnimLayer 정보 저장
각 무기마다 AnimLayer(ABP 클래스)를 저장해놓고, 특정 무기를 들었을 때 해당 ABP를 캐릭터에 동적으로 연결해줌으로써, 자동으로 무기별 전용 애니메이션이 동작하게 만드는 구조이다.
먼저 프로젝트 전체 구조체를 정리할 클래스를 만들고 그 안에 AnimLayer를 저장할 구조체를 선언한 뒤, 무기에 해당 구조체를 멤버변수로 가지고 있게할 것이다. 이후 GA_EquipAxe와 같은 Ability에서 무기를 장착하면 SkeletalMesh에 AnimLayer를 연결해주도록 한다.
🔹RPGStructTypes.h
#pragma once
#include "RPGStructTypes.generated.h"
class UWarriorHeroLinkedAnimLayer;
USTRUCT(BlueprintType)
struct FRPGHeroWeaponData
{
GENERATED_BODY()
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly)
TSubclassOf<UWarriorHeroLinkedAnimLayer> WeaponAnimLayerToLink;
};
방금 만들었던 도끼 전용 AnimLayer와 같이 무기별 AnimLayer를 담을 수 있는 구조체를 선언하였다.
🔹 WarriorHeroWeapon.h
#pragma once
#include "CoreMinimal.h"
#include "Items/Weapons/RPGWeaponBase.h"
#include "RPGTypes/RPGStructTypes.h"
#include "WarriorHeroWeapon.generated.h"
UCLASS()
class RPG_API AWarriorHeroWeapon : public ARPGWeaponBase
{
GENERATED_BODY()
public:
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "WeaponData")
FRPGHeroWeaponData HeroWeaponData;
};
플레이어 무기 클래스에 앞서 만든 구조체 타입 변수를 선언해준다.
🔹 HeroCombatComponent.h
#pragma once
#include "CoreMinimal.h"
#include "Components/Combat/PawnCombatComponent.h"
#include "HeroCombatComponent.generated.h"
class AWarriorHeroWeapon;
UCLASS()
class RPG_API UHeroCombatComponent : public UPawnCombatComponent
{
GENERATED_BODY()
public:
UFUNCTION(BlueprintCallable, Category = "RPG|Combat")
AWarriorHeroWeapon* GetHeroCarriedWeaponByTag(FGameplayTag InWeaponTag) const;
};
GA에서 HeroCombatComponet를 가져와서 Tag기반으로 바로 무기 클래스를 가져와, 무기 클래스 안의 AnimLayer 데이터를 가져올텐데 조금 더 BP에서 코드를 단순화 하기 위해, HeroWeapon타입으로 캐스팅해 반환하는 헬퍼 함수를 작성해주었다.
컴파일 후, 에디터로 돌아와 "GA_Hero_EquipAxe"에 해당 무기안에 AnimLayer 데이터를 가져와서 연결시켜주었다. 그리고 Hero Combat Component에 현재 장착중인 무기의 Tag를 설정해주었다.
마지막으로 해당 무기에 AnimLayer 데이터를 할당해준다.
🔔 테스트 결과
무기가 계속 추가되더라도 기존 메인으로 사용되는 "ABP_Hero"에서 수정하는 것이 아닌, "MasterAnimLayer_Hero" 클래스를 상속 받은 "AnimLayer_HeroAxe"와 같은 무기 전용 ABP를 만들어서 무기에 넣어주기만 하면 자동으로 해당 애니메이션이 재생되는 구조가 되었다. 이로써 슈팅 게임에서 권총 혹은 소총, 저격총 등 여러 무기를 장착했을 때 개별적인 애니메이션을 보다 더 쉽게 적용시킬 수 있을 것 같다.
