QBCORE INTEGRATION#

Overview#

When using QBCore, onex-creation:

• Handles all qb-clothing events
• Uses QBCore's money system for purchases
• Integrates with QBCore's player data for appearance storage

Requirements#

Ensure these QBCore resources are running:

server.cfg
Copy
ensure qb-core
ensure ox_lib
ensure onex-base
ensure onex-interaction
ensure onex-creation

Framework Detection#

Framework is automatically detected. No manual configuration needed:

modules/framework/shared/framework.lua
Copy
-- Auto-detection via GlobalState
-- GlobalState.xframework = 'qb' (set by onex-base)

Replaced Events#

onex-creation handles these qb-clothing events:

CreateFirstCharacter#

Your Script
Copy
-- Triggers new character creation
TriggerEvent('qb-clothes:client:CreateFirstCharacter')

-- Or use onex-creation directly
TriggerEvent('onex-creation:client:CreateNewChar')

Load Player Clothing#

Your Script
Copy
-- Load saved appearance
TriggerEvent('qb-clothing:client:loadPlayerClothing', skin)

-- Or use onex-creation directly
TriggerEvent('onex-creation:client:loadPedSkin', skin)

Open Menu#

Your Script
Copy
-- Open clothing menu
TriggerEvent('qb-clothing:client:openMenu')

-- Or use onex-creation with type
exports['onex-creation']:openCreationMenu('clothes')

Character Creation Integration#

Multi-Character Support#

Works with qb-multicharacter:

qb-multicharacter/client/main.lua
Copy
-- When creating new character, call:
TriggerEvent('qb-clothes:client:CreateFirstCharacter')
-- onex-creation handles this event

Spawn Integration#

Works with qb-spawn or similar:

Spawn Script
Copy
RegisterNetEvent('qb-spawn:client:spawned', function()
    -- Load player appearance
    local skin = QBCore.Functions.GetPlayerData().charinfo.skin
    if skin then
        TriggerEvent('qb-clothing:client:loadPlayerClothing', skin)
    end
end)

Job Outfits#

Configure job outfits for QBCore jobs:

config/shop.lua
Copy
Shop.JobOutfits = {
    ["police"] = {
        label = "Los Santos Police Department",
        outfits = {
            {
                label = "Patrol Officer",
                minGrade = 0,  -- QBCore job grade
                outfit = {
                    torso = { collection = "base", localIndex = 55, texture = 0 },
                    pants = { collection = "base", localIndex = 25, texture = 0 },
                    shoes = { collection = "base", localIndex = 10, texture = 0 }
                }
            },
            {
                label = "Sergeant",
                minGrade = 3,
                outfit = { ... }
            }
        }
    },
    ["ambulance"] = {
        label = "Los Santos EMS",
        outfits = {
            {
                label = "EMT",
                minGrade = 0,
                outfit = { ... }
            }
        }
    }
}

Using Exports#

All exports work the same regardless of framework:

Your Script
Copy
-- Open creation menu
exports['onex-creation']:openCreationMenu('clothes')

-- Get current appearance
local appearance = exports['onex-creation']:FetchPlayerClothes()

-- Load skin on ped
exports['onex-creation']:LoadPedSkin(appearance, PlayerPedId())

-- Load custom outfit(job uniform)
exports['onex-creation']:loadCustomOutfit(outfit, true)  -- true = persist

Notifications#

Configure notification system:

modules/framework/shared/framework.lua
Copy
Framework.Notify = {
    name = 'onex-interaction'  -- or 'qb-notify'
}

Common QBCore Integrations#

qb-inventory#

Your Script
Copy
-- When giving clothing item from inventory
RegisterNetEvent('qb-inventory:client:ItemBox', function(itemData, type)
    if itemData.name == 'outfit_item' then
        local outfit = json.decode(itemData.info.outfit)
        exports['onex-creation']:loadCustomOutfit(outfit, false)
    end
end)

qb-target#

Shop zones work with qb-target if onex-interaction is not preferred:

Your Script
Copy
exports['qb-target']:AddBoxZone("clothing_shop", vector3(72.25, -1399.10, 29.37), 2.0, 2.0, {
    name = "clothing_shop",
    heading = 0,
    minZ = 28.37,
    maxZ = 31.37
}, {
    options = {
        {
            type = "client",
            event = "onex-creation:client:openCreationMenu",
            icon = "fas fa-tshirt",
            label = "Open Clothing Store",
            shopType = "clothes"
        }
    },
    distance = 2.0
})

Next Steps#