Best Practices

// Player double-clicks item in inventory
void EquipFromInventory(int32 InventorySlot)
{
    FItemInstance Item = InventoryComponent->GetItemAtIndex(InventorySlot);

    if (!Item.IsEmpty() && Item.ItemData->bIsEquipable)
    {
        // Find valid slot
        TArray<int32> ValidSlots = EquipmentComponent->FindValidSlotsForItem(Item);
        if (ValidSlots.Num() > 0)
        {
            // Equip to first valid slot
            bool bSuccess = EquipmentComponent->EquipItemToSlot(Item, ValidSlots[0]);
            if (bSuccess)
            {
                // Remove from inventory
                InventoryComponent->RemoveItemAtIndex(InventorySlot, 1);
            }
        }
    }
}

// Right-click equipped item to unequip
void UnequipToInventory(int32 EquipmentSlot)
{
    FItemInstance EquippedItem = EquipmentComponent->GetEquippedItem(EquipmentSlot);

    if (!EquippedItem.IsEmpty())
    {
        // Check if inventory has space
        if (InventoryComponent->GetEmptySlotCount() > 0)
        {
            // Unequip (returns to inventory automatically)
            EquipmentComponent->UnequipItemFromSlot(EquipmentSlot);
        }
        else
        {
            ShowNotification("Inventory full");
        }
    }
}

// Press 1 to equip weapon from hotbar
void QuickEquipWeapon(int32 HotbarSlot)
{
    FItemInstance Item = HotbarComponent->GetItemAtIndex(HotbarSlot);

    if (!Item.IsEmpty() && Item.ItemData->bIsWeapon)
    {
        int32 MainHandSlot = EquipmentComponent->FindSlotIndexByTag(
            FGameplayTag::RequestGameplayTag("Equipment.Slot.MainHand")
        );

        // Unequip current weapon
        EquipmentComponent->UnequipItemFromSlot(MainHandSlot);

        // Equip new weapon
        EquipmentComponent->EquipItemToSlot(Item, MainHandSlot);
    }
}