Framework · Qbox Project

qbx_core (Qbox) for FiveM

What it is

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.

Official documentation Repository All resources

At a glance

MaintainerQbox Project
Latest releasev1.24.0 · 2026-08-22
Last code change2026-09-18
Licencesee the repository
Written inLua
GitHub stars140
StatusActive

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. 1. Install the ox stack first

    oxmysql, ox_lib and ox_inventory are required, not optional. Start them before qbx_core.

  2. 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. 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. 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?
For a new server, Qbox is the cleaner start. For a live server with paid scripts, the migration cost is real and depends entirely on whether your scripts have Qbox builds.
Where are the Qbox docs?
docs.qbox.re — including a well-written page specifically on installing custom weapons with ox_inventory.

Runs alongside

qb-core (QBCore)

The roleplay framework most new FiveM servers are built on, with the largest modern script ecosystem and a one-click txAdmin recipe.

ox_inventory

The slot-based inventory most new FiveM servers start with, with first-class support for addon weapons, durability, metadata and shops.

ox_lib

The shared library half the modern FiveM ecosystem depends on: menus, notifications, progress bars, zones, callbacks and a cache.

community_bridge

A compatibility layer that lets one script run on ESX, QBCore, Qbox and ox_core without a fork per framework.