Veelvoorkomende fouten van een FiveM-server en hun oplossing

De meeste problemen met een FiveM-server verraden zich in één regel van de uitvoer. Hier vind je de meest voorkomende meldingen precies zoals je ze ziet, met de oorzaak en de stappen om ze op te lossen. Zoek op de tekst van de fout (Ctrl+F).

Waar je fouten vindt#

Lees vanaf de eerste fout. Latere fouten zijn vaak alleen een gevolg daarvan. Gele en rode regels zijn waarschuwingen en fouten.

Could not authenticate server license key of no license key was specified#

Oorzaak: de server heeft geen geldige license key. Hij heeft er helemaal geen gekregen, of de sleutel is ongeldig, gedeactiveerd of met een fout gekopieerd.

Oplossing: controleer de regel sv_licenseKey in de server.cfg die de server echt laadt, en de variabele met de sleutel op het tabblad Instellingen. Controleer op de Cfx.re Portal (opent in een nieuw venster) of de sleutel de status Active heeft. De uitgebreide stappen: FiveM license key.

Couldn't find resource …#

Oorzaak: de server kent geen resource met de naam uit ensure. De mapnaam klopt niet (-main, hoofdletters), fxmanifest.lua staat een niveau dieper, of je hebt het script geüpload terwijl de server draaide, zonder het commando refresh.

Oplossing: geef de map exact de naam uit ensure en controleer of fxmanifest.lua er direct in staat. Voer daarna in de console refresh en ensure <NAME> in, of herstart de server. Zie FiveM resources.

Could not find dependency … for resource …#

Oorzaak: het script heeft een andere resource nodig (een bibliotheek, een framework) die niet op de server staat.

Oplossing: installeer de resource die als eerste in de melding staat en zet de ensure ervan in server.cfg boven het script. De melding Could not start dependency … betekent dat de afhankelijkheid bestaat, maar zelf is gecrasht. Zoek de fout ervan in de console.

Couldn't start resource …#

Oorzaak: de resource bestaat, maar is niet gestart. De echte reden staat in de regels vlak boven deze melding: een ontbrekende afhankelijkheid, een voorwaarde waaraan niet is voldaan (OneSync, game build, serverversie) of een licentiefout van een betaald script.

Oplossing: los de oorzaak uit de voorgaande regels op en start de resource opnieuw met het commando ensure <NAME>.

SCRIPT ERROR: @…/….lua:…: …#

Oorzaak: een fout in de code van het script. De melding bevat de resource, het bestand, het regelnummer en een omschrijving, bijvoorbeeld attempt to index a nil value. Meestal gaat het om een verkeerd ingesteld framework in config.lua, een ontbrekende tabel in de database of een oudere versie van het script dan het framework verwacht.

Oplossing: controleer config.lua (het juiste framework), importeer de SQL van het script en update zowel het script als het framework. Is de fout ontstaan nadat je een bestand hebt aangepast, draai die aanpassing dan terug.

You lack the required entitlement to use …#

Oorzaak: een betaald script dat met Asset Escrow is beveiligd, is gekocht met een ander Cfx.re-account dan het account waar de license key van de server bij hoort.

Oplossing: gebruik een license key van hetzelfde account waarmee je het script hebt gekocht, of draag het script over op de Cfx.re Portal. Herstart daarna de server.

Failed to verify protected resource …#

Oorzaak: de bestanden van een versleuteld script zijn bij het overzetten beschadigd geraakt of ontbreken, meestal het bestand .fxap.

Oplossing: upload de hele resource opnieuw, inclusief het bestand .fxap en de verborgen bestanden (die beginnen met een punt).

Unable to establish a connection to the database (…)!#

Oorzaak: oxmysql heeft geen verbinding met de database gekregen. De code tussen haakjes vertelt waarom:

Oplossing: corrigeer set mysql_connection_string in server.cfg volgens de handleiding Database voor FiveM. Na de correctie verschijnt in de console Database server connection established!.

De server staat niet in de serverlijst of is “privé”#

Oorzaak: een actieve regel sv_master1 "", een ontbrekende sets sv_projectName of sets sv_projectDesc, een server die van buitenaf niet bereikbaar is, of er is nog maar weinig tijd verstreken sinds de start.

Oplossing:

1. Controleer of je rechtstreeks met de server kunt verbinden: druk in het spel op F8 en voer connect <IP_ADDRESS>:<PORT> in (het adres van het tabblad Netwerk).
2. Commentarieer de regel sv_master1 "" uit met het teken #.
3. Vul sets sv_projectName "…" en sets sv_projectDesc "…" aan.
4. Wacht maximaal 8 minuten na de start.

