✍️Today I Learned

📅 2025-11-11

• 인벤토리 슬롯 구조 개선 및 아이템 인스턴스 통합

• 부패 시스템 구현 (만료 시간 계산 및 자동 변환)

• 소비 아이템 사용 시 GAS 어빌리티 자동 활성화

• 델리게이트 로직 통합으로 중복 코드 제거

  ---

인벤토리 슬롯 구조 개선 및 아이템 인스턴스 통합

FSlotStructMaster 구조체를 리팩토링하여 데이터 관리를 단순화했다.

변경 사항:

• FItemInstance 타입의 ItemData 필드 추가하여 정적/동적 데이터를 통합 관리
• ExpirationTime 필드 추가하여 아이템 부패 만료 시간 추적
• 기존 StaticDataID, DynamicDataID 필드 제거로 구조 단순화

이전에는 정적 ID와 동적 ID를 따로 관리했지만, FItemInstance 하나로 아이템 정보를 캡슐화하여 코드 가독성과 유지보수성을 개선했다.

---

부패 시스템 구현 (만료 시간 계산 및 자동 변환)

아이템이 시간이 지나면 부패하는 시스템을 구현했다.

구현 내용:
1. OnDecayTick(): 주기적으로 호출되어 만료된 아이템을 체크
2. ConvertToDecayedItem(): 만료된 아이템을 부패 아이템(ID: 0)으로 변환
3. UpdateExpirationTime(): 스택 추가 시 가중평균으로 만료 시간 재계산

// 새 아이템과 기존 아이템의 만료 시간을 가중평균으로 계산
double UpdateExpirationTime(double CurrentExpirationTime, int 
CurrentStack,
                            int NewItemStack, float DecayRate)
{
    double NewItemExpirationTime = GetWorld()->GetTimeSeconds() + 
DecayRate;
    return (CurrentExpirationTime * CurrentStack + 
NewItemExpirationTime * NewItemStack) 
           / (CurrentStack + NewItemStack);
}

아이템을 스택에 추가할 때 기존 아이템의 남은 시간과 새 아이템의 만료 시간을 가중평균 내어 공정하게 계산했다.

---

소비 아이템 사용 시 GAS 어빌리티 자동 활성화

소비 아이템 사용 시 연결된 Gameplay Ability를 자동으로 활성화하도록 구현했다.

구현 순서
1. Internal_UseItem()에서 아이템 데이터 조회
2. FItemData에 AbilityBP가 설정되어 있는지 확인
3. ASC(AbilitySystemComponent)를 통해 어빌리티 부여 및 즉시 활성화
4. 아이템 스택 감소 처리

  if (ItemInfo.AbilityBP)
  {
      FGameplayAbilitySpec Spec(ItemInfo.AbilityBP, 1, 0);
      ASC->GiveAbilityAndActivateOnce(Spec);
  }

체력 회복 물약, 버프 아이템 등을 사용하면 자동으로 효과가 발동되도록 연동했다.

---

델리게이트 로직 통합으로 중복 코드 제거

인벤토리 변경 및 핫키 활성화 시 델리게이트 브로드캐스트 로직을 헬퍼 함수로 통합했다.

추가한 함수

• HandleInventoryChanged(): 인벤토리 변경 시 OnInventoryUpdated 델리게이트 브로드캐스트
• HandleActiveHotkeyIndexChanged(): 핫키 변경 시 OnHotkeyActivated 델리게이트 브로드캐스트 및 장착/해제 처리

기존에는 각 RPC 함수와 OnRep_* 콜백마다 델리게이트를 직접 호출했는데, 헬퍼 함수로 추출하여 중복을 제거하고 일관성을 확보했다.

또한 방어구 슬롯 타입 검증 로직(CanPlaceItemInSlot)을 추가하여 머리 슬롯에는 헬멧만, 몸통 슬롯에는 갑옷만 장착되도록 검증했다.

---

💡 느낀 점 (What I Felt)

리슨서버 멀티플레이 환경에서 인벤토리 시스템을 구현하면서 복제(Replication)와 서버 권한(Authority) 패턴의 중요성을 깊이 이해하게 되었다.

부패 시스템에 가중평균 만료 시간 계산을 적용했다. 단순히 새 아이템의 만료 시간으로 덮어쓰면 불공정하고, 최소값을 쓰면 모든 아이템이 급격히 썩어버리는데, 가중평균을 쓰니 자연스럽고 현실적인 부패가 가능했다.

또한 FItemInstance로 구조를 단순화하면서 코드가 훨씬 깔끔해졌다.
GiveAbilityAndActivateOnce()로 어빌리티를 일회성으로 실행하여 아이템 사용을 구현했다.

다만 아직 거리 체크 검증이 빠져 있어서 악의적인 클라이언트가 멀리 있는 상자를 조작할 수 있는 보안 취약점이 있다. 상호작용 컴포넌트에 거리 체크를 추가해야겠다.