Skip to Content
FrameworksQboxOverview

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 resourceqbx_core
RepositoryQbox-project/qbx_core 
LicenseGPL-3.0 text (GitHub reports it as “Other”)
Stars140 (2026-09-16)
Latest releasev1.24.0 (2026-08-22)
DatabaseMariaDB 10.9.0 or newer
Default inventoryox_inventory
Documentationdocs.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:

ResourceRole
ox_libUI, 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_core rather than being separate resources, and are configured through convars in server.cfg.
  • Multi-job and multi-gang write to a player_groups table. 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+) and CREATE INDEX IF NOT EXISTS (10.9.0+).

Full structure reference →

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

Next steps