Je kunt de server ook controleren met de tool CFX Resolver. De details staan in de handleiding server.cfg.

Connection rejected by server: Client/Server game build revision mismatch#

Oorzaak: het spel van de speler en de server hebben een andere revisie van de game build. Dat gebeurt meestal kort na een update van GTA V of FiveM.

Oplossing: update de artifacts van de server (handleiding). De speler kan in de FiveM-client het Update Channel (tandwiel › Game) omzetten naar het kanaal dat bij de server past. Vaak is het genoeg om te wachten tot de update bij iedereen is aangekomen.

Spelers blijven bij het verbinden hangen op het laadscherm#

Oorzaak:

• een fout in de multicharacter of in de database (het personage wordt niet geladen),
• een groot aantal modellen dat moet worden gedownload (auto's, kleding, maps) of een trage download,
• de eerste verbinding na een wijziging van sv_enforceGameBuild (de DLC wordt gedownload),
• een laadschermscript dat nooit wordt afgesloten.

Oplossing: kijk in de console van de server en in F8 bij de speler waar het laden is gestopt. Controleer bij een framework de verbinding met de database. Stel bij Qbox met een eigen multicharacter setr loadscreen:externalShutdown false in. Schakel grote pakketten met auto's en kleding tijdelijk uit en controleer of spelers dan verder komen.

De verbinding eindigt met een time-out (timed out) of connection refused#

Oorzaak:

• de poort in endpoint_add_tcp en endpoint_add_udp komt niet overeen met de poort op het tabblad Netwerk (komt vaak voor na het deployen van een txAdmin-recept, dat de standaardpoort 30120 invult),
• de server is niet volledig gestart (server.cfg is niet geladen, er draaien geen resources),
• de server is overbelast (processor of RAM zit op de limiet) of crasht op dit moment,
• op je eigen VPS blokkeert de firewall de poort.

Oplossing: vergelijk de poort in server.cfg met de regel Verbindingsadres. Controleer in de console of de resources zijn gestart (Started resource …). Controleer onder de console het gebruik van RAM en processor. Sta op een VPS de poort voor zowel TCP als UDP toe in de firewall (firewall).

Server artifact version is outdated (waarschuwing EOS of EOL)#

Oorzaak: de server draait op een oude build van FXServer. Met artifacts die ouder zijn dan 3 maanden kunnen spelers niet meer verbinden vanuit de serverlijst.

Oplossing: update de artifacts naar het kanaal Recommended (handleiding).

Native … is not supported, Error parsing script of Failed to load script#

Oorzaak: het script of het framework gebruikt functies die jouw serverversie niet kent.

Oplossing: update de artifacts naar Recommended. Als dat niet genoeg is, naar Latest.

txAdmin meldt een crash of het vastlopen van de server en herstart hem#

Oorzaak: de server is gecrasht of reageert niet meer. txAdmin start hem zelf opnieuw. Meestal gaat het om een scriptfout (een oneindige lus, een grote query naar de database), te weinig RAM of een pas geïnstalleerde resource.

Oplossing:

1. Open in txAdmin Live Console en System › Console Log en zoek de laatste fouten vóór de crash.
2. Controleer het RAM-gebruik onder de console in je klantaccount. Blijft het tegen de limiet aan zitten, haal dan resources weg of stap over op een groter pakket (tabblad Pakket wijzigen).
3. Zijn de crashes begonnen na het installeren of updaten van een script, schakel het script dan uit (commentarieer de ensure ervan uit) en controleer of de crashes stoppen.

## [txAdmin CFG validator]: … in server.cfg#

Oorzaak: txAdmin heeft een regel uitgecommentarieerd die niet in server.cfg mag staan, en heeft de reden achter de dubbele punt gezet. Meestal is dat:

• onesync MUST only be set in the txAdmin settings page. – bij txAdmin stel je OneSync in via Settings › FXServer.
• you MUST NOT start/stop/ensure txadmin resources. – verwijder de regel ensure monitor (txAdmin start vanzelf).
• the … port … is dedicated for txAdmin and CAN NOT be used for FXServer. – in endpoint_add_* staat de poort van txAdmin. Zet daar de gamepoort van het tabblad Netwerk neer.

Oplossing: corrigeer de regel op basis van de reden en verwijder de uitgecommentarieerde regel.

Your config file does not specify a valid endpoints for FXServer to use.#

Oorzaak: in server.cfg ontbreken de regels endpoint_add_tcp en endpoint_add_udp, of ze hebben een andere poort.

Oplossing: voeg aan het begin van server.cfg beide regels toe met de poort van het tabblad Netwerk:

endpoint_add_tcp "0.0.0.0:<PORT>"
endpoint_add_udp "0.0.0.0:<PORT>"

Vervang <PORT> door het getal achter de dubbele punt in de regel Verbindingsadres.

Je kunt niet meer dan 48 slots instellen#

Oorzaak: voor meer dan 48 spelers is het abonnement Element Club Argentum op de Cfx.re Portal nodig. Het abonnement zelf verhoogt het aantal slots niet.

Oplossing: verhoog na aankoop van het abonnement sv_maxclients in server.cfg (bij een server zonder txAdmin eventueel de variabele met de slots op het tabblad Instellingen) en herstart de server. Voor meer dan 64 slots is OneSync on nodig.

server thread hitch warning: timer interval of … milliseconds#

Oorzaak: één servertick duurde langer dan 150 ms en de server “haperde”. Bij het starten en het laden van resources is dat normaal. Komen de meldingen vaak terug terwijl de server draait, dan doet een script zwaar werk in één keer (grote databasequery's, lussen over alle spelers of entiteiten). Vergelijkbare meldingen bestaan ook voor de netwerkthread (network thread) en de synchronisatiethread (sync thread).

Oplossing: zoek de veroorzaker met de profiler: voer in de serverconsole profiler record 500 in en na afloop profiler saveJSON profil.json, download het bestand op het tabblad Bestanden en open het in de ontwikkelaarstools van Chrome (tabblad Performance). Optimaliseer, update of vervang het script daarna. Het helpt ook om het processorgebruik onder de console te controleren.

Warning: sending large event … (… bytes). This may cause performance issues. Consider using latent events instead.#

Oorzaak: een script stuurt in één event een grote hoeveelheid data tegelijk naar de spelers. Dat kan bij spelers lag en verbroken verbindingen veroorzaken.

Oplossing: leid uit de naam van het event af om welk script het gaat en meld het bij de auteur. Grote hoeveelheden data horen te worden verstuurd met zogenoemde latent events (in delen).

Could not contact the server browser#

Oorzaak: de server kan geen verbinding maken met de diensten van Cfx.re die de serverlijst bijhouden. Een enkele melding is onschuldig, bij aanhoudende herhaling verdwijnt de server uit de lijst.

Oplossing: herstart de server. Blijft de melding terugkomen, neem dan contact met ons op. Controleer op je eigen VPS of de firewall of de DDoS-bescherming de adressen van Cfx.re uit de lijst static.cfx.re/ips.txt (opent in een nieuw venster) doorlaat.

Can't restart a stopped resource.#

Oorzaak: je wilde met het commando restart een resource herstarten die niet draait.

Oplossing: gebruik ensure <NAME>. Dat start een resource die niet draait en herstart een resource die wel draait.

Waarschuwing Resource … does not specify an fx_version in fxmanifest.lua.#

Oorzaak: een ouder script heeft geen regel fx_version in het manifest.

Oplossing: voeg aan het begin van fxmanifest.lua de regels fx_version 'cerulean' en game 'gta5' toe. Een script met __resource.lua in plaats van fxmanifest.lua is erg oud, zoek een nieuwere versie.

Een auto of model wordt in het spel niet geladen#

Oorzaak: de modelnaam in het commando of het script komt niet overeen met de naam in vehicles.meta, de resource met het model draait niet, de regels data_file ontbreken in het manifest, of het model vereist een hogere game build.

Oplossing: controleer in de console of de resource met het model draait (Started resource …). Zoek in vehicles.meta de exacte modelnaam (modelName) en gebruik die om het voertuig te spawnen. Controleer of het manifest data_file voor vehicles.meta bevat (FiveM resources).

Als iets nog steeds niet werkt: wanneer je contact opneemt met support#

Neem contact met ons op (contactgegevens) als:

• de console in je klantaccount niet laadt of de knoppen Starten en Herstarten niet reageren,
• de server zelfs met het basisrecept van txAdmin en zonder extra scripts niet opstart,
• spelers de poort niet kunnen bereiken, ook al komt server.cfg overeen met het tabblad Netwerk,
• je toegang via SFTP nodig hebt voor grote bestanden.

Stuur de naam of het ID van de dienst, het tijdstip van het probleem, de exacte tekst van de fout (gekopieerd uit de console) en wat je als laatste hebt gewijzigd. Stuur nooit je license key of het wachtwoord van de database mee.

Meer bronnen#

• FiveM: Server Issues (opent in een nieuw venster)
• FiveM: Resource FAQ (opent in een nieuw venster)
• FiveM: Server Commands (opent in een nieuw venster)