> For the complete documentation index, see [llms.txt](https://kazescripts.gitbook.io/kazescripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kazescripts.gitbook.io/kazescripts/kaze_phonepro/items.md).

# Items

The phone and SIM items for every inventory, with images.

kaze\_phonepro uses 6 items. Images for all of them are in `INSTALL/inv_img` — copy them into your inventory's image folder (for ox\_inventory: `ox_inventory/web/images`).

| Item           | Label           | Prop               |
| -------------- | --------------- | ------------------ |
| `phone`        | Black Titanium  | `kzp_phone_black`  |
| `phone_white`  | White Titanium  | `kzp_phone_white`  |
| `phone_desert` | Desert Titanium | `kzp_phone_desert` |
| `phone_blue`   | Blue Titanium   | `kzp_phone_blue`   |
| `phone_red`    | Kaze Red        | `kzp_phone_red`    |
| `sim_card`     | SIM card        | —                  |

The phone colours, labels and props are set in `Config.Phone.Models`. The SIM item name is `Config.Carrier.SimItem`.

{% tabs %}
{% tab title="ox\_inventory" %}
Add to `ox_inventory/data/items.lua`:

```lua
['phone'] = { label = 'Phone', weight = 190, stack = false, consume = 0, client = { export = 'kaze_phonepro.usePhone' } },
['phone_white'] = { label = 'Phone (White)', weight = 190, stack = false, consume = 0, client = { export = 'kaze_phonepro.usePhone' } },
['phone_desert'] = { label = 'Phone (Desert)', weight = 190, stack = false, consume = 0, client = { export = 'kaze_phonepro.usePhone' } },
['phone_blue'] = { label = 'Phone (Blue)', weight = 190, stack = false, consume = 0, client = { export = 'kaze_phonepro.usePhone' } },
['phone_red'] = { label = 'Phone (Kaze Red)', weight = 190, stack = false, consume = 0, client = { export = 'kaze_phonepro.usePhone' } },
['sim_card'] = { label = 'SIM card', weight = 5, stack = false, consume = 0, client = { export = 'kaze_phonepro.useSim' } },
```

{% endtab %}

{% tab title="qb-inventory / ps-inventory" %}
Add to `qb-core/shared/items.lua`:

```lua
phone        = { name = 'phone',        label = 'Phone',            weight = 190, type = 'item', image = 'phone.png',        unique = true, useable = true, shouldClose = true, description = 'Kaze Phone Pro' },
phone_white  = { name = 'phone_white',  label = 'Phone (White)',    weight = 190, type = 'item', image = 'phone_white.png',  unique = true, useable = true, shouldClose = true, description = 'Kaze Phone Pro' },
phone_desert = { name = 'phone_desert', label = 'Phone (Desert)',   weight = 190, type = 'item', image = 'phone_desert.png', unique = true, useable = true, shouldClose = true, description = 'Kaze Phone Pro' },
phone_blue   = { name = 'phone_blue',   label = 'Phone (Blue)',     weight = 190, type = 'item', image = 'phone_blue.png',   unique = true, useable = true, shouldClose = true, description = 'Kaze Phone Pro' },
phone_red    = { name = 'phone_red',    label = 'Phone (Kaze Red)', weight = 190, type = 'item', image = 'phone_red.png',    unique = true, useable = true, shouldClose = true, description = 'Kaze Phone Pro' },
sim_card     = { name = 'sim_card',     label = 'SIM card',         weight = 5,   type = 'item', image = 'sim_card.png',     unique = true, useable = true, shouldClose = true, description = 'A Kaze Mobile SIM' },
```

The items are registered as usable automatically.
{% endtab %}

{% tab title="ESX" %}
Add the items to your `items` table with the same names. They are registered as usable automatically.

{% hint style="info" %}
The default ESX inventory has no item metadata, so each character runs **one** phone. With metadata inventories every phone item is its own phone.
{% endhint %}
{% endtab %}
{% endtabs %}

## How phone items work

* The first time a phone item is used it gets its own metadata: `{ phoneId, number, owner }`. The inventory shows its number.
* All data belongs to the phone: setup, passcode, Face ID, settings, contacts, calls, messages, gallery, notes and the Chirp account. Giving the phone to someone gives them that phone, locked by its passcode.
* A character's first phone keeps the character's number. Later phones get a new number.
* With several phones in one inventory, using an item opens that phone. The open key opens the last one used.