Deze handleiding behandelt oplossingen voor de meest voorkomende FiveM serverproblemen — TXAdmin-toegangsproblemen, CFX-licentiesleutelfouten, databaseverbindingsfouten, servercrashes, verbindingsproblemen van spelers en resources die niet laden. Voor de initiële serverinstallatie, zie de FiveM Server Installatiehandleiding.
Algemene tip voor probleemoplossing: Controleer altijd eerst de GPanel console-uitvoer en TXAdmin logs. De meeste fouten produceren een duidelijk bericht dat naar de oorzaak wijst.
TXAdmin laadt niet of is onbereikbaar
- Controleer of de server draait in GPanel — TXAdmin start alleen wanneer het FiveM serverproces actief is.
- Controleer de GPanel console voor de TXAdmin URL en poort. De TXAdmin-poort is anders dan de gamepoort.
- Zorg ervoor dat je
http://gebruikt en niethttps://— TXAdmin gebruikt standaard geen SSL. - Als TXAdmin eerder werkte maar stopt met laden, probeer dan de server te herstarten vanuit GPanel.
- Wis je browsercache of probeer een incognito-/privévenster.
TXAdmin-wachtwoord kwijt? Als je niet kunt inloggen, moet je mogelijk de TXAdmin-profielgegevens verwijderen en de installatiewizard opnieuw uitvoeren. Controleer het GPanel tabblad Files voor de TXAdmin datamap en verwijder de profielbestanden, herstart daarna de server.
CFX-licentiesleutelfouten
| Foutmelding | Oorzaak | Oplossing |
|---|---|---|
Invalid license key |
Sleutel onjuist gekopieerd of extra witruimte | Ga naar Keymaster, bevestig dat de sleutel actief is en kopieer deze zorgvuldig opnieuw. Plak deze zowel in de GPanel Startup-variabele als in sv_licenseKey in server.cfg. |
License key already in use |
Sleutel is geregistreerd op een ander server-IP | Elke sleutel kan slechts op één server tegelijk worden gebruikt. Trek de oude sleutel in op Keymaster en genereer een nieuwe met je huidige server-IP. |
Unable to verify license key |
Cfx.re authenticatieservers zijn tijdelijk niet beschikbaar | Wacht een paar minuten en herstart de server. Controleer status.cfx.re voor storingen. |
Tip: Zorg ervoor dat de sleutel is ingesteld in zowel de GPanel Startup-variabele als in
server.cfg (sv_licenseKey). Afhankelijk van je configuratie kan de server van de een of de ander lezen.
Databaseverbindingsfouten
| Foutmelding | Oorzaak | Oplossing |
|---|---|---|
Connection refused of ETIMEDOUT |
Verkeerd databasehost of verkeerde poort | Controleer het databasehostadres en de poort van het GPanel tabblad Databases. Gebruik geen localhost of 127.0.0.1. |
Access denied |
Verkeerde gebruikersnaam of wachtwoord | Kopieer de inloggegevens rechtstreeks uit GPanel om typefouten te voorkomen. Wachtwoorden zijn hoofdlettergevoelig. |
Unknown database |
Databasenaam komt niet overeen | Zorg ervoor dat de databasenaam in je verbindingsreeks exact overeenkomt met wat in GPanel wordt weergegeven. |
Aanvullende stappen voor database-probleemoplossing:
- Als je oxmysql gebruikt, zorg er dan voor dat je de
oxmysqlresource in jeresources/map hebt en datensure oxmysqlin server.cfg vóór alle resources staat die een database vereisen. - Als je wachtwoord speciale tekens bevat zoals
@,#of%, URL-codeer ze dan in de verbindingsreeks (bijv.@wordt%40). - Test je verbindingsreeks op ontbrekende of extra tekens — zelfs één verkeerd geplaatst teken veroorzaakt een fout.
Gebruik geen localhost. De databaseserver is gescheiden van de gameserver. Gebruik altijd het volledige hostadres dat wordt weergegeven in het GPanel tabblad Databases.
Server crasht bij het opstarten
- Controleer de GPanel console op foutmeldingen. Veelvoorkomende oorzaken zijn een ontbrekende of verkeerd geconfigureerde
server.cfg, een ongeldige CFX-licentiesleutel of een defecte resource. - Probeer aangepaste resources uit te schakelen door ze uit te commentariëren in server.cfg (voeg
#toe vóór elkeensure-regel) en herstart. Voeg ze één voor één weer toe om de problematische resource te identificeren. - Zorg ervoor dat de poorten in
endpoint_add_tcpenendpoint_add_udpovereenkomen met je GPanel toegewezen poort.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Binair zoeken naar slechte resources: Als je veel resources hebt, commentarieer dan de helft tegelijk uit in plaats van één voor één. Dit beperkt het probleem veel sneller.
Spelers kunnen geen verbinding maken
- Bevestig dat de server Running toont in GPanel.
- Controleer het IP en de poort — spelers moeten de gamepoort gebruiken, niet de TXAdmin-poort.
- Controleer of
sv_maxclientsniet is ingesteld op 0 of een onredelijk laag getal. - Als je een serverwachtwoord gebruikt (
sv_passwordin server.cfg), zorg er dan voor dat spelers het weten. - Spelers moeten de FiveM client geïnstalleerd hebben — ze kunnen geen verbinding maken met de gewone GTA V launcher.
- Controleer het GPanel tabblad Network en bevestig dat de poorten in
endpoint_add_tcpenendpoint_add_udpovereenkomen. Een verschil voorkomt verbindingen.
Server niet in de browser? Nieuwe servers kunnen 5-15 minuten nodig hebben om in de FiveM serverlijst te verschijnen. Gebruik in de tussentijd directe verbinding (
IP:PORT). Controleer ook of je sv_licenseKey geldig is.
Resources laden niet
- Controleer of de resourcemap zich in de
resources/map bevindt (of een geschikte submap). - Controleer of de mapnaam exact overeenkomt met de
ensure-regel in server.cfg (hoofdlettergevoelig). - Elke resource moet een geldig
fxmanifest.lua(of het oudere__resource.lua) bevatten. Als dit bestand ontbreekt, wordt de resource niet geladen. - Controleer de TXAdmin of GPanel console op foutmeldingen gerelateerd aan de resource. Veelvoorkomende fouten zijn ontbrekende afhankelijkheden of Lua-syntaxfouten.
- Als de resource een framework vereist (ESX, QBCore), zorg er dan voor dat het framework vóór de resource wordt geladen in server.cfg.
- Als de resource een database vereist, zorg er dan voor dat je MySQL-resource (oxmysql, mysql-async) is geladen en de databaseverbinding werkt.
Controleer de mapstructuur. Een veelgemaakte fout is het uploaden van een resource waarbij je eindigt met een dubbel geneste map zoals
resources/my-resource/my-resource/fxmanifest.lua. Het manifest moet zich direct in de resourcemap bevinden: resources/my-resource/fxmanifest.lua.
Serverprestatieproblemen
- Open TXAdmin en controleer het Dashboard voor prestatiemetrics (tick time, aantal spelers, geheugengebruik).
- Een gezonde FiveM server moet een server tick time (ook wel "hitch" genoemd) onder de 20ms behouden. Consistente pieken hierboven geven aan dat een resource te veel verwerkingstijd gebruikt.
- Gebruik de TXAdmin Resources-pagina om te identificeren welke resources de meeste servertijd verbruiken.
- Verwijder of vervang slecht geoptimaliseerde resources. Gratis resources van onbekende bronnen zijn vaak de oorzaak van prestatieproblemen.
- Verminder het aantal geladen resources als de geheugen- of CPU-limieten van je serverplan worden bereikt.
Hulp krijgen
Als je de bovenstaande oplossingen hebt geprobeerd en nog steeds problemen ondervindt:
- Kopieer de volledige foutmelding uit de GPanel console of het TXAdmin logboek.
- Noteer welke probleemoplossingsstappen je al hebt geprobeerd.
- Open een supportticket op https://legionhosting.net/submitticket.php met deze informatie. Ons team helpt je zo snel mogelijk.
