[Unreal][C++] 아이템 획득, 착용

캐릭터에 장착 가능한 아이템을 획득한 후 착용하는 것을 구현할 것이다.

 

1. 아이템 생성

여러 종류의 아이템을 관리할 Base C++ Class를 생성했다. 이 클래스에선 타입, 레벨, 머터리얼, 콜리전 등 공통으로 사용될 기능들을 관리한다. 각 아이템마다 다르게 구현되어야 하는 것(스태틱 메시 등)들은 블루프린트 클래스를 생성하여 그 안에서 관리되도록 방향을 잡았다.

 

아이템마다 타입이 다르고, 같은 타입의 아이템이라도 레벨이 다르기 때문에 타입과 레벨을 선언했다.

 

UENUM(BlueprintType)
enum class EItemType : uint8
{
	HAT,
	BAG,
	KEY,
	GADGET,
	MAX
};

UPROPERTY(EditAnywhere)
EItemType Type = EItemType::HAT;

UPROPERTY()
int Level = 1;

 

그 외에도 스태틱 메시와 콜리전도 추가했다.

 

UPROPERTY(EditAnywhere)
UStaticMeshComponent* StaticMesh;

UPROPERTY(EditAnywhere)
UBoxComponent* CollisionBox;

UFUNCTION()
void OnBeginOverlap(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);

UFUNCTION()
void OnEndOverlap(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);

AItem::AItem()
{
    CollisionBox = CreateDefaultSubobject<UBoxComponent>(TEXT("BoxComponent"));
    RootComponent = CollisionBox;
    CollisionBox->SetBoxExtent(FVector(15, 15, 15));
    CollisionBox->SetCollisionProfileName(TEXT("OverlapOnlySurvivor"));
    CollisionBox->OnComponentBeginOverlap.AddDynamic(this, &AItem::OnBeginOverlap);
    CollisionBox->OnComponentEndOverlap.AddDynamic(this, &AItem::OnEndOverlap);

    StaticMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("ItemMesh"));
    StaticMesh->AttachToComponent(RootComponent, FAttachmentTransformRules::KeepRelativeTransform);
    StaticMesh->SetCollisionProfileName(TEXT("NoCollision"));
    StaticMesh->bReceivesDecals = false;
}

• 콜리전의 OverlapOnlySurvivor은 커스텀 콜리전 프리셋으로 오직 캐릭터와만 Overlap 반응을 한다.
• 스태틱 메시는 생성자에서 컴포넌트 생성만 하고 있어 블루프린트 클래스에서 추가 설정이 필요하다.
• 생성자에서 콜리전 컴포넌트 생성 시 사이즈를 설정했지만, 각 아이템마다 크기가 다를 수 있으므로 블루프린트 클래스에서 추가로 스태틱 메시에 맞게 수정이 필요하다.

 

2. 아이템 획득

캐릭터와 아이템이 충돌하면 아이템을 캐릭터 내 InventoryComponent에 넘긴다. 여러 개의 아이템과 충돌될 가능성이 있기 때문에 InventoryComponent 내에서 순서를 관리하기 위해 이러한 구조로 구현했다.

 

void AItem::OnBeginOverlap(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
{
    ASurvivorCharacter* OtherCharacter = Cast<ASurvivorCharacter>(OtherActor);
    if (OtherCharacter)
    {
        OtherCharacter->InventoryComponent->BeginOverlap(this);
    }
}

void AItem::OnEndOverlap(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex)
{
    ASurvivorCharacter* OtherCharacter = Cast<ASurvivorCharacter>(OtherActor);
    if (OtherCharacter)
    {
        OtherCharacter->InventoryComponent->EndOverlap(this);
    }
}

 

이렇게 받은 아이템을 InventoryComponent의 PickItemArray에 저장한 후, 캐릭터가 획득 버튼을 누르면 가장 먼저 저장된 아이템이 획득되게 된다.

 

void UInventoryComponent::BeginOverlap(AItem* Item)
{
	PickItemArray.Add(Item);
}

void UInventoryComponent::EndOverlap(AItem* Item)
{
	PickItemArray.Remove(Item);
}

bool UInventoryComponent::Input()
{
	bool Pick = false;

	if (PickItemArray.Num() > 0)
	{
		AItem* OverlapItem = PickItemArray[0];
        
		...

		if (Pick)
		{
			PickItemArray.RemoveAt(0);
			OverlapItem->Destroy();
		}
	}

	return Pick;
}

 

이제 아이템 획득 입력 구현이 필요하다. 캐릭터 입력은 이미 향상된 입력을 사용하여 구현되어 있기 때문에 여기에 아이템 획득 입력 액션만 추가할 것이다.

 

아이템 획득 입력 액션은 키를 눌렀는지 여부만 필요해서 bool 타입으로 설정했다.

 

아이템 획득 입력 액션

 

생성한 입력 액션을 캐릭터에 적용할 것이다. 획득 입력이 들어오면, 캐릭터에 땅에 서있거나 걷고 있는 상태인지 체크한다. 획득 가능한 상태라면 InventoryComponent의 Input() 함수를 호출하고 정상적으로 획득이 되었다면 true를 반환받는다. 그 후 애니메이션 재생을 위해 캐릭터 상태를 ITEM_PICK로 변경한다.

 

아이템 획득 애니메이션

 

UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Input, meta = (AllowPrivateAccess = "true"))
UInputMappingContext* DefaultMappingContext;

UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Input, meta = (AllowPrivateAccess = "true"))
UInputAction* ItemPickAction;

void ASurvivorCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
	// Set up action bindings
	if (UEnhancedInputComponent* EnhancedInputComponent = Cast<UEnhancedInputComponent>(PlayerInputComponent)) {

		EnhancedInputComponent->BindAction(LookAction, ETriggerEvent::Triggered, this, &ASurvivorCharacter::Look);
		EnhancedInputComponent->BindAction(WalkAction, ETriggerEvent::Triggered, this, &ASurvivorCharacter::Walk);
		EnhancedInputComponent->BindAction(RunAction, ETriggerEvent::Started, this, &ASurvivorCharacter::Run);
		EnhancedInputComponent->BindAction(RunAction, ETriggerEvent::Completed, this, &ASurvivorCharacter::Run);
		EnhancedInputComponent->BindAction(ItemPickAction, ETriggerEvent::Started, this, &ASurvivorCharacter::ItemPick);
        ...
	}
	else
	{
		UE_LOG(LogTemplateCharacter, Error, TEXT("'%s' Failed to find an Enhanced Input component! This template is built to use the Enhanced Input system. If you intend to use the legacy system, then you will need to update this C++ file."), *GetNameSafe(this));
	}
}

void ASurvivorCharacter::ItemPick(const FInputActionValue& Value)
{
	if (State == ECharacterState::LAND)
	{
		if (InventoryComponent->Input())
		{
			SetECharacterState(ECharacterState::ITEM_PICK);
		}
	}
}

 

3. 아이템 장착

UInventoryComponent 내부에서 아이템 획득 후 장착 아이템이면 캐릭터에게 장착 요청을 한다. 캐릭터 내 아이템 메시의 Visible을 활성화하고 획득한 아이템 레벨에 맞게 Matarial을 변경한다.

 

void ASurvivorCharacter::ItemPutOn(EItemType Type, int Level)
{
	if (GetItemCount(Type, Level) == 0)
		return;

	...

	if (Type == EItemType::HAT) {
		HatMesh->SetVisibility(true);
		HatMesh->SetMaterial(0, ItemMaterials[Level - 1]);
	}
	else if (Type == EItemType::BAG) {
		BagMesh->SetVisibility(true);
		BagMesh->SetMaterial(0, ItemMaterials[Level - 1]);
		...
	}
}

 

여기서 HatMesh와 BagMesh는 소켓에 붙도록 설정이 필요하다. 그래야 캐릭터 애니메이션에 맞게 아이템 메시도 움직이게 된다.

 

HatMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("HatMesh"));
HatMesh->SetupAttachment(GetMesh(), FName("Hat"));
HatMesh->SetCollisionProfileName(TEXT("NoCollision"));
HatMesh->SetVisibility(false);
HatMesh->bReceivesDecals = false;

BagMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("BagMesh"));
BagMesh->SetupAttachment(GetMesh(), FName("Bag"));
BagMesh->SetCollisionProfileName(TEXT("NoCollision"));
BagMesh->SetVisibility(false);
BagMesh->bReceivesDecals = false;

 

아이템 근처에서 키를 누르면 해당 아이템을 착용한다.

 

아이템 장착 완료