QBox Setup

Complete guide for setting up 0r-multicharacterv3 with QBox (qbx_core) framework.

✅ Requirements

• qbx_core (latest version)

• ox_lib

• oxmysql

• A compatible inventory (ox_inventory recommended)

• A compatible clothing script

---

🚀 Quick Setup

QBox is designed to work seamlessly with modern resources. Setup is minimal.

Step 1: Disable Default Multicharacter

# server.cfg
# ensure qbx_multicharacter  <-- Comment out or remove
ensure 0r-multicharacterv3

Step 2: Start Order

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure bl_appearance
ensure 0r-multicharacterv3

---

🗄️ Database

QBox uses the same players table structure as QBCore:

Column	Usage
citizenid	Unique character identifier
cid	Character slot number
license	Player identifier (license2)
charinfo	Character information (JSON)
job	Job data (JSON)
money	Money data (JSON)
position	Last position (JSON)

QBox uses license2 instead of license for player identification.

---

🔧 Framework Functions

The script uses QBox exports:

-- Login
exports.qbx_core:Login(source, citizenid, newData)

-- Get Player
exports.qbx_core:GetPlayer(source)

-- Logout
exports.qbx_core:Logout(source)

---

🏠 Spawn Integration

qbx_spawn

If using qbx_spawn:

Config.SpawnSelector = 'qbx_spawn'

This triggers:

TriggerClientEvent('qb-spawn:client:setupSpawns', playerId)

---

⚡ Events

Server Events

QBox uses the same events as QBCore:

-- When player loads character
AddEventHandler('QBCore:Server:PlayerLoaded', function(Player)
    -- Works with QBox
end)

-- When player unloads
AddEventHandler('QBCore:Server:OnPlayerUnload', function(src)
    -- Works with QBox
end)

---

🔄 Character Deletion

Configure in config/database.lua:

Database.List = {
    ['qbx_core'] = {
        { table = 'players', column = 'citizenid', type = 'citizenid' },
        { table = 'playerskins', column = 'citizenid', type = 'citizenid' },
        { table = 'player_vehicles', column = 'citizenid', type = 'citizenid' },
        -- Add more tables as needed
    }
}

---

📋 Complete Configuration

-- config/config.lua for QBox

Config.Debug = false
Config.DeveloperMode = false
Config.Locale = 'en'
Config.HideRadar = true
Config.DefaultCharacterSlots = 2
Config.SkipWarning = false
Config.DisableDeleteCharacter = false

-- Use built-in spawn or qbx_spawn
Config.SkipSpawnSelector = false
Config.SpawnSelector = 'qbx_spawn'  -- or '0r-spawn'
Config.ApartmentStart = false

---

🆚 QBCore vs QBox Differences

Feature	QBCore	QBox
Player ID	license	license2
Exports	qb-core	qbx_core
Spawn	qb-spawn	qbx_spawn
Modern Lua	No	Yes

---

❓ Troubleshooting

"Player not found" error

QBox uses license2:

1. Verify player has Steam/license2

2. Check database for correct identifier

Commands not refreshing

QBox handles commands differently. The RefreshCommand function is empty for QBox as it's not needed.

Compatibility with QBCore resources

Many QBCore resources work with QBox. The script triggers the same events:

• QBCore:Server:OnPlayerLoaded

• QBCore:Client:OnPlayerLoaded