Qbox Framework Overview
Qbox is a hard fork of QBCore, rebuilt on the Overextended stack. It keeps QBCore’s data model and vocabulary — citizen ids, jobs, gangs, cash and bank accounts — and replaces the plumbing underneath.
Current state
| Core resource | qbx_core |
| Repository | Qbox-project/qbx_core |
| License | GPL-3.0 text (GitHub reports it as “Other”) |
| Stars | 140 (2026-09-16) |
| Latest release | v1.24.0 (2026-08-22) |
| Database | MariaDB 10.9.0 or newer |
| Default inventory | ox_inventory |
| Documentation | docs.qbox.re |
qbx_core, not qbox_core
The resource and repository are named qbx_core, with the qbx_ prefix.
Guides that tell you to ensure qbox_core or clone qbox-project/qbox_core
are wrong — the organisation is Qbox-project and the resource is qbx_core.
Every Qbox resource follows the same prefix: qbx_garages, qbx_vehiclekeys,
qbx_management, qbx_policejob, and so on.
Built on the ox stack
This is the substantive difference from QBCore. Qbox depends on:
| Resource | Role |
|---|---|
| ox_lib | UI, callbacks, caching, zones, utilities |
| ox_inventory | Inventory, shops, stashes |
| ox_target | Third-eye interaction |
| oxmysql | Database driver |
You are therefore learning two APIs, not one. The upside is that ox_lib and
ox_inventory knowledge carries over to ox_core and ND Core.
Differences from QBCore
- Job and gang grades are numbers, not strings. This is the single most common conversion bug.
- Multicharacter, queue, multi-job and Discord rich presence are built into
qbx_corerather than being separate resources, and are configured through convars inserver.cfg. - Multi-job and multi-gang write to a
player_groupstable. External multijob resources will corrupt data. - Access is through exports, not a shared core object:
exports.qbx_core:GetPlayer(source). - MariaDB 10.9.0 is a hard floor — the core uses
JSON_VALUE()(10.6.1+) andCREATE INDEX IF NOT EXISTS(10.9.0+).
Who it is for
Servers that want QBCore’s ecosystem and script compatibility but a more modern
technical foundation, and teams that are already comfortable with ox_lib.
Most QBCore scripts port to Qbox with modest edits, and the Qbox team maintains a compatibility bridge for the common cases. Paid scripts increasingly ship a Qbox build alongside the QBCore one.
Documentation
- docs.qbox.re — installation, resource reference, guides
- qbx_core exports
- Converting from QBCore
- FAQ
Next steps
- Install Qbox
- Qbox structure
- Framework migration — coming from QBCore