Doet je FiveM Enhanced-gameserver niet wat je verwacht? Geen zorgen, de meeste problemen kun je snel zelf oplossen. FiveM Enhanced is de versie van FiveM voor GTA V Enhanced en bevindt zich bij Cfx.re nog in Early Access. Veel werkt hetzelfde als bij FiveM voor GTA V Legacy, maar sommige dingen werken anders. In deze handleiding vind je de meest voorkomende problemen, hun oorzaken en wat je eraan kunt doen.
Kijk bij een probleem eerst in de console van je server. Regels met [fivem-enhanced-entrypoint] laten zien wat je server bij het opstarten voorbereidt, bijvoorbeeld welke serverversie wordt geladen.
Server start niet: licentiesleutel ontbreekt
Zonder je eigen Cfx.re-licentiesleutel start je server niet. ZAP-Hosting levert geen sleutel mee, maar je kunt er gratis zelf een aanmaken in het Cfx.re-portaal. In de handleiding Je eigen licentiesleutel toevoegen lees je hoe.
Vul de sleutel in op het tabblad Configuratie, onder Startparameters, in het veld Cfx.re-licentiesleutel. Sla je wijzigingen op en start je server.
Server is online, maar niemand kan deelnemen
Bij de eerste start draait alleen txAdmin. txAdmin start de eigenlijke gameserver pas nadat je de installatie hebt afgerond.
- Klik bovenaan het dashboard van je gameserver op txAdmin openen. Je gebruikersnaam en wachtwoord vind je bij txAdmin in het Overzicht.
- Volg de installatiestappen en selecteer bijvoorbeeld een template onder Popular Recipes.
- Vul je Cfx.re-licentiesleutel in de Recipe Deployer in. Bij FiveM Enhanced vult ZapX deze niet automatisch voor je in.
- Rond de installatie af en start de server in txAdmin.
Je vindt alle stappen in de handleiding txAdmin instellen.
Nieuwe licentiesleutel of servernaam wordt niet toegepast
ZapX schrijft de velden Cfx.re-licentiesleutel en Servernaam bij elke start naar de server.cfg in de hoofdmap van je server. Heb je je server met een txAdmin-recept geïnstalleerd, dan gebruikt deze de server.cfg uit de profielmap van het recept, bijvoorbeeld Qbox_XXXXXX.base/server.cfg.
Wijzig de waarde daarom ook in txAdmin in de CFG Editor: sv_licenseKey voor de sleutel en sv_hostname en sets sv_projectName voor de naam. Start daarna je server opnieuw.
Spelers kunnen de server niet vinden of geen verbinding maken
Spelers hebben GTA V Enhanced en de speciale client FiveM for GTAV Enhanced nodig om verbinding te maken met je server. Je vindt deze op fivem.net via de knop ‘Download FiveM for GTAV Enhanced’. Verbinding maken met de normale FiveM-client voor GTA V Legacy werkt niet.
In Verbinding maken met de server lees je hoe je verbinding maakt.
Fout door sv_enforceGameBuild
FiveM Enhanced ondersteunt alleen de nieuwste game-build en laadt deze automatisch. Buildnummers uit FiveM Legacy, zoals sv_enforceGameBuild 3258 in een oude configuratie, zijn hier niet geschikt.
Verwijder de regel in txAdmin via de CFG Editor en start je server opnieuw. Wil je bewust de basisgame zonder DLC-content gebruiken, stel dan sv_enforceGameBuild 1 in.
Gekochte resources (Asset Escrow) werken niet
Asset Escrow, de beveiliging van gekochte resources uit het Cfx.re-portaal of Tebex, is volgens Cfx.re nog niet beschikbaar voor FiveM Enhanced. Deze resources werken daarom nog niet.
Vraag de maker of er een versie voor GTA V Enhanced beschikbaar is. Heb je de resources meteen nodig, dan is een gewone FiveM-server voor GTA V Legacy een betere keuze.
Maps, voertuigen of kleding ontbreken of zien er verkeerd uit
GTA V Enhanced gebruikt een nieuwer formaat voor modellen en textures. Staat er in een resource een map stream_enhanced, dan laadt je server deze in plaats van stream. Oude bestanden in de map stream werken nog wel, maar Cfx.re beschouwt dit als verouderd.
- Vraag de maker om een Enhanced-versie van de resource.
- Je kunt je eigen maps, voertuigen of kleding omzetten met Alchemist, de tool van Cfx.re voor Windows-pc's. Voor scripts en frameworks zoals ESX, QBCore of Qbox heb je Alchemist niet nodig.
- Grafische mods zijn tijdens Early Access niet mogelijk. Pure Mode staat in FiveM Enhanced altijd aan.
Een resource werkt niet met FiveM Enhanced
Niet elke resource voor FiveM Legacy werkt zonder aanpassingen met Enhanced. Sommige makers bieden een aparte versie aan; zo is vMenu bijvoorbeeld beschikbaar als aparte Enhanced-versie. Controleer bij het downloaden of de resource GTA V Enhanced ondersteunt.
Andere verschillen volgens Cfx.re: OneSync is alleen nog beschikbaar in Big Mode; onesync legacy is komen te vervallen. De ontwikkelaarsmodus voor client-ontwikkelaarstools moet je op de server inschakelen met sv_devMode. De oude opstartparameter +set moo 31337 werkt niet meer. Als sv_devMode is ingeschakeld voor alle spelers, beperkt Cfx.re de server tot acht spelers.
Opdrachten in de console komen niet aan
Je server draait met txAdmin. txAdmin accepteert geen opdrachten uit de console van ZapX, dus daar kun je alleen de uitvoer bekijken. Om dezelfde reden zijn er geen opdrachtenschema's op het tabblad Tijdschema's.
Gebruik de Live Console in txAdmin voor opdrachten. Geplande herstarts stel je ook in txAdmin in.
Een resource is uitgeschakeld
Voor elke start controleert ZapX je resources op bekende schadelijke code. Als de beveiligingsscan iets vindt, schakelt deze de betreffende resource uit en toont ZapX een melding met de resultaten in het Overzicht. De resource blijft behouden; alleen het manifest wordt vervangen door een tijdelijke aanduiding. Het origineel staat ernaast met de extensie .bkp, bijvoorbeeld fxmanifest.lua.bkp. Je vindt een lijst met alle resultaten in het bestand _removed_resources.log in de hoofdmap van je server.
Vervang de resource door een schone versie van de oorspronkelijke maker. Denk je zeker te weten dat het om een vals alarm gaat, neem dan contact op met onze support. Lees meer in Resource bevat verboden logica.
Een resource start niet
- Controleer of de resource met
ensurein deserver.cfgvan je profiel staat en of de naam precies overeenkomt met de mapnaam. - Resources die een database nodig hebben, starten vaak pas nadat je het SQL-bestand hebt geïmporteerd.
- Ontbreekt er een afhankelijkheid, zoals
ox_libofoxmysql, dan vermeldt de console dit bij het opstarten.
In Resources installeren lees je hoe je resources uploadt.
Databasefout in de console
Meldingen zoals Access denied of ECONNRESET van oxmysql wijzen op een probleem met de databaseverbinding. Je inloggegevens voor de database vind je op het tabblad Databases. Als je daar je wachtwoord opnieuw instelt, voert ZapX het automatisch in je server.cfg in, zolang de databasegebruiker van je server daar nog in staat. Alle details vind je in Problemen met de databaseverbinding oplossen.
Mijn wijzigingen in server.cfg zijn na een herstart verdwenen
ZapX stelt sommige waarden bij elke start opnieuw in:
- ZapX stelt
endpoint_add_tcpenendpoint_add_udpaltijd in op de poort van je server. Wijzig deze niet, anders is je server niet bereikbaar. - In de
server.cfgin de hoofdmap overschrijft ZapXsv_hostname,sets sv_projectNameensv_licenseKeymet de velden op het tabblad Configuratie. Ook stelt ZapXsv_maxclientsin op het aantal slots van je server.
Wijzig de servernaam en licentiesleutel daarom op het tabblad Configuratie, onder Startparameters.
Is mijn server up-to-date?
Bij elke start controleert je server de officiële downloadpagina van Cfx.re en downloadt deze automatisch de nieuwste serverversie voor GTA V Enhanced. Je kunt hier geen versie kiezen zoals bij FiveM Legacy. Je hoeft je server dus alleen opnieuw te starten om deze bij te werken. Je ziet in de console welke versie is geladen.
Omdat FiveM Enhanced nog in Early Access is, kunnen nieuwe versies fouten bevatten of functies missen.
Lag, haperingen of hoge belasting
Veel spelers, grote frameworks en niet-geoptimaliseerde resources verhogen het CPU- en geheugengebruik. Houd het gebruik in de gaten op het tabblad Statistieken. Je kunt resources ook tijdelijk uitschakelen en ze daarna één voor één weer toevoegen. Zo ontdek je snel welke resource de vertraging veroorzaakt.
Een hogere waarde voor sv_syncTickRate (standaard 60) kan de latentie verlagen, maar verhoogt de CPU-belasting per speler. Als je server voortdurend te weinig resources heeft, is een upgrade van je gameserver de eenvoudigste oplossing.
Piekende ping, verbroken verbindingen en DDoS
Piekende ping en verbroken verbindingen ontstaan vaak door een hoge belasting of doordat de serverlocatie ver van je spelers ligt. Gameservers zijn soms ook het doelwit van DDoS-aanvallen. ZAP-Hosting beschermt je server met ingebouwde verdedigingsmaatregelen. In de DDoS Manager zie je het inkomende verkeer en eerdere aanvallen. Vermoed je een routeringsprobleem of een aanval, neem dan contact op met onze support.
Regelmatige back-ups besparen je een hoop stress en gedoe. Maak regelmatig back-ups, zodat je bij problemen kunt terugkeren naar een oudere, werkende versie. We maken al elke dag automatisch een back-up van je gameserver. Met de ZapX Pass kun je daarnaast op elk moment zelf back-ups maken en met één klik herstellen. Met ZapX Pass Pro kun je dit zelfs automatisch doen volgens je eigen schema. Lees meer in onze handleiding over back-ups.
Met deze tips kun je de meest voorkomende problemen met je FiveM Enhanced-server zelf oplossen. Lukt dat niet? Maak dan een supportchat aan in je ZapX-klantaccount en beschrijf je probleem zo uitgebreid mogelijk, bij voorkeur met een fragment uit de console. We staan elke dag voor je klaar en helpen je graag verder! 🙂