Hoe installeer ik QBCore op mijn FiveM-server via txAdmin?

QBCore is het populairste roleplay-framework voor FiveM, maar het handmatig installeren van tientallen resources, een database en een werkende server.cfg is foutgevoelig werk. Gelukkig hoeft dat niet: txAdmin heeft een kant-en-klare recipe die het complete framework in enkele minuten voor je neerzet. In deze gids maak je eerst een database aan in het paneel, deploy je daarna de QBCore-recipe via de txAdmin-setupwizard en log je ten slotte als admin in in je eigen stad.

QBCore of Qbox? Qbox (qbx_core) is een moderne doorontwikkeling van QBCore, met actieve ontwikkeling, betere prestaties en strakkere beveiliging. De txAdmin-recipelijst bevat beide frameworks en de stappen hieronder zijn voor allebei identiek; kies je voor Qbox, selecteer dan simpelweg die recipe in stap 3. Begin je helemaal opnieuw en heb je nog geen QBCore-specifieke scripts gekocht, dan is Qbox het overwegen waard.

Stap 1: Maak een database aan in het paneel

1. Log in op het MC-Node paneel en open je FiveM-server.
2. Ga naar het tabblad Databases en klik op New Database. Zie je geen knop of zit je aan je limiet, lees dan Hoe maak ik een database aan en beheer ik deze?
3. Geef de database een herkenbare naam, bijvoorbeeld qbcore, en bevestig.
4. Open de details van de nieuwe database en noteer vier gegevens: het endpoint (de host, inclusief het poortnummer erachter), de databasenaam, de gebruikersnaam en het wachtwoord (zichtbaar via het oog-icoontje).

Let op: de host is een eigen databaseadres, niet localhost. Vul je straks toch localhost of 127.0.0.1 in, dan kan je server de database nooit bereiken. Meer achtergrond staat in Hoe verbind ik mijn database?

Stap 2: Open txAdmin

1. Controleer of txAdmin aanstaat op je server. Is dat nog niet zo, volg dan eerst Hoe zet ik txAdmin aan?
2. Start je server via het tabblad Console.
3. In de console-uitvoer verschijnt het txAdmin-adres samen met een viercijferige pincode. Die pincode is maar enkele minuten geldig; is hij verlopen, herstart je server dan voor een nieuwe.
4. Open het adres (http://server-ip:txadmin-poort) in je browser, log in met je Cfx.re-account en vul de pincode in. Dit koppelen hoeft alleen de eerste keer: jouw account is daarna het master-account van deze txAdmin.

Stap 3: Deploy de QBCore-recipe via de setupwizard

1. Omdat er nog geen server is ingesteld, opent txAdmin automatisch de setupwizard. Geef je server een naam.
2. Kies bij het installatietype voor Popular Recipes en selecteer QBCore Framework (of Qbox).
3. Vul je Cfx.re license key in. Die maak je gratis aan op portal.cfx.re; hoe dat precies werkt lees je in Ik heb een FiveM-server gekocht, wat nu?
4. Vul bij de databasevelden exact de gegevens uit stap 1 in: host (met poortnummer), gebruikersnaam, wachtwoord en databasenaam.
5. Start de deployment. txAdmin downloadt nu alle QBCore-resources, importeert de SQL-tabellen in je database en genereert een server.cfg. Dit duurt doorgaans enkele minuten.
6. Controleer na afloop de gegenereerde server.cfg (de standaardwaarden zijn prima om mee te starten) en klik op Save & Run Server.

Stap 4: Eerste start, admin worden en de stad in

1. Volg de eerste start in de txAdmin-console en wacht tot alle resources geladen zijn en er geen rode foutmeldingen meer voorbijkomen.
2. Open de FiveM-client, druk op F8 en typ connect ip:poort met het adres van je server (dat vind je terug in het paneel).
3. Je komt in het karaktermenu terecht: maak je eerste personage aan en kies een startlocatie of appartement.
4. Admin worden: open in txAdmin de pagina Live Console en typ setgroup 1 god, waarbij je 1 vervangt door jouw server-ID (te zien op de Players-pagina van txAdmin). Met de groep god open je in de stad het adminmenu, standaard via /admin.

Veelvoorkomende problemen

• Connection refused of Access denied (oxmysql) — de databasegegevens kloppen niet. De recipe schrijft ze naar de regel set mysql_connection_string in server.cfg; open dat bestand via het tabblad Files en controleer host mét poortnummer, gebruikersnaam (inclusief eventueel voorvoegsel), wachtwoord en databasenaam. Gebruik nooit localhost. Herstart daarna je server.
• Recipe over een bestaande installatie gedraaid — de deployer verwacht een lege omgeving. Draai je de wizard over een eerdere installatie heen, dan krijg je conflicterende resources en dubbele databasetabellen. Maak eerst een backup via het tabblad Backups, verwijder daarna de oude serverbestanden (of laat je server opnieuw installeren) en gebruik een lege of nieuwe database.
• License key ontbreekt of is al in gebruik — zonder geldige key start FiveM niet, en één key kan maar op één actieve server tegelijk draaien. Maak op Keymaster een nieuwe key aan en pas hem aan via het tabblad Startup; de details staan in Hoe verander ik mijn FiveM license key?
• De txAdmin-pagina laadt niet — controleer of de txAdmin-poort is ingesteld en of je server daadwerkelijk draait; de stappen staan in het txAdmin-artikel uit stap 2.

Hulp nodig?

Gefeliciteerd, je stad draait! Vanaf hier kun je resources toevoegen, jobs configureren en je server verder inrichten. Loop je toch ergens vast, bijvoorbeeld op een deployment die halverwege stopt? Open een ticket via onze supportpagina en vermeld je servernaam en de foutmelding uit de txAdmin-console — dan kijken we met je mee.