FiveM Server Scripts installeren – ESX en QBCore

FiveM scripts installeer je door de resource in de map resources/ te plaatsen, deze in server.cfg met ensure te starten en afhankelijkheden zoals ESX, QBCore of databasestuurprogramma's vooraf te laden. Doorslaggevend zijn een nette mappenstructuur, de juiste startvolgorde, een gecontroleerde SQL-import en een blik in de serverconsole na de herstart.

Vereisten

Je hebt toegang nodig tot de serverbestanden, server.cfg, de serverconsole en, als het script databasetabellen gebruikt, tot je MySQL- of MariaDB-database. Bij een gehuurde FiveM server hoort daar meestal een bestandsbeheerder, FTP/SFTP en een databasetool zoals phpMyAdmin of Adminer bij. Als je de volledige server nog plant, helpt de interne guide FiveM Server huren en instellen bij de basisstructuur.

FiveM noemt scripts technisch resources. Volgens de officiële Cfx.re-documentatie beschrijft fxmanifest.lua welke bestanden, scripts en metadata bij een resource horen. Controleer daarom altijd eerst of de uitgepakte map een geldig manifestbestand bevat. Zonder manifest kan de server de resource niet correct laden.

Scriptstructuur controleren

Een typische FiveM resource ziet er zo uit:

mijn_script/
├── fxmanifest.lua      # Manifestbestand
├── client.lua          # Clientcode
├── server.lua          # Servercode
├── config.lua          # Configuratie
└── html/               # NUI (webinterface)

Belangrijk is dat je niet per ongeluk een extra verpakkingsmap uploadt. Fout zou bijvoorbeeld resources/mijn_script-main/mijn_script/fxmanifest.lua zijn, als de resource eigenlijk direct onder resources/mijn_script/fxmanifest.lua moet staan. Open na het uitpakken de map en controleer op welk niveau fxmanifest.lua staat.

Script installeren

1. Script downloaden
2. In de map resources/ uitpakken
3. Aan server.cfg toevoegen:

ensure mijn_script

4. Server herstarten

Gebruik als resourcenaam exact de mapnaam of de naam die de README voorschrijft. Veel fouten ontstaan door afwijkende spelling, spaties in de mapnaam of speciale tekens. Aan te raden zijn korte namen met kleine letters, koppeltekens of underscores.

ESX scripts instellen

ESX scripts hangen ervan af dat de ESX-basis en vereiste extra resources vooraf worden gestart. De concrete volgorde kan per ESX-versie en script verschillen, daarom geldt: controleer de README van het script en volg de bestaande frameworkdocumentatie.

# Basis ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# Jobs
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob

# Functies
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property

Als een job-script eigen databasetabellen of items verwacht, importeer dan het meegeleverde SQL-bestand vóór de eerste productieve start. Maak vooraf een back-up van de database. Bij bestaande roleplayservers kunnen SQL-bestanden kolommen, items of jobs overschrijven als ze niet op je installatie zijn afgestemd.

QBCore scripts instellen

QBCore-resources volgen een vergelijkbaar principe: eerst het framework, daarna gedeelde bibliotheken, vervolgens inventory, jobs, garages, phone of HUD. Een eenvoudig voorbeeld:

ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-garages
ensure qb-inventory
ensure qb-phone

Controleer vooral configuratiebestanden zoals config.lua, shared/config.lua of frameworkspecifieke itembestanden. Sommige QBCore scripts verwachten vermeldingen in items, jobs, gangs of permissions. Vul alleen waarden in die het script documenteert. Als je resources, txAdmin en serverbeheer in een bredere context wilt plannen, lees dan ook FiveM Server huren: GTA RP instellen, resources & txAdmin 2025.

Startvolgorde beachten

De startvolgorde is belangrijk:

1. Framework eerst (ESX/QBCore)
2. Dependencies (oxmysql, etc.)
3. Basisscripts (inventory, HUD)
4. Job-scripts
5. Cosmetische scripts (emotes, kleding)

Plaats gedeeld gebruikte dependencies zo centraal mogelijk en vóór alle afhankelijke resources. Als meerdere scripts dezelfde bibliotheek vereisen, moet die maar één keer worden gestart. Bij databasekoppeling moet het databasestuurprogramma draaien voordat resources SQL-query's versturen.

Gratis scriptbronnen

Download scripts alleen uit bronnen waar code, changelog of communityfeedback controleerbaar zijn. Bij onbekende downloads moet je extra letten op versluierde Lua-code, onverklaarbare HTTP-requests, externe webhooks en hard gecodeerde tokens. Installeer nieuwe resources eerst op een testinstantie of buiten de belangrijkste speeltijden.

Resultaat controleren

Start de server opnieuw en houd de console in de gaten. Een correct geladen resource verschijnt zonder manifest-, dependency- of SQL-fouten. In de game controleer je daarna precies de functie die het script levert: jobmenu, inventory-interactie, marker, command, NUI-venster of databasewijziging. Test met de rollen en rechten die echte spelers later gebruiken.

Gebruik daarnaast refresh en ensure mijn_script in de serverconsole alleen voor gecontroleerde tests. Voor productieve wijzigingen is een nette herstart vaak informatiever, omdat die de volledige startvolgorde weergeeft.

Troubleshooting

SCRIPT ERROR

Controleer eerst de regel in de console. Vaak ontbreekt er een dependency, is een configvariabele verkeerd ingesteld of wordt een geëxporteerde functie aangeroepen voordat de doelresource is gestart. Vergelijk de foutmelding met de README van het script.

SQL-fouten

Importeer de meegeleverde tabellen of kolommen als het script die vereist. Als tabellen al bestaan, voer SQL dan niet blind opnieuw uit. Maak een back-up en pas de statements aan je bestaande databasestructuur aan.

Script laadt niet

Controleer de mapnaam, de ensure-vermelding en fxmanifest.lua. Een typefout in het manifestbestand of een verkeerd geneste map is genoeg om te zorgen dat de resource niet start.

Functie verschijnt niet in de game

Controleer rechten, jobs, items, coördinaten en frameworkversie. Veel roleplayscripts werken alleen voor bepaalde jobs of groepen. Test daarom niet alleen als admin, maar ook met een normaal spelersprofiel.

Controle, grenzen en veilige weg terug

De handleiding “FiveM Server Scripts installeren – ESX en QBCore” geldt voor het servertype dat in het artikel wordt beschreven en de versiestand die op het controlemoment zichtbaar was. Menunamen, beschikbare versies, mod- of plugincompatibiliteit en vereiste resources kunnen na updates afwijken. Neem daarom geen waarden ongecontroleerd over naar een andere game-, loader- of serverversie.

Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een back-up van de betrokken bestanden. Wijzig daarna slechts één samenhangende stap en controleer die met dezelfde client- en serverversie waarmee je later wilt spelen.

Een geslaagde losse test is geen prestatie- of beschikbaarheidsgarantie. Wereldgrootte, mods, plugins, spelersaantal, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.

FAQ

Moet ik de server na elk script opnieuw starten?

Voor een betrouwbare test wel. Afzonderlijke resources kun je wel via de console opnieuw laden, maar een volledige herstart laat zien of de startvolgorde en alle dependencies echt kloppen.

Kan ik ESX en QBCore tegelijk gebruiken?

In de praktijk kun je beter één framework kiezen. Veel scripts zijn duidelijk voor ESX of QBCore gebouwd en verwachten elk andere events, tabellen en configstructuren.

Wat doe ik als een script geen fxmanifest.lua heeft?

Dan is het mogelijk verouderd, verkeerd uitgepakt of niet voorbereid op actuele FiveM-resourcestructuren. Controleer de bron en de documentatie voordat je het productief installeert.

Moet ik gratis scripts direct op de live-server testen?

Liever niet. Test nieuwe resources eerst apart, maak een back-up van bestanden en database en controleer de console. Vooral bij roleplayservers kunnen foutieve scripts inventory, jobs of spelersvoortgang beïnvloeden.

Hoeveel scripts kan een FiveM server gebruiken?

Er is geen zinvol algemeen aantal. Doorslaggevend zijn scriptkwaliteit, afhankelijkheden, databasebelasting, tick-gedrag en spelersaantal. Plan resources bewust en verwijder ongebruikte scripts consequent.