Framework & Inventory
QuanticPhone supports 7 frameworks and 6+ inventory systems through bridge files, requiring zero core code changes when switching.
Framework
lua
Config.Framework = "auto"
-- Options: "auto" | "esx" | "qb" | "ox" | "vrp" | "vrp2" | "creative" | "standalone" | "aura"| Value | Framework | Notes |
|---|---|---|
| "auto" | Auto-detect | Checks for ESX, QBCore and Ox in order at startup |
| "esx" | ESX / ESX Legacy | Compatible with ESX v1.9+ |
| "qb" | QBCore / QBox | Latest QBCore or QBox supported |
| "ox" | OxCore | Modern async-first framework |
| "vrp" | vRP | Original vRP framework |
| "vrp2" | vRP2 | vRP2 (standalone mode) |
| "creative" | Creative | Native vRP with Creative extension |
| "standalone" | Standalone | No framework — phone available to all players |
| "aura" | Aura | Aura framework support |
Leave
Config.Framework = "auto" unless you have a specific reason to pin a value. Auto-detection is reliable and avoids config drift.Phone item
lua
Config.Item = {
Require = true, -- player must have the item in inventory
Name = "cellphone", -- item name in your inventory system
Unique = true, -- each item has its own unique phone number in metadata
Inventory = "inventory", -- inventory system (see below)
DefaultPhone = "Iphonepromax", -- default phone model
}| Key | Default | Description |
|---|---|---|
| Require | true | When true, the player must carry the cellphone item to use the phone |
| Name | "cellphone" | The exact item name as registered in your inventory resource |
| Unique | true | Each physical item stores its own phone number in metadata — ideal for servers with multiple phones per player |
| DefaultPhone | "Iphonepromax" | Model used when no specific phone item is detected |
Inventory system
lua
Config.Item.Inventory = "inventory" -- set to your inventory resource name| Value | Resource | Notes |
|---|---|---|
| "inventory" | Generic / auto | Auto-detects ox_inventory, qb-inventory or qs-inventory |
| "ox_inventory" | ox_inventory | Force Ox Inventory |
| "qb-inventory" | qb-inventory | Force QBCore Inventory |
| "qs-inventory" | qs-inventory | Force QS Inventory |
| "core_inventory" | core_inventory | Core Inventory support |
| "mf-inventory" | mf-inventory | MF Inventory support |
| "codem-inventory" | codem-inventory | Codem Inventory support |
After changing the inventory, restart the resource and verify the item is usable. Some inventories require the item registered with
client: "UsePhoneItem" in their item definition.Phone models
Define multiple phone items that each map to a specific visual model. Each entry in Config.Item.Phones is an item name → model name pair:
lua
Config.Item.Phones = {
["cellphone"] = "Iphonepromax",
["cellphone_black"] = "IphoneBlack",
["cellphone_gold"] = "IphoneGold",
["cellphone_red"] = "IphoneRed",
["cellphone_blue"] = "IphoneBlue",
["cellphone_green"] = "IphoneGreen",
["cellphone_purple"] = "IphoePurple",
["cellphone_white"] = "IphoneWhite",
["cellphone_pink"] = "IphonePink",
["cellphone_yellow"] = "IphoneYellow",
}Add more entries to support additional phone skins. The model name must match an asset available in your server.