> ## 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 total item amount

> Gibt die Gesamtmenge eines bestimmten Items in einem Inventar zurück, inklusive Items in Behältern.

Gibt die Gesamtmenge eines bestimmten Items in einem Inventar zurück, inklusive Items in Behältern.

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

  ```lua Example theme={null}
  -- Gesamtmenge Brot im Inventar abrufen
  local total = exports['jaksam_inventory']:getTotalItemAmount(1, 'bread')

  -- Menge mit bestimmten Metadaten abrufen
  local total = exports['jaksam_inventory']:getTotalItemAmount(1, 'weapon_pistol', {
      serial = "ABC123"
  })

  -- Menge ohne Behälter abrufen
  local total, totalNoContainers = exports['jaksam_inventory']:getTotalItemAmount(1, 'bread', nil, true)
  ```
</CodeGroup>

### Parameter

| Name             | Datentyp         | Beschreibung                                                                                                                             |
| ---------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `inventoryId`    | string \| number | Die zu prüfende Inventar-ID                                                                                                              |
| `itemName`       | string           | Der Name des zu zählenden Items                                                                                                          |
| `metadata`       | table            | Metadaten, gegen die beim Zählen abgeglichen werden (falls angegeben, werden nur Items mit gleicher Metadata UND gleichem Namen gezählt) |
| `skipContainers` | boolean          | Bei true werden Items in Behältern nicht mitgezählt                                                                                      |

### Rückgabewert

| Name                            | Datentyp      | Beschreibung                                                                               |
| ------------------------------- | ------------- | ------------------------------------------------------------------------------------------ |
| `totalAmount`                   | number        | Gesamtmenge des Items im Inventar, inklusive Behälter (nur falls skipContainers false ist) |
| `totalAmountContainersExcluded` | number \| nil | Gesamtmenge ohne Behälter (nur falls skipContainers false ist)                             |


## Related topics

- [Get total item amount](/de/jaksam-inventory/functions/client/get-total-item-amount.md)
- [Item added](/de/jaksam-inventory/hooks/on-item-added.md)
- [Client](/de/jaksam-inventory/functions/client/index.md)
- [Server](/de/jaksam-inventory/functions/server/index.md)
- [Get items by name](/de/jaksam-inventory/functions/server/get-items-by-name.md)