QBCore Scripts: The Complete Guide for Server Owners (2026)
Everything you need to know about QBCore scripts — essential resources for every server, how to install and configure them, performance tips, and troubleshooting common issues.
What Is QBCore Framework?
QBCore (often written as qb-core) is one of the three major roleplay frameworks for FiveM, alongside ESX Legacy and the newer QBOX. Originally developed as a modern alternative to ESX, QBCore has grown into a fully featured framework used by thousands of servers in 2026.
Key characteristics of QBCore:
- Clean Lua architecture — Modular design with clear separation of concerns
- Built-in systems — Player management, jobs, gangs, inventory hooks, vehicle ownership
- Active development — Regular updates from the QBCore team and a large contributor base
- Growing ecosystem — Thousands of compatible scripts on GitHub and paid script platforms
If you are building a new FiveM server today, QBCore is one of the strongest choices — especially if you value clean code and active community support.
QBCore vs ESX vs QBOX — Quick Comparison
| Feature | QBCore | ESX Legacy | QBOX |
|---|---|---|---|
| Architecture | Modern, event-driven | Classic, table-based | Modular, performance-first |
| Script Ecosystem | Large and growing | Largest | Smallest (new) |
| Learning Curve | Medium | Low | Medium-High |
| Performance | Good | Good | Best |
| Community Size | Very large | Largest | Growing |
| Job System Built-in | Basic | Basic | Basic |
| Active Development | Yes | Yes | Yes |
All three frameworks provide a basic built-in job system with limited features. For a production roleplay server, most owners supplement the default system with a dedicated job management solution that provides in-game configuration, unlimited jobs, and advanced features like crafting, garages, and economy chains.
For a deeper framework comparison, read our ESX vs QBCore vs QBOX breakdown.
Essential QBCore Scripts Every Server Needs
Job System
QBCore ships with qb-core job definitions, but the built-in system is minimal — you define jobs in a config file and restart the server every time you change something. For a serious server, you need either:
- Custom Lua job scripts (requiring developer time), or
- A complete job management system like Jobs Creator that provides in-game creation, editing, grades, markers, shops, crafting, garages, armories, and boss menus — all without code
Jobs Creator is fully compatible with QBCore and uses the framework's native job and gang systems under the hood.
Inventory
The two most popular QBCore-compatible inventories are:
- ox_inventory — Modern, performant, and feature-rich. Uses metadata for item properties.
- qs-inventory — Feature-focused with a polished UI. Good drag-and-drop support.
- qb-inventory — The default QBCore inventory. Functional but more limited.
Vehicle System
- qb-garages — Default garage system for QBCore
- jg-advancedgarages — Advanced alternative with impound, key system, and more
Phone System
- qb-phone — Default phone with basic apps
- qs-smartphone — Premium phone with advanced features
- lb-phone — Popular premium option with extensive app support
Housing
- qb-houses — Basic housing system
- bcs-housing — Advanced housing with interior customization
How to Install QBCore Scripts Properly
Every QBCore script follows the same installation pattern:
Step 1: Download
Download the script from its source (GitHub, Tebex, or another platform). Extract the .zip if needed.
Step 2: Place in Resources
Move the script folder into your server's resources/ directory. Many servers organize resources into subfolders:
resources/
[qb]/
qb-core/
qb-radialmenu/
qb-target/
[standalone]/
ox_lib/
ox_inventory/
[jobs]/
advanced-jobs-creator/
Step 3: Add to server.cfg
Add ensure resource-name to your server.cfg file. Order matters — dependencies must load before the scripts that need them:
# Core (must load first)
ensure qb-core
ensure ox_lib
Database
ensure oxmysql
Inventory and items
ensure ox_inventory
Jobs and economy
ensure advanced-jobs-creator
Step 4: Import SQL
Many scripts include a .sql file. Import it into your database using phpMyAdmin, HeidiSQL, or the command line:
mysql -u root -p your_database < script_name.sql
Step 5: Configure
Open the script's config.lua (or config/ folder) and adjust settings for your server. With Jobs Creator, all configuration happens in-game through the tablet — no file editing needed.
For a complete walkthrough, see our script installation guide.
Performance Tips for QBCore Servers
- Use ox_lib — It provides optimized replacements for common QBCore functions like notifications, input dialogs, and targeting.
- Avoid redundant resources — Don't run two inventory systems or two phone scripts. Each adds tick time.
- Monitor resmon regularly — See our complete resmon optimization guide for step-by-step instructions.
- Update dependencies — Outdated versions of oxmysql, ox_lib, and qb-core often contain performance bugs that have been fixed in newer releases.
- Choose optimized scripts — Premium scripts like Jobs Creator are built with performance as a priority, maintaining 0.00 ms idle resmon.
Common QBCore Script Issues and Fixes
| Issue | Cause | Fix |
|---|---|---|
| "attempt to index a nil value (field '?')" | Script loaded before qb-core | Move ensure qb-core above the script in server.cfg |
| "No such export" | Missing dependency (often ox_lib) | Install the required dependency |
| Players have no money after restart | Database not properly connected | Check oxmysql connection string and SQL imports |
| Job not showing in-game | Job not registered in shared.lua or not ensured | Add job definition or use Jobs Creator for in-game management |
| Inventory items missing | Item metadata not in ox_inventory/data/items.lua | Register items in the inventory configuration |
| "Resource yielded during load" | Async operation in resource startup | Check fxmanifest.lua for correct script order |
Checklist: Is Your QBCore Server Production-Ready?
- ⬜ qb-core is on the latest stable release
- ⬜ ox_lib and oxmysql are installed and up to date
- ⬜ All resources load without errors in the server console
- ⬜ Job system supports in-game configuration (not just config files)
- ⬜ Database backups run daily via txAdmin or cron
- ⬜ Resmon shows no resource above 0.20 ms on the server
- ⬜ Player data persists correctly through server restarts
- ⬜ All framework exports and events fire correctly
Browse QBCore-Compatible Scripts
Alone Studios builds premium FiveM scripts with full QBCore compatibility. Every script is tested against the latest QBCore release and includes detailed documentation.
Ready to Transform Your Server?
FiveM Job Creator eliminates every problem discussed in this article. 0.00ms resmon. No-code configuration. ESX & QBCore native.
Get Job Creator on Tebex — €29.99