Phone cases

BuildPhoneCaseMetadata

Build metadata on the server for a unified phone case item. Call this after the custom case resource has registered its designs. Use plain for a solid-color case.

local metadata, reason = exports.yseries:BuildPhoneCaseMetadata('blue', 'plain')
if not metadata then
    print('Cannot create phone case: ' .. tostring(reason))
    return
end

local added = exports.ox_inventory:AddItem(playerId, 'phone_case', 1, metadata)

The first argument is a configured color ID; the second is a registered design ID or plain. Success returns a table containing color, design, colorName, designLabel, label, and description. Custom designs always include their registered readable name in designLabel and the item label/description.

Invalid colors return nil, 'invalid_request'; unavailable designs return nil, 'design_unavailable'. This helper does not add an item or bypass model compatibility and IMEI restrictions, which are checked when equipping.

For a QB-family inventory, pass the returned table as item info using that inventory's AddItem API. See Phone cases for all modes, item definitions, shop setup, and inventory compatibility.