FiveM server opzetten: stap voor stap met QBCore
Een eigen FiveM server opzetten lukt in ongeveer een halfuur. In deze gids installeer je een QBCore-server met het officiële txAdmin-recept, geef je jezelf admin-rechten en lees je hoe je scripts toevoegt zonder je server te breken. Werk je liever in het Engels? Lees dan de Engelse versie.
Wat heb je nodig?
- Een Windows- of Linux-server. Voor een testserver is een moderne quad-core met 8 GB RAM genoeg; met meer spelers en scripts heb je meer nodig.
- Een gratis Cfx.re-account.
- MariaDB als database.
- Ongeveer 30 minuten.
License key aanmaken
Elke FiveM server heeft een license key nodig. Die maak je tegenwoordig aan in de Cfx.re Portal (vroeger heette dat Keymaster). Log in, maak een nieuwe server key aan en deel die met niemand.
MariaDB installeren
Installeer MariaDB en kies een root-wachtwoord. Op Windows kun je HeidiSQL meeinstalleren om later je tabellen te bekijken. Tabellen hoef je niet zelf aan te maken: het txAdmin-recept doet dat voor je. Gebruik geen XAMPP voor een server die online blijft.
FXServer downloaden
Download de build die als recommended is gemarkeerd (niet zomaar de nieuwste) van de officiële artifacts-pagina voor Windows of Linux. Pak hem uit in een eigen map en houd je serverdata (resources en server.cfg) in een andere map.
txAdmin starten en het QBCore-recept installeren
- Start
FXServer.exe(Windows) of./run.sh(Linux). txAdmin opent in je browser op poort 40120. - Koppel je Cfx.re-account en kies een wachtwoord.
- Kies Popular Recipes en daarna QBCore Framework.
- Kies een map voor de serverdata.
- Vul je license key en de MariaDB-gegevens in.
- Start het recept en wacht tot alles is gedownload en geïnstalleerd.
Jezelf admin maken
Join de server één keer, kopieer je license:-identifier uit txAdmin (Players) en zet deze regel in server.cfg:
add_principal identifier.license:JOUW_LICENSE qbcore.godHerstart de server. Gebruik qbcore.admin of qbcore.mod voor stafleden die minder rechten nodig hebben.
Poorten en verbinden
| Poort | Protocol | Waarvoor |
|---|---|---|
| 30120 | TCP en UDP | Spelers die verbinden |
| 40120 | TCP | txAdmin (alleen open voor je eigen IP) |
Zet poort 30120 open in je firewall en, thuis, in je router. Lokaal testen doe je met F8 en connect localhost. Met onze FiveM server IP finder zie je welk adres achter een cfx.re join-link zit.
Scripts veilig toevoegen
- Check voor welk framework een script is gemaakt: een ESX-script werkt niet zomaar op QBCore.
- Installeer eerst de dependencies (vaak ox_lib of oxmysql) en draai de bijgeleverde SQL.
- Zet elk script in een eigen map en voeg een
ensure-regel toe ná de dependencies. - Test eerst op een kopie van je server en kijk naar de F8-console en
resmon 1.
Tips voor een Nederlandse server
Zet de taal van je scripts op Nederlands (veel QBCore-resources hebben een locales/nl.lua), kies politie- en ambulance-uniformen die passen bij Nederlandse RP (zie de EUP & clothing hub), en zoek medespelers, developers of feedback in de Nederlandse community.
Problemen oplossen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Recept stopt tijdens downloaden | GitHub-limiet of netwerkfout | Wacht even en start het recept opnieuw. |
| Geen verbinding met database | Verkeerde gegevens in mysql_connection_string | Controleer de regel en of MariaDB draait. |
| Server niet in de serverlijst | Poort 30120 dicht of key van een ander IP | Poort openzetten en key controleren in de Portal. |
| Resource start niet | Dependency ontbreekt of verkeerde volgorde | Lees de console en verplaats ensure-regels. |
Volgende stap: interieurs toevoegen met een MLO installeren (Engels) en auto's toevoegen met add-on cars installeren (Engels).