How to Install QBox on FiveM (qbx_core + ox Stack)

QBox is the modern, actively-maintained successor to QBCore, built on the ox ecosystem — the recommended framework for new FiveM roleplay servers in 2026. This guide covers how to install QBox.

Prerequisites

• A FiveM server on artifact build 10731 or newer.
• OneSync enabled.
• A MySQL/MariaDB database (database setup guide).

The easy way: txAdmin recipe

The simplest install is the QBox txAdmin recipe, which automatically installs qbx_core, ox_lib, ox_inventory and oxmysql and runs the required SQL. On managed hosting this is a few clicks. For most people, this is the way to go.

The manual way: the ox stack

QBox is built on the ox resources, which must be installed and started in this exact order, checking each starts cleanly before the next:

ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure qbx_core
ensure ox_target

1. Download qbx_core from the Qbox-project GitHub, plus oxmysql, ox_lib, ox_inventory and ox_target.
2. Place them in resources and set your oxmysql connection string.
3. Run the qbx_core.sql file to create QBox’s tables.
4. Set the framework convar to exactly qbx (a typo fails silently).

Two gotchas to avoid

• Collation: if your player.citizenid column isn’t utf8mb4_unicode_ci, the SQL fails — fix the collation first.
• Don’t run two inventories: ox_inventory will conflict with any old inventory script. Remove the old one fully before ox_inventory takes over.

Migrating from QBCore?

QBox is a QBCore fork with a documented migration path, but scripts may need QBox-compatible versions. See our ESX vs QBCore vs QBox comparison for why QBox is the recommended modern choice. The quickest start overall is a managed FiveM server with the QBox recipe.

Frequently asked questions

How do I install QBox on FiveM?

Easiest is the QBox txAdmin recipe (auto-installs qbx_core + the ox stack + SQL). Manually, install oxmysql, ox_lib, ox_inventory, qbx_core and ox_target in that order, run qbx_core.sql, and set the framework convar to qbx.

What artifact does QBox need?

Server artifact build 10731 or newer, with OneSync enabled.

Why does qbx_core.sql fail?

Commonly a collation issue — the citizenid column must be utf8mb4_unicode_ci. Fix the collation and re-run.