# Usable Items & Hooks

## RegisterUsableItem

Use a trusted server resource to attach behavior to an item:

```lua
exports.nord_inventory:RegisterUsableItem('repairkit', function(source, item, definition)
    -- validate your own resource state here
    -- return false to block the use
    return true
end)
```

The handler receives:

- player `source`;
- a copy of the item instance;
- a copy of the item definition.

Returning `false` blocks completion of the use.

## Hooks

Register a hook:

```lua
exports.nord_inventory:RegisterHook('beforeMoveItem', function(payload)
    if payload.to.type == 'evidence' and not IsAllowed(payload.source) then
        return false
    end
end)
```

Lowercase alias:

```lua
exports.nord_inventory:registerHook(...)
```

## Hook names used by the core

### `beforeMoveItem`

Payload includes:

```lua
{
    source = source,
    from = fromInventory,
    to = toInventory,
    item = item,
    amount = amount,
    fromSlot = fromSlot,
    toSlot = toSlot,
    txid = transactionId
}
```

Returning `false` blocks the move.

### `afterMoveItem`

Receives the same move payload after a successful move.

### `beforeUseItem`

```lua
{
    source = source,
    inventory = inventory,
    item = item,
    definition = definition
}
```

Returning `false` blocks use.

### `afterUseItem`

Receives the use payload after successful item handling.