Probleemoplossingshandleiding voor veelvoorkomende RedM-serverproblemen, waaronder licentiesleutelfouten, zichtbaarheid in de serverbrowser, resource-fouten, clientverbindingen, databaseproblemen en prestatie-optimalisatie. Voor de eerste installatie-instructies, zie onze RedM Server Installatiehandleiding.
Licentiesleutelfouten
Licentiesleutelproblemen zijn het meest voorkomende probleem bij het starten van een nieuwe RedM server. Hier zijn de typische fouten en hun oplossingen:
"Invalid license key" of "Could not authenticate"
| Oorzaak | Oplossing |
|---|---|
| Licentiesleutel is verkeerd getypt of bevat extra spaties | Kopieer de sleutel rechtstreeks vanuit Keymaster. Verwijder eventuele spaties aan het begin of einde van de CFX_LICENSE opstartvariabele in GPanel of de sv_licenseKey regel in server.cfg. |
| IP-adres komt niet overeen | De sleutel is geregistreerd op een ander IP dan het werkelijke IP van je server. Ga naar Keymaster, controleer het geregistreerde IP en werk het bij zodat het overeenkomt met het IP van je server in GPanel. |
| Sleutel is ingesteld in zowel GPanel als server.cfg met verschillende waarden | Zorg ervoor dat de sleutel consistent is. Het is het beste om deze in te stellen in de GPanel opstartvariabele en het egg de sleutel aan de server te laten doorgeven. Verwijder of becommentarieer sv_licenseKey in server.cfg als GPanel dit afhandelt. |
| Cfx.re-accountprobleem of sleutel ingetrokken | Log in op Keymaster en controleer of de sleutel nog actief is. Genereer een nieuwe sleutel als de oude is verwijderd of verlopen. |
| Keymaster-service is tijdelijk niet beschikbaar | Controleer de Cfx.re statuspagina voor storingen. Wacht en probeer het later opnieuw. |
Belangrijk: Als je onlangs een nieuwe server hebt ontvangen of als je server-IP is gewijzigd (bijv. na een nodemigratie), moet je het IP bijwerken in Keymaster of een nieuwe licentiesleutel genereren. De oude sleutel werkt niet op een ander IP.
Server verschijnt niet in de browser
Als je server draait maar spelers deze niet kunnen vinden in de RedM serverbrowser:
Checklist
- Wacht minstens 5 minuten. Na het opstarten heeft de server tijd nodig om zich te registreren bij de Cfx.re master-serverlijst. Nieuwe servers kunnen enkele minuten nodig hebben om te verschijnen.
- Controleer of de licentiesleutel geldig is. De server wordt niet vermeld zonder een werkende licentiesleutel. Controleer de serverconsole op licentiesleutel-gerelateerde fouten.
- Controleer de eindpuntconfiguratie. Zorg ervoor dat
endpoint_add_tcpenendpoint_add_udpinserver.cfgde juiste port gebruiken:
De port moet overeenkomen met de port toegewezen in GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Controleer op "sv_master1" of lijstinstellingen. Zorg ervoor dat je niet per ongeluk de server hebt ingesteld om zichzelf niet te vermelden. Er mag geen
sv_master1 ""in je configuratie staan (dit schakelt master-lijstregistratie uit). - Controleer of de server daadwerkelijk draait. Controleer de GPanel console. Als de server is gecrashed of gestopt, verschijnt deze niet in de browser.
- Probeer direct te verbinden. Zelfs als de server niet in de browser staat, zou directe verbinding moeten werken. Laat een speler op F8 drukken in RedM en het volgende typen:
connect YOUR_SERVER_IP:PORT
Tip: Je kunt controleren of je server bereikbaar is door de Cfx.re server lookup te gebruiken. Probeer naar
http://YOUR_SERVER_IP:PORT/info.json te navigeren in een webbrowser. Als de server draait en toegankelijk is, retourneert deze een JSON-antwoord met serverinformatie.
Resource-laadfouten
Resource-fouten komen vaak voor bij het toevoegen van nieuwe scripts of frameworks aan je server. Hier zijn de meest voorkomende problemen:
"Could not find resource [resource_name]"
- De resourcemap bestaat niet in de
resources/directory, of bevindt zich op de verkeerde locatie. - De mapnaam komt niet overeen met de naam die wordt gebruikt in
ensure. Resourcenamen zijn hoofdlettergevoelig. - Oplossing: Controleer of de resourcemap bestaat en de naam in
server.cfgexact overeenkomt. Gebruik de GPanel bestandsbeheerder of SFTP om dit te controleren.
"Failed to load resource [resource_name]: manifest error"
- De
fxmanifest.luaof__resource.luavan de resource bevat een syntaxfout. - Het manifest verwijst naar bestanden die niet bestaan in de resourcemap.
- Oplossing: Open het manifestbestand en controleer op typefouten, ontbrekende komma's of verwijzingen naar niet-bestaande bestanden. Controleer de serverconsole voor het specifieke regelnummer van de fout.
"Error loading script [filename]: [error details]"
- Een Lua-, C#- of JavaScript-bestand binnen de resource bevat een syntax- of runtimefout.
- Oplossing: Lees de volledige foutmelding in de console. Deze bevat de bestandsnaam en het regelnummer. Veelvoorkomende oorzaken zijn:
- Ontbrekende afhankelijkheden (een andere resource die eerst geladen moet worden)
- Verouderde resource die niet compatibel is met de huidige RedM serverversie
- Onjuiste configuratiewaarden in het configuratiebestand van de resource
Problemen met resource-laadvolgorde
Resources in server.cfg worden geladen in de volgorde waarin ze verschijnen. Als een resource afhankelijk is van een andere (bijv. vorp_inventory is afhankelijk van vorp_core), moet de afhankelijkheid eerst worden vermeld:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Waarschuwing: Als een resource niet kan worden geladen, zullen alle resources die ervan afhankelijk zijn ook falen. Controleer altijd de console-uitvoer zorgvuldig om de hoofdoorzaak te identificeren, wat meestal de eerste fout is die verschijnt.
Clientverbindingsproblemen
Wanneer spelers geen verbinding kunnen maken met je server:
"Connection timed out" / "Failed to connect"
| Oorzaak | Oplossing |
|---|---|
| Server draait niet | Controleer de GPanel console om te bevestigen dat de server online is en niet is gecrashed. |
| Verkeerd IP of verkeerde port | Controleer of de speler het juiste IP en de juiste port van GPanel gebruikt. Zie Hoe je je server IP en port vindt. |
| Eindpuntmisconfiguratie | Zorg ervoor dat endpoint_add_tcp en endpoint_add_udp in server.cfg de port 0.0.0.0:PORT gebruiken waarbij PORT overeenkomt met GPanel. |
| Server is vol | Controleer of sv_maxclients is bereikt. Verhoog de waarde als je hostingpakket dit toelaat. |
"Connection rejected by server"
- Serverwachtwoord: Als
sv_passwordis ingesteld, moet de speler het juiste wachtwoord invoeren. - Whitelist/allowlist resource: Als je een whitelist-resource hebt ingeschakeld, moet de speler goedgekeurd worden voordat deze kan verbinden.
- Ban: De speler is mogelijk verbannen. Controleer je banlijst of database op hun identifiers.
Client crasht bij verbinden
- Een resource op de server stuurt foutieve data of heeft een client-side scriptfout die de client laat crashen.
- Oplossing: Schakel recent toegevoegde resources één voor één uit om de problematische te identificeren. Controleer de serverconsole op fouten tijdens het verbinden van de client.
- Zorg ervoor dat de RedM-client van de speler up-to-date is.
"Could not download file" fouten
- De server probeert een groot bestand (bijv. een streaming asset) te versturen dat de overdrachtslimieten overschrijdt of de verbinding is instabiel.
- Oplossing: Verklein de omvang van gestreamde assets, gebruik een CDN/externe hosting voor grote bestanden indien ondersteund, of laat de speler de verbinding opnieuw proberen.
Databaseproblemen (MySQL / oxmysql)
De meeste RedM roleplay-frameworks gebruiken MySQL voor permanente gegevensopslag. De meest gebruikte databaseconnector is oxmysql.
Verbindingsfouten
Als oxmysql (of een andere MySQL-connector) geen verbinding kan maken, controleer het volgende:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Fout | Oplossing |
|---|---|
ECONNREFUSED of "Connection refused" |
De MySQL-server draait niet, de host/port is verkeerd, of de MySQL-server accepteert geen externe verbindingen. Controleer de host, port en of je databaseserver online is. |
ER_ACCESS_DENIED_ERROR |
Verkeerde gebruikersnaam of wachtwoord in de verbindingsstring. Controleer de inloggegevens in je database-hostingpaneel. |
ER_BAD_DB_ERROR |
De databasenaam bestaat niet. Maak eerst de database aan via je databasebeheerpaneel (phpMyAdmin, etc.). |
ETIMEDOUT |
De databaseserver is onbereikbaar. Controleer of er firewallregels zijn die de verbinding blokkeren, of of de databasehost correct is. |
| "Too many connections" | De database heeft de maximale verbindingslimiet bereikt. Dit kan gebeuren als resources verbindingen niet correct sluiten, of als de limiet te laag is. Herstart de server en controleer je MySQL max_connections instelling. |
Tip: Als je RedM server en MySQL-database op dezelfde machine staan, gebruik dan
localhost of 127.0.0.1 als host. Als ze op verschillende servers staan, gebruik dan het IP-adres van de databaseserver en zorg ervoor dat de MySQL-gebruiker rechten heeft voor externe verbindingen.
Ontbrekende tabellen of schemafouten
Roleplay-frameworks vereisen vaak dat databasetabellen zijn aangemaakt voordat ze kunnen functioneren:
- Controleer de documentatie of GitHub-repository van het framework op SQL-importbestanden (vaak genaamd
database.sql,schema.sqlof iets dergelijks). - Importeer het SQL-bestand in je database met phpMyAdmin of een MySQL-client.
- Sommige frameworks maken automatisch tabellen aan bij de eerste start. Zorg ervoor dat de databasegebruiker
CREATE TABLE-rechten heeft.
Prestatieproblemen
Als je RedM server last heeft van lag, een lage tick rate of algeheel slechte prestaties:
Prestatieproblemen identificeren
Controleer de serverconsole op prestatiewaarschuwingen. RedM-servers streven naar een tick rate van ongeveer 30-64 ticks per seconde. Je kunt dit monitoren met:
- txAdmin dashboard: Als txAdmin beschikbaar is, toont het real-time serverprestatiemetrics.
- Serverconsole: Let op waarschuwingen over "slow tick" of "resource hitch".
- resmon commando: Typ
resmon 1in de serverconsole (of F8 console) om de resource monitor in te schakelen, die CPU-tijd per resource toont.
Veelvoorkomende prestatie-oplossingen
| Probleem | Oplossing |
|---|---|
| Hoog CPU-gebruik door een specifieke resource | Gebruik resmon 1 om de resource te identificeren. Overweeg deze te vervangen door een beter geoptimaliseerd alternatief, of neem contact op met de resource-ontwikkelaar. |
| Te veel resources geladen | Elke resource verbruikt serverbronnen. Controleer je resourcelijst en verwijder resources die ongebruikt of overbodig zijn. |
| Database-query bottleneck | Trage of niet-geïndexeerde databasequery's kunnen serverhaperingen veroorzaken. Controleer oxmysql waarschuwingen voor trage query's in de console. Voeg indexen toe aan veelgebruikte kolommen. |
| Hoog aantal spelers veroorzaakt lag | Verlaag sv_maxclients naar een niveau dat je serverhardware aankan. Overweeg je hostingpakket te upgraden voor meer bronnen. |
| OneSync entiteitslimieten | Te veel gespawnde entiteiten (peds, voertuigen, objecten) kunnen de prestaties verslechteren. Gebruik resources die ongebruikte entiteiten opruimen. |
| Geheugenlekken | Sommige slecht gecodeerde resources lekken na verloop van tijd geheugen. Monitor het RAM-gebruik van de server in GPanel. Regelmatige serverherstarts (elke 6-12 uur) kunnen dit verminderen. |
Aanbevolen werkwijzen
- Plan automatische herstarts elke 6-12 uur met de planningsfunctie van GPanel of txAdmin om opgehoopt geheugen en entiteitsproblemen te verhelpen.
- Houd resources up-to-date om te profiteren van prestatieverbeteringen en optimalisaties.
- Vermijd dubbele functionaliteit — draai geen twee resources die hetzelfde doen (bijv. twee weersystemen).
- Test nieuwe resources op een testserver (of met een laag aantal spelers) voordat je ze op je hoofdserver uitrolt.
- Monitor servermetrics regelmatig via GPanel of txAdmin om problemen vroegtijdig te signaleren.
Opmerking: Als je ondanks optimalisatie consistent prestatieproblemen ervaart, heeft je server mogelijk een hoger hostingpakket nodig met meer CPU- en RAM-bronnen. Neem contact op met ons supportteam om upgrade-opties te bespreken.
Algemene tips voor probleemoplossing
- Lees altijd de uitvoer van de serverconsole. Bijna elke fout bevat een bericht in de console dat je vertelt wat er fout ging en waar.
- Herstart de server na configuratiewijzigingen. De meeste wijzigingen aan
server.cfgvereisen een volledige serverherstart om van kracht te worden. - Schakel resources één voor één uit om problemen te isoleren. Becommentarieer
ensureregels inserver.cfgmet#. - Maak back-ups van werkende configuraties voordat je wijzigingen aanbrengt. Download je
server.cfgen database vóór grote updates. - Controleer Cfx.re forums en documentatie op docs.fivem.net voor officiële documentatie die van toepassing is op zowel FiveM als RedM.
- Controleer de resourcecompatibiliteit met je serverversie. Resources die voor oudere versies zijn gebouwd, werken mogelijk niet met huidige RedM-builds.
Gerelateerde artikelen
- RedM Server Installatiehandleiding — Licentiesleutels, server.cfg configuratie, resourcebeheer en verbinden.
- Hoe je je server IP en port vindt
- Bestanden uploaden via SFTP
- Aan de slag met je nieuwe server
Hulp nodig?
Ervaar je nog steeds problemen met je RedM server? Open een supportticket en vermeld eventuele foutmeldingen uit je serverconsole. Ons team helpt je bij het diagnosticeren en oplossen van het probleem.
