해당 문서는 인벤토리 시스템을 구현한 내용이다.

현재 서버 연동이 없는 상태에서 클라이언트가 임시적으로 처리하고 있으며, 향후 서버 추가 시 수정될 구조를 고려하여 설계가 되었다.

아이템 정보 및 조작

Item ToolTip (툴팁)

Item Divide (나누기)

인벤토리 정렬 및 이동

Item Category (필터링)

Item Drag&Drop, Sort (정렬 및 이동)

주요 기능

• 아이템 이동
  • 드래그 앤 드롭을 통한 아이템 이동 기능 구현
  • 아이템을 드레그하여 다른 슬롯으로 이동 가능하며, UI와 데이터 동기화가 즉시 반영됨
• 아이템 정렬
  • 등급(레어도), 아이템 타입(소모품, 장비 등), TableID 기준으로 정렬 기능 제공
• 아이템 필터링
  • 아이템 타입에 따른 필터링 기능 추가
  • 카테고리별 필터링을 적용하여 사용자가 원하는 아이템을 손쉽게 찾을 수 있도록 구현
• 아이템 나누기 및 병함
  • 아이템을 나누고, 스택 가능한 아이템의 경우 병합할 수 있도록 구현
  • 특정 키 입력 시 아이템 나누기 UI를 표시하고 사용자의 입력을 받아 분할 수행
  • 병합 시 스텍 제한을 고려하여 최대치를 초과하지 않도록 설계
• 아이템 툴팁
  • 아이템에 따라 툴팁을 동적으로 생성하여 표시
  • UMG 기반의 툴팁 위젯을 사용하여 아이템별 고유 정보를 실시간으로 제공하며, 다른 UI에서도 활용 가능

아이템 데이터 구조

• 아이템 데이터는 서버와 동기화되며, GUID 기반으로 관리되어 중복 아이템을 구별할 수 있도록 설계됨

• 데이터 구조

  tableNo	ItemName	Grade	ItemType	BindType	CanSell	ItemDesc	ResourcePath	CanStack	MaxStackCount
  int	string	int	ItemType	BindType	bool	string	string	bool	int

UI/UX 고려 사항

• 아이템 이동
  • 아이템 이동 시 전체 데이터를 갱신하지 않고, 변경된 데이터만 업데이트하여 성능 최적화
  • 슬롯 스왑 또는 병합 여부를 자동 감지하여 유연한 UI 제공
• 아이템 필터링
  • UI의 필터 버튼을 사용하여 원하는 카테고리(장비, 소비, 아이템 등)만 표시 가능
• 아이템 병합, 나누기
  • 특정 키 입력 시 아이템 나누기 UI를 표시하고 사용자의 입력을 받아 분할 수행
  • 병합 시 스택 제한을 고려하여 최대치를 초과하지 않도록 설계
• 아이템 툴팁
  • 툴팁이 휘발성이 아닌, 지속적으로 활성화되거나 유저가 직접 확인할 수 있는 기능 제공
  • 인벤토리뿐만 아니라 다른 UI에서도 쉽게 활용 가능하도록 구조 설계

서버 연동 및 확장성

• 서버 연동 시 아이템 데이터 요청 흐름
  1. 클라이언트 접속 시, 서버에서 인벤토리 데이터 요청
  2. 서버는 현재 보유 중인 아이템 리스트를 반환
  3. 클라이언트는 받은 데이터를 기반으로 인벤토리 UI 업데이트
  4. 아이템 사용/삭제/이동 시 서버에 요청을 보내고 응답을 기반으로 최종 처리
• 서버 데이터 검증 방식
  • 클라이언트는 서버 응답을 받은 후 아이템 상태를 변경하는 방식 적용
  • 서버에서 소지 가능 개수 여부 등을 데이터 검증을 수행한 후 최종 데이터를 클라이언트에 반영
  • 데이터 불일치 발생 시 클라이언트가 서버 데이터를 강제 동기화하는 기능을 제공
  • 서버에서 검증 후 변경된 데이터를 클라이언트에 반영하는 방식 적용

아이템 데이터 갱신

• 로그인 또는 인벤토리 동기화 요청이 들어오면 서버 데이터와 동기화

• 주요 코드

  void UPTUserData_Inventory::UpdateSlotData(const TArray<FInventoryItem>& ServerInventory)
  {
      if (ServerInventory.IsEmpty())
          return;
  
      InventoryData.Reset();
      ItemIDToGUIDMap.Reset();
  
      for (const FInventoryItem& InvenItem : ServerInventory)
      {
          InventoryData.Add(InvenItem.GUID, InvenItem);
          ItemIDToGUIDMap.FindOrAdd(InvenItem.ItemID).Add(InvenItem.GUID);
      }
  
      UpdateUI();
  }

아이템 이동 및 병합

• 드래그 앤 드롭을 통해 아이템을 이동 또는 병합할 수 있도록 구현

• 주요코드

  void UPTInventoryWidget::OnCellDropped(UPTItemCell_Drag* DraggedCell, UPTItemDragOperation* DragDropOperation)
  {
      if (!DragDropOperation)
          return;
  
      UPTItemCell_Inventory* TargetCell = Cast<UPTItemCell_Inventory>(DraggedCell);
      UPTItemCell_Inventory* SelectCell = Cast<UPTItemCell_Inventory>(DragDropOperation->SourceCell);
      if (TargetCell == SelectCell)
          return;
  
      MergeOrSwapItem(SelectCell, TargetCell);
  }

아이템 나누기

• 특정 개수만큼 아이템을 분할하는 기능 구현

• 주요 코드

  void UPTUserData_Inventory::DivideItemData(FString ItemGUID, int32 DivideCount)
  {
      if (ItemGUID.IsEmpty() || DivideCount <= 0)
          return;
  
      FInventoryItem* Item = InventoryData.Find(ItemGUID);
      if (!Item || Item->Count < DivideCount)
          return;
  
      Item->Count -= DivideCount;
      FInventoryItem NewItem = *Item;
      NewItem.GUID = FGuid::NewGuid().ToString();
      NewItem.Count = DivideCount;
      InventoryData.Add(NewItem.GUID, NewItem);
  
      UpdateUI();
  }