Qbox is het nieuwste grote RP-framework voor FiveM en de directe opvolger van QBCore. Het is gebouwd door ontwikkelaars uit de QBCore-community die het framework wilden moderniseren zonder de ballast van achterwaartse compatibiliteit. In dit artikel leest u wat Qbox anders doet, hoe de migratie vanaf QBCore werkt en wanneer het framework de juiste keuze is.
Wat is Qbox?
Qbox is een open-source RP-framework dat voortbouwt op de architectuur van QBCore maar vrijwel elke component heeft herschreven of vervangen. De kern is lichter, de code is beter gestructureerd en de standaardcomponenten komen uit het ox-ecosysteem: ox_lib, ox_inventory, ox_target en ox_fuel.
Het project staat op GitHub onder de Qbox Project-organisatie en wordt actief onderhouden. In 2026 is Qbox het snelst groeiende FiveM-framework qua commits en nieuwe contributies.
Wat verandert ten opzichte van QBCore?
De ox-bibliotheek als fundament
Waar QBCore eigen componenten gebruikt (qb-inventory, qb-target, qb-menu), vervangt Qbox die door ox-alternatieven:
| QBCore | Qbox | Toelichting |
|---|---|---|
| qb-inventory | ox_inventory | Betere UI, gewichtssysteem, item metadata |
| qb-target | ox_target | Snellere raycast, minder client-side load |
| qb-menu | ox_lib (menu/context) | Uniforme UI-componenten |
| qb-input | ox_lib (input dialog) | Validatie ingebouwd |
| qb-fuel | ox_fuel | Realistischer brandstofverbruik |
| qb-doorlock | ox_doorlock | Betere performance bij veel deuren |
Betere code-kwaliteit
Qbox gebruikt stricter gestructureerde Lua met type-annotaties, betere foutafhandeling en minder globale variabelen. De codebase is kleiner en overzichtelijker, wat het makkelijker maakt om bugs te vinden en scripts aan te passen.
Performance
Door de ox-componenten en de opgeschoonde kern is het basisverbruik van Qbox lager dan dat van QBCore. In benchmarks gebruikt een standaard Qbox-installatie circa 15 tot 25 procent minder server-side tick time dan een vergelijkbare QBCore-setup. Het verschil groeit naarmate er meer spelers online zijn.
Backward compatibility met QBCore-scripts
Qbox bevat een compatibiliteitslaag waardoor veel QBCore-scripts werken zonder aanpassing. Scripts die QBCore.Functions aanroepen, worden via een bridge doorgestuurd naar de Qbox-equivalenten. Dit werkt voor de meeste gangbare scripts, maar niet voor allemaal:
- Scripts die direct qb-inventory of qb-target aanroepen zonder via het framework te gaan, moeten worden aangepast.
- Scripts die interne QBCore-functies gebruiken die niet tot de publieke API behoren, werken mogelijk niet.
- UI-elementen die op qb-menu of qb-input leunen, moeten worden herschreven naar ox_lib.
Migratie vanaf QBCore
Een migratie van QBCore naar Qbox is haalbaarder dan van ESX naar QBCore, maar het is geen druk-op-de-knop-operatie. Dit is het stappenplan:
- Backup: maak een volledige backup van uw server, inclusief database, resources en server.cfg.
- Qbox installeren: gebruik het Qbox-recipe in txAdmin voor een schone installatie op een testserver. Dit geeft u de volledige basisset.
- Database migreren: Qbox gebruikt dezelfde databasestructuur als QBCore voor spelerdata. De tabellen
players,player_vehicles,player_housesenapartmentszijn compatible. Inventarisdata moet worden geconverteerd van qb-inventory-formaat naar ox_inventory-formaat; hiervoor bestaan migratiescripts op GitHub. - Scripts testen: installeer uw scripts een voor een en test ze. Begin met de kern (banen, voertuigen, huizen) en voeg pas daarna cosmetische scripts toe.
- ox-componenten configureren: configureer ox_inventory, ox_target en ox_doorlock. De configuratiebestanden staan in de resource-mappen en zijn goed gedocumenteerd.
- QBCore-bridge controleren: test of QBCore-scripts correct werken via de bridge. Let op foutmeldingen in de serverconsole die wijzen op ontbrekende functies.
Qbox versus ESX en QBCore
Een uitgebreide vergelijking van de drie frameworks vindt u in ESX, QBCore of Qbox: welk framework kiest u?. De korte samenvatting:
- ESX: het grootste scriptaanbod, maar verouderde codebase. Geschikt als u veel kant-en-klare scripts wilt.
- QBCore: goede middenweg, maar wordt geleidelijk ingehaald door Qbox. Bestaande QBCore-servers draaien prima door.
- Qbox: de beste performance en modernste code. Aanbevolen voor nieuwe servers in 2026.
Onze aanbeveling
Start u een nieuwe FiveM-server? Kies Qbox. Het framework heeft in 2026 voldoende scripts, actieve ondersteuning en de beste technische basis. De ox-bibliotheken zijn de standaard geworden voor nieuwe scriptontwikkeling, dus ook als u later scripts koopt of downloadt, is de kans groot dat ze ox_lib gebruiken.
Draait u een bestaande QBCore-server die goed functioneert? Dan is migreren geen urgentie. QBCore wordt nog onderhouden en de meeste scripts werken. Migreer wanneer u toch een grote herbouw plant, niet als doel op zich.
Qbox draait op alle FiveM-pakketten van HostValues. txAdmin biedt Qbox als recipe aan bij de eerste setup. Lees ook onze gids over txAdmin instellen voor de eerste stappen.
