✍️Today I Learned

📅 2025-11-26

• 인벤토리 컴포넌트 편의 함수 구현 (GetItemCount, ConsumeItem, AddItem 오버로드)
• 제작 시스템과 인벤토리 연동을 위한 인터페이스 완성

---

인벤토리 컴포넌트 편의 함수 구현

📌 구현 내용

제작 시스템에서 필요로 하는 인벤토리 조작 함수들을 추가로 구현했다:

1. GetItemCount - 특정 아이템 총 개수 조회

int32 UTSInventoryMasterComponent::GetItemCount(int32 StaticDataID) const
{
    int32 ResultCount = 0;
    
    // 핫키 인벤토리 탐색
    for (const FSlotStructMaster& Slot : HotkeyInventory.InventorySlotContainer)
    {
        if (Slot.ItemData.StaticDataID == StaticDataID)
        {
            ResultCount += Slot.CurrentStackSize;
        }
    }
    
    // 가방 인벤토리 탐색 (가방이 활성화된 경우만)
    if (GetCurrentBagSlotCount() == 0)
    {
        return ResultCount;
    }
    for (const FSlotStructMaster& Slot : BagInventory.InventorySlotContainer)
    {
        if (Slot.ItemData.StaticDataID == StaticDataID)
        {
            ResultCount += Slot.CurrentStackSize;
        }
    }
    
    return ResultCount;
}

특징:

• const 함수로 읽기 전용 보장
• 핫키 + 가방 인벤토리의 모든 슬롯을 순회하며 집계
• 가방이 비활성화된 경우 조기 반환으로 성능 최적화

2. ConsumeItem - 특정 아이템 소비

void UTSInventoryMasterComponent::ConsumeItem(int32 StaticDataID, int32 Quantity)
{
	// 핫키 인벤토리 탐색
	for (int32 i = 0; i < HotkeyInventory.InventorySlotContainer.Num(); ++i)
	{
		FSlotStructMaster& Slot = HotkeyInventory.InventorySlotContainer[i];
		if (Slot.ItemData.StaticDataID == StaticDataID)
		{
			int32 ToRemove = FMath::Min(Quantity, Slot.CurrentStackSize);
			RemoveItem(EInventoryType::HotKey, i, ToRemove);
			Quantity -= ToRemove;
			if (ActiveHotkeyIndex == i)
			{
				HandleActiveHotkeyIndexChanged();
			}
			if (Quantity <= 0)
			{
				break;
			}
		}
	}
	// 가방 인벤토리 탐색
	if (GetCurrentBagSlotCount() > 0)
	{
		for (int32 i = 0; i < BagInventory.InventorySlotContainer.Num(); ++i)
		{
			FSlotStructMaster& Slot = BagInventory.InventorySlotContainer[i];
			if (Slot.ItemData.StaticDataID == StaticDataID)
			{
				int32 ToRemove = FMath::Min(Quantity, Slot.CurrentStackSize);
				RemoveItem(EInventoryType::BackPack, i, ToRemove);
				Quantity -= ToRemove;
				if (Quantity <= 0)
				{
					break;
				}
			}
		}
	}
	HandleInventoryChanged();
}

설계 의도:

• 핫키 인벤토리 → 가방 인벤토리 순서로 소비 (접근성 높은 순서)
• 활성 핫키 슬롯의 아이템이 소비되면 장착 상태 갱신
• 전체 소비 완료 후 한 번만 HandleInventoryChanged() 호출

3. AddItem 오버로드 - int32 버전 추가

bool UTSInventoryMasterComponent::AddItem(const int32 StaticDataID, int32 Quantity, int32& OutRemainingQuantity)
{
    FItemInstance ItemData = FItemInstance(StaticDataID, GetWorld()->GetTimeSeconds());
    return AddItem(ItemData, Quantity, OutRemainingQuantity);
}

편의성:

• 제작 시스템에서 StaticDataID만으로 아이템 추가 가능
• 서버 시간 자동 설정으로 부패 시스템 연동
• 기존 FItemInstance 버전 AddItem을 재사용

🎯 제작 시스템과의 연동 완성

이제 제작대에서 다음과 같이 사용 가능:

// 제작 가능 여부 확인
bool ATSCraftingTable::CanCraft(int32 RecipeID, ATSCharacter* InstigatorCharacter)
{
    for (const FIngredientData& Ingredient : RecipeData.Ingredients)
    {
        int32 ItemCount = PlayerInventoryComp->GetItemCount(Ingredient.MaterialID);
        if (ItemCount < Ingredient.Count)
        {
            return false;  // 재료 부족
        }
    }
    return true;
}

// 제작 실행
void ATSCraftingTable::StartCrafting(int32 RecipeID, ATSCharacter* InstigatorCharacter)
{
    // 재료 소비
    for (const FIngredientData& Ingredient : RecipeData.Ingredients)
    {
        PlayerInventoryComp->ConsumeItem(Ingredient.MaterialID, Ingredient.Count);
    }
    
    // 결과물 생성
    int32 RemainingQuantity;
    InventoryComp->AddItem(RecipeData.ResultItemID, RecipeData.ResultCount, RemainingQuantity);
}

---

💡 느낀 점 (What I Felt)

오버로드 함수의 편의성을 체감했다. AddItem(int32, ...) 버전 하나 추가했을 뿐인데, 제작 시스템 코드가 훨씬 간결해졌다. FItemInstance를 매번 생성하지 않아도 되니 코드 가독성도 좋아졌다.

위젯쪽에서 현재 부족한 재료 아이템의 경우에는 한눈에 볼 수 있도록 표시를 하거나 "제작 실패 → 사용자 피드백"까지 이어지도록 반환값으로 성공 여부를 전달하거나, 에러 델리게이트를 추가하는 방식을 고려해봐야겠다.

---