Deze handleiding behandelt hoe je resources (scripts) installeert op je FiveM server, een MySQL-database instelt voor frameworks zoals ESX of QBCore, en de laadvolgorde van resources begrijpt. Als je de initiële serverinstallatie nog niet hebt voltooid, begin dan eerst met de FiveM Server Installatiehandleiding.

Resources en scripts installeren

FiveM servers worden uitgebreid met resources (ook wel scripts genoemd). Resources voegen functies toe zoals autodealers, banen, HUD-elementen, frameworks en meer.

Hoe een resource te installeren

1. Download de resource van de bron (GitHub, Cfx.re forums, Tebex, enz.).
2. Pak de resourcemap uit het ZIP/archief uit indien nodig.
3. Upload de resourcemap naar de resources/ map van je server via het GPanel tabblad Files of via SFTP.
4. Open server.cfg en voeg een ensure-regel toe voor de resource:

# Add your custom resources
ensure my-new-resource

5. Herstart de server via GPanel of TXAdmin zodat de resource wordt geladen.

Resource Manifests

Elke geldige resource moet een manifestbestand bevatten. Moderne resources gebruiken fxmanifest.lua, terwijl oudere resources __resource.lua gebruiken. Als een gedownloade resourcemap geen van beide bestanden bevat, wordt de resource niet geladen. Sommige downloads nesten de eigenlijke resourcemap in een buitenste map — zorg ervoor dat de map die je in resources/ plaatst degene is die het manifest bevat.

Laadvolgorde van resources

Resources worden geladen in de volgorde waarin ze in server.cfg staan. Als een resource afhankelijk is van een andere (bijvoorbeeld een baanscript dat afhankelijk is van een framework zoals ESX of QBCore), zorg er dan voor dat de afhankelijkheid vóór de resource die deze nodig heeft wordt vermeld:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Resources organiseren met categoriemappen

Je kunt resources organiseren in submappen binnen de resources/ map. Gebruik haakjesnotatie in server.cfg om een volledige categoriemap te laden:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Dit laadt elke resource binnen de genoemde submap. Het is een handige manier om gerelateerde scripts te groeperen zonder ze elk afzonderlijk te hoeven vermelden.

Resources hot-loaden via TXAdmin

Je hebt niet altijd een volledige serverherstart nodig om een nieuwe resource te laden. TXAdmin kan individuele resources starten, stoppen en herstarten vanuit de Resources-pagina. Na het uploaden van een nieuwe resource en het toevoegen van de ensure-regel, kun je het volgende commando uitvoeren in de TXAdmin live console:

refresh
ensure my-new-resource

Het commando refresh vertelt de server om de resources/ map opnieuw te scannen op nieuwe items.

Database-installatie (MySQL / MariaDB)

Veel FiveM frameworks en resources (zoals ESX, QBCore of vRP) vereisen een MySQL- of MariaDB-database. Legion Hosting biedt databasegegevens bij je server.

Je databasegegevens vinden

1. Ga in GPanel naar het tabblad Databases.
2. Als er nog geen database bestaat, klik dan op New Database om er een aan te maken.
3. Noteer de volgende gegevens:
   • Database Host (adres en poort)
   • Database Name
   • Username
   • Password (klik op het oogicoon om het weer te geven)

De databaseverbinding configureren

Databaseverbindingsgegevens worden ingesteld in server.cfg met behulp van een verbindingsreeks. Het exacte formaat hangt af van welke MySQL-resource je gebruikt, maar het meest gebruikelijke formaat is:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Vervang de plaatshouders door je werkelijke gegevens van het tabblad Databases. Bijvoorbeeld:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Een MySQL-resource kiezen

Welke MySQL-resource je ook gebruikt, deze moet in server.cfg worden geladen vóór alle resources die ervan afhankelijk zijn:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Framework-basis

Een framework biedt de kern-gameplay-systemen waarop andere resources voortbouwen — zaken zoals speleridentiteit, geld, inventaris, banen en voertuigen. De twee populairste FiveM frameworks zijn:

De meeste frameworks worden geïnstalleerd via het receptensysteem van TXAdmin tijdens de initiële installatie. Als je een recept zoals "QBCore" of "ESX" hebt gekozen tijdens de TXAdmin-installatie, zijn het framework en de kernafhankelijkheden al geïnstalleerd. Als je een framework handmatig moet installeren, volg dan de officiële documentatie:

• ESX Documentatie
• QBCore Documentatie

Hulp krijgen

Als je hulp nodig hebt bij de installatie van resources of databaseconfiguratie:

1. Controleer de documentatie of GitHub-pagina van de resource voor installatie-instructies en bekende problemen.
2. Bekijk de GPanel console of TXAdmin logs voor foutmeldingen.
3. Open een supportticket op https://legionhosting.net/submitticket.php met je foutmeldingen en de naam van de resource die je probeert te installeren.

Gerelateerde artikelen

• FiveM Server Installatiehandleiding
• FiveM Probleemoplossing
• Bestanden uploaden via SFTP
• Hoe vind je je server IP en poort