qbx_core (Qbox) for FiveM
A maintained fork of QBCore rebuilt on ox_lib and ox_inventory, with typed exports, semantic versioning and a much cleaner core.
Qbox exists because QBCore's codebase accumulated years of patches. qbx_core keeps the shape QBCore server owners know — player data, jobs, gangs, metadata — while replacing the plumbing with ox_lib, ox_inventory and oxmysql, and shipping proper releases instead of a moving main branch.
At a glance
| Maintainer | Qbox Project |
| Latest release | v1.24.0 · 2026-08-22 |
| Last code change | 2026-09-18 |
| Licence | see the repository |
| Written in | Lua |
| GitHub stars | 140 |
| Status | Active |
Figures read from the repository on 2026-09-22.
Why servers run it
- Real releases with version numbers, so you can tell which version a bug report is about.
- ox_lib and ox_inventory are dependencies rather than options, which removes a whole class of integration guesswork.
- The player object is close enough to QBCore's that most QBCore scripts run with small changes.
- TypeScript type definitions for the NUI side, and Lua type annotations for the exports.
Installing qbx_core (Qbox)
1. Install the ox stack first
oxmysql, ox_lib and ox_inventory are required, not optional. Start them before qbx_core.
2. Use the recipe or the release
Qbox ships a txAdmin recipe. If you are installing by hand, download the latest qbx_core release rather than cloning main.
3. Import the SQL
The release contains the schema. Qbox uses its own player table layout, so it is not a drop-in on top of an existing QBCore database without a migration.
4. Start in order
oxmysql, ox_lib, ox_inventory, qbx_core, then your own resources.
Working examples
Getting a player, Qbox style
local player = exports.qbx_core:GetPlayer(source)
if not player then return end
print(player.PlayerData.citizenid, player.PlayerData.job.name)Giving a weapon through ox_inventory
-- Qbox delegates inventory entirely to ox_inventory
exports.ox_inventory:AddItem(source, 'WEAPON_CUSTOMRIFLE', 1, {
durability = 100,
serial = exports.qbx_core:GetPlayer(source).PlayerData.citizenid,
})What goes wrong
It is not a drop-in QBCore replacement. Most scripts work, some need a bridge, and the database schema differs.
Do not install qb-inventory alongside it. Qbox expects ox_inventory; running both leaves two systems fighting over the same item events.
Pin a release. Qbox moves quickly. Running main on a live server means a breaking change can arrive on a git pull.
qbx_core (Qbox) — questions people ask
Should I migrate from QBCore to Qbox?
Where are the Qbox docs?
Runs alongside
The roleplay framework most new FiveM servers are built on, with the largest modern script ecosystem and a one-click txAdmin recipe.
The slot-based inventory most new FiveM servers start with, with first-class support for addon weapons, durability, metadata and shops.
The shared library half the modern FiveM ecosystem depends on: menus, notifications, progress bars, zones, callbacks and a cache.
A compatibility layer that lets one script run on ESX, QBCore, Qbox and ox_core without a fork per framework.