✍️Today I Learned

📅 2025-12-05

• 아이템 상세데이터 표시 정보 관리를 위한 GameInstanceSubsystem 구현

---

아이템 상세데이터 표시 정보 관리를 위한 GameInstanceSubsystem 구현

📌 문제 상황

빌딩/크래프팅 위젯의 결과물 상세페이지에서 스탯을 표시할 때 각 스탯과 효과마다 표시 용어가 다름

• "체력 회복", "Health Recovery" 같은 다국어 표시명
• "초", "%", "개" 같은 단위
• 아이템 카테고리(TOOL, WEAPON, ARMOR, CONSUMABLE)마다 보여줄 스탯이 다름
• 하드코딩하면 관리가 어렵고 확장성이 떨어짐

🎯 해결 방법

DeveloperSettings + GameInstanceSubsystem + DataTable 조합으로 중앙 관리 시스템 구축

1. DeveloperSettings로 DT 경로 관리

// GameplayTagDisplaySettings.h
UCLASS(Config=Game, DefaultConfig)
class UGameplayTagDisplaySettings : public UDeveloperSettings
{
    UPROPERTY(Config, EditAnywhere)
    TSoftObjectPtr<UDataTable> GameplayTagDisplayDataTable;
};

• Project Settings에서 DT 경로를 설정 가능
• 하드코딩 없이 에디터에서 변경 가능

2. GameInstanceSubsystem에서 초기화 & 캐싱

void UGameplayTagDisplaySubsystem::Initialize(FSubsystemCollectionBase& Collection)
{
    const UGameplayTagDisplaySettings* Settings = GetDefault<UGameplayTagDisplaySettings>();
    GameplayTagDisplayTable = Settings->GameplayTagDisplayDataTable.LoadSynchronous();
    
    // TMap으로 캐싱 (O(1) 조회)
    TArray<FGameplayTagDisplayData*> Rows;
    DataTable->GetAllRows<FGameplayTagDisplayData>(TEXT("LoadDataTable"), Rows);
    for (FGameplayTagDisplayData* Row : Rows)
    {
        CachedDisplayData.Add(Row->Tag, *Row);
    }
}

3. 위젯에서 실제 사용

void UItemInfo::UpdateCraftingItemStatView(const FItemData& ItemData)
{
    TagDisplaySubsystem = UGameplayTagDisplaySubsystem::Get(this);
    ItemStatView->ClearListItems();
    
    switch (ItemData.Category)
    {
    case EItemCategory::TOOL:
        // 채취 유형 - 여러 태그를 쉼표로 연결
        UStatDataObject* StatData = NewObject<UStatDataObject>();
        StatData->StatName = TagDisplaySubsystem->GetDisplayName_KR(TAG_Display_Stat_HarvestTarget);
        StatData->StatValue = TagDisplaySubsystem->GetDisplayNamesFromContainer_KR(
            ItemData.ToolData.HarvestTargetTag);
        ItemStatView->AddItem(StatData);
        
        // 공격력 - 값 + 단위 포맷팅
        GetStatData_KR(*StatData, TAG_Display_Stat_AttackDamage, ItemData.ToolData.DamageValue);
        ItemStatView->AddItem(StatData);
        break;
    }
}

void UItemInfo::GetStatData_KR(UStatDataObject& OutStatData, const FGameplayTag& StatTag, const float& StatValue)
{
    FGameplayTagDisplayData DisplayData;
    if (TagDisplaySubsystem->GetDisplayData(StatTag, DisplayData))
    {
        OutStatData.StatName = DisplayData.DisplayName_KR;
        OutStatData.StatValue = FText::AsNumber(StatValue);
        OutStatData.StatUnit = TagDisplaySubsystem->GetUnit(StatTag); // "초", "%", "개" 등
    }
}

🔑 핵심 포인트

1. DeveloperSettings 활용: 에디터에서 직접 DT 경로 설정, 코드 수정 없이 변경 가능
2. Initialize에서 캐싱: 런타임마다 DT를 순회하지 않고 TMap으로 O(1) 조회
3. Static Get() 헬퍼: WorldContextObject만 있으면 어디서든 접근 가능
4. 유틸리티 함수 제공:
   • GetDisplayName_KR/EN - 단일 태그 표시명
   • GetDisplayNamesFromContainer_KR - 여러 태그를 쉼표로 연결
   • GetUnit - 단위만 가져오기
   • GetDisplayData - 전체 데이터 한 번에
5. ListView와의 조합: UStatDataObject를 동적으로 생성해서 AddItem → 카테고리별로 다른 스탯 표시

📂 구조

Settings (에디터) → Subsystem (캐싱) → Widget (사용)
     ↓                    ↓                ↓
  DT 경로 설정      Initialize에서      Get()으로 접근
                  TMap에 캐싱         GetDisplayName_KR()

---

💡 느낀 점 (What I Felt)

처음엔 효과 태그, 스탯 별로 출력할 이름과 단위를 매핑하는 함수를 만들다가 효과가 추가되거나 이름을 변경하고 싶을 때 불편함이 커질것 같아 데이터 테이블로 관리하는 방식을 선택했다. 그리고 데이터 테이블에서 데이터를 가져오기 위해 게임인스턴스 서브시스템을 사용했다.

그리고 위젯에서 아이템 카테고리별로 분기 처리하는 부분이 좀 지저분해 보이긴 하는데 이건 나중에 팩토리 패턴으로 개선해봐야겠다.

---