> ## 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.

# Item added

> Hook activado cuando se agrega un ítem a un inventario.

Se activa cuando se agrega un ítem a un inventario. Regístralo con [`registerHook`](/es/jaksam-inventory/hooks#registrar-un-hook) usando el nombre de event `onItemAdded`.

### Payload

| Campo | Tipo de Dato | Descripción |
| - | - | - |
| `inventoryId` | string | p. ej. `"player:1"` |
| `itemName` | string | p. ej. `"bread"` |
| `amount` | number | Cantidad agregada |
| `metadata` | table \| nil | Metadatos del ítem, puede ser nil |
| `slotId` | number | Slot al que se agregó el ítem |

### Ejemplos

<AccordionGroup>
  <Accordion title="Una mochila por jugador">
    ```lua theme={null}
    exports['jaksam_inventory']:registerHook("onItemAdded", function(payload)
        local backpackCount = exports["jaksam_inventory"]:getTotalItemAmount(payload.inventoryId, "backpack")
        if backpackCount >= 1 then
            return false, "You can only have one backpack"
        end
    end, {
        itemNameFilter = {backpack = true},
        inventoryTypeFilter = {player = true}
    })
    ```
  </Accordion>

  <Accordion title="Filtrar por nombre de inventario específico">
    ```lua theme={null}
    -- Solo activar cuando se agregan ítems al stash de policía
    exports['jaksam_inventory']:registerHook("onItemAdded", function(payload)
        print("Item added to police stash:", payload.itemName)
    end, {
        inventoryFilter = {"stash_police"}
    })
    ```
  </Accordion>
</AccordionGroup>

Consulta [Descripción general de Hooks](/es/jaksam-inventory/hooks) para la API de `registerHook`, los filtros disponibles y el comportamiento de los valores de retorno.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.