> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jaksam-scripts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get item by name

> Ruft das erste in einem Inventar gefundene Item mit diesem Namen ab, mit optionaler Metadaten-Filterung.

Ruft das erste in einem Inventar gefundene Item mit diesem Namen ab, mit optionaler Metadaten-Filterung.

<CodeGroup>
  ```lua Export theme={null}
  exports['jaksam_inventory']:getItemByName(inventoryId, itemName, metadata)
  ```

  ```lua Example theme={null}
  -- Erstes Brot-Item im Inventar des Spielers abrufen
  local playerId = 1
  local item, slotId = exports['jaksam_inventory']:getItemByName(playerId, 'bread')

  if item then
      print('Found bread in slot:', slotId)
      print('Amount in this slot:', item.amount)
      print('Item metadata:', json.encode(item.metadata))
  end

  -- Waffe mit bestimmter Seriennummer abrufen
  local weapon, weaponSlot = exports['jaksam_inventory']:getItemByName(playerId, 'WEAPON_PISTOL', {
      serial = "ABC123"
  })

  if weapon then
      print('Found weapon in slot:', weaponSlot)
      print('Weapon ammo:', weapon.metadata.ammo)
  end
  ```
</CodeGroup>

### Parameter

| Name          | Datentyp         | Beschreibung                                                                                                                 |
| ------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `inventoryId` | string \| number | Die zu durchsuchende Inventar-ID. Kann eine Spieler-Server-ID (number) oder Inventar-ID (string) sein                        |
| `itemName`    | string           | Der Name des zu suchenden Items                                                                                              |
| `metadata`    | table            | Metadaten, gegen die bei der Suche abgeglichen wird. Falls angegeben, werden nur Items mit passenden Metadaten zurückgegeben |

### Rückgabewert

| Name     | Datentyp      | Beschreibung                                                                                             |
| -------- | ------------- | -------------------------------------------------------------------------------------------------------- |
| `item`   | table \| nil  | Das erste passende gefundene Item, oder nil falls nicht gefunden                                         |
| `slotId` | number \| nil | Die rohe Slot-ID, in der das Item gefunden wurde (1-basierter Index), nil falls kein Item gefunden wurde |


## Related topics

- [Get items by name](/de/jaksam-inventory/functions/server/get-items-by-name.md)
- [Get item by name](/de/jaksam-inventory/functions/client/get-item-by-name.md)
- [Server](/de/jaksam-inventory/functions/server/index.md)
- [Client](/de/jaksam-inventory/functions/client/index.md)