Items

Three kinds, and only the first one is required: the phone, optionally a charger, and optionally fourteen cases.

The names are yours — every one of them is a line in the config — but these are the defaults, and the icons that ship with the resource are named after them.

---

The phone

-- shared/config.lua
Config.Open = {
    RequireItem = true,      -- false lets anybody open it: fine while you are trying it out
    Item        = 'phone',
    UseItem     = true,      -- using it from the inventory opens the phone
}

Most ESX and QB setups already have a phone item. If yours does not:

ox_inventory

-- ox_inventory/data/items.lua
['phone'] = {
    label = 'Phone',
    weight = 190,
    stack = false,
    close = true,
    description = 'A phone that folds.',
},

qb-core

-- qb-core/shared/items.lua
phone = { name = 'phone', label = 'Phone', weight = 190, type = 'item', image = 'phone.png',
          unique = true, useable = true, shouldClose = true, description = 'A phone that folds.' },

Note

With Config.Device on, the phone is the item: a fresh one is a new phone with a new number, and one that changes hands takes everything on it. That needs stack = false / unique = true, which is why both blocks above have it.

---

The charger

Only if the battery is on (shared/config/battery.lua, off by default).

Charger = { Item = 'phone_charger', Minutes = 25, Consume = false },

ox_inventory

['phone_charger'] = { label = 'Phone Charger', weight = 120, stack = true, close = false },

qb-core

phone_charger = { name = 'phone_charger', label = 'Phone Charger', weight = 120, type = 'item',
                  image = 'phone_charger.png', unique = false, useable = true, shouldClose = false },

Consume = false means it is a charger rather than a battery pack: it keeps working.

---

The fourteen cases

Only if Config.Prop.Fold.Cases.Enabled is true. Off, colours are a free preference in Settings and none of this is needed — see 📦 Cases and colours.

Items = {
    black    = 'phone_case_black',    natural = 'phone_case_natural',
    white    = 'phone_case_white',    blue    = 'phone_case_blue',
    gold     = 'phone_case_gold',     green   = 'phone_case_green',
    graphite = 'phone_case_graphite', silver  = 'phone_case_silver',
    rose     = 'phone_case_rose',     purple  = 'phone_case_purple',
    red      = 'phone_case_red',      sierra  = 'phone_case_sierra',
    mint     = 'phone_case_mint',     orange  = 'phone_case_orange',
},

ox_inventory

-- fourteen of these, one per colour
['phone_case_blue'] = { label = 'Blue Case', weight = 20, stack = false, close = true },

qb-core

phone_case_blue = { name = 'phone_case_blue', label = 'Blue Case', weight = 20, type = 'item',
                    image = 'phone_case_blue.png', unique = true, useable = true, shouldClose = true },

The icons are already drawn. Fourteen 100×100 PNGs, one per colour, named phone_case_<colour>.png. Copy them into your inventory’s image folder — ox_inventory/web/images/ for ox.

Take a line out of Items and that colour stops existing: not hidden, gone. Where the cases are sold is your city’s business; the phone does not put a shop anywhere.

---

After adding items

Your inventory has to be restarted to see new items.

Caution

Restarting ox_inventory while players are connected wedges their client. invBusy stays true and every search hangs for ever, so the phone will not open.

Restart it a second time. The first restart is the one that breaks the connected client and the second is the one it survives. Nobody has to reconnect, and clearing the state bag by hand is not enough.