Guia de resolució de problemes per a problemes comuns del servidor RedM, incloent errors de clau de llicència, visibilitat al navegador de servidors, fallades de recursos, connexions de clients, problemes de base de dades i optimització del rendiment. Per a instruccions de configuració inicial, consulteu la nostra Guia de configuració del servidor RedM.

Errors de clau de llicència

Els problemes amb la clau de llicència són el problema més comú en iniciar un nou servidor RedM. Aquí teniu els errors típics i les seves solucions:

"Invalid license key" o "Could not authenticate"

El servidor no apareix al navegador

Si el vostre servidor s'està executant però els jugadors no el troben al navegador de servidors de RedM:

Llista de verificació

1. Espereu almenys 5 minuts. Després d'iniciar-se, el servidor necessita temps per registrar-se a la llista mestra de servidors de Cfx.re. Els servidors nous poden trigar diversos minuts a aparèixer.
2. Verifiqueu que la clau de llicència és vàlida. El servidor no es llistarà sense una clau de llicència funcional. Comproveu la consola del servidor per a errors relacionats amb la llicència.
3. Comproveu la configuració dels punts finals. Assegureu-vos que endpoint_add_tcp i endpoint_add_udp a server.cfg utilitzen el port correcte:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   El port ha de coincidir amb el assignat a GPanel.
4. Comproveu la configuració de "sv_master1" o de llistat. Assegureu-vos que no heu configurat accidentalment el servidor perquè no es llisti. No hi hauria d'haver cap sv_master1 "" a la vostra configuració (això desactiva el registre a la llista mestra).
5. Verifiqueu que el servidor s'està executant realment. Comproveu la consola de GPanel. Si el servidor s'ha penjat o s'ha aturat, no apareixerà al navegador.
6. Proveu la connexió directa. Encara que el servidor no estigui al navegador, la connexió directa hauria de funcionar. Demaneu a un jugador que premi F8 a RedM i escrigui:

   connect YOUR_SERVER_IP:PORT

Fallades en la càrrega de recursos

Els errors de recursos són comuns quan s'afegeixen nous scripts o marcs al vostre servidor. Aquí teniu els problemes més freqüents:

"Could not find resource [resource_name]"

• La carpeta del recurs no existeix al directori resources/, o està en una ubicació incorrecta.
• El nom de la carpeta no coincideix amb el nom utilitzat a ensure. Els noms de recursos distingeixen entre majúscules i minúscules.
• Solució: Verifiqueu que la carpeta del recurs existeix i que el nom a server.cfg coincideix exactament. Utilitzeu el gestor de fitxers de GPanel o SFTP per comprovar-ho.

"Failed to load resource [resource_name]: manifest error"

• El fitxer fxmanifest.lua o __resource.lua del recurs té un error de sintaxi.
• El manifest fa referència a fitxers que no existeixen a la carpeta del recurs.
• Solució: Obriu el fitxer del manifest i comproveu si hi ha errors tipogràfics, comes que falten o referències a fitxers inexistents. Comproveu la consola del servidor per al número de línia específic de l'error.

"Error loading script [filename]: [error details]"

• Un fitxer Lua, C# o JavaScript dins del recurs té un error de sintaxi o d'execució.
• Solució: Llegiu el missatge d'error complet a la consola. Inclourà el nom del fitxer i el número de línia. Les causes comunes inclouen:
  • Dependències que falten (un altre recurs que s'ha de carregar primer)
  • Recurs obsolet no compatible amb la versió actual del servidor RedM
  • Valors de configuració incorrectes al fitxer de configuració del recurs

Problemes d'ordre de càrrega de recursos

Els recursos a server.cfg es carreguen en l'ordre en què apareixen. Si un recurs depèn d'un altre (p. ex., vorp_inventory depèn de vorp_core), la dependència ha d'estar llistada primer:

# 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

Problemes de connexió del client

Quan els jugadors no poden connectar-se al vostre servidor:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Contrasenya del servidor: Si sv_password està configurat, el jugador ha d'introduir la contrasenya correcta.
• Recurs de llista blanca: Si teniu un recurs de llista blanca activat, el jugador ha de ser aprovat abans de connectar-se.
• Prohibició: El jugador pot estar prohibit. Comproveu la vostra llista de prohibicions o la base de dades per als seus identificadors.

El client es penja en connectar-se

• Un recurs del servidor està enviant dades incorrectes o té un error de script del costat del client que fa que el client es pengi.
• Solució: Desactiveu els recursos afegits recentment un per un per identificar el problemàtic. Comproveu la consola del servidor per a errors durant la connexió del client.
• Assegureu-vos que el client RedM del jugador estigui actualitzat.

Errors "Could not download file"

• El servidor intenta enviar un fitxer gran (p. ex., un actiu d'streaming) que supera els límits de transferència o la connexió és inestable.
• Solució: Reduïu la mida dels actius d'streaming, utilitzeu un CDN/allotjament extern per a fitxers grans si és compatible, o demaneu al jugador que torni a provar la connexió.

Problemes de base de dades (MySQL / oxmysql)

La majoria de marcs de roleplay de RedM utilitzen MySQL per a l'emmagatzematge persistent de dades. El connector de base de dades més comú és oxmysql.

Errors de connexió fallida

Si oxmysql (o un altre connector MySQL) no es pot connectar, comproveu el següent:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

Taules que falten o errors d'esquema

Els marcs de roleplay sovint requereixen que les taules de la base de dades estiguin configurades abans de poder funcionar:

1. Consulteu la documentació del marc o el repositori de GitHub per a fitxers d'importació SQL (sovint anomenats database.sql, schema.sql o similar).
2. Importeu el fitxer SQL a la vostra base de dades utilitzant phpMyAdmin o un client MySQL.
3. Alguns marcs creen les taules automàticament en el primer inici. Assegureu-vos que l'usuari de la base de dades tingui privilegis de CREATE TABLE.

Problemes de rendiment

Si el vostre servidor RedM experimenta retard, una taxa de ticks baixa o un rendiment generalment deficient:

Identificar problemes de rendiment

Comproveu la consola del servidor per a avisos de rendiment. Els servidors RedM tenen com a objectiu una taxa de ticks d'entre 30 i 64 ticks per segon. Podeu monitoritzar-ho amb:

• Tauler de txAdmin: Si txAdmin està disponible, mostra mètriques de rendiment del servidor en temps real.
• Consola del servidor: Vigileu els avisos de "slow tick" o "resource hitch".
• Comanda resmon: Escriviu resmon 1 a la consola del servidor (o la consola F8) per activar el monitor de recursos, que mostra el temps de CPU per recurs.

Solucions comunes de rendiment

Pràctiques recomanades

• Programeu reinicis automàtics cada 6-12 hores utilitzant la funció de programació de GPanel o txAdmin per netejar problemes acumulats de memòria i entitats.
• Mantingueu els recursos actualitzats per beneficiar-vos de correccions de rendiment i optimitzacions.
• Eviteu funcionalitats duplicades — no executeu dos recursos que facin el mateix (p. ex., dos sistemes meteorològics).
• Proveu els nous recursos en un servidor de prova (o amb pocs jugadors) abans de desplegar-los al vostre servidor principal.
• Monitoritzeu les mètriques del servidor regularment a través de GPanel o txAdmin per detectar problemes aviat.

Consells generals de resolució de problemes

1. Llegiu sempre la sortida de la consola del servidor. Gairebé tots els errors inclouen un missatge a la consola que us indica què ha anat malament i on.
2. Reinicieu el servidor després de canvis de configuració. La majoria de canvis a server.cfg requereixen un reinici complet del servidor per tenir efecte.
3. Desactiveu els recursos un per un per aïllar problemes. Comenteu les línies ensure a server.cfg amb #.
4. Feu còpies de seguretat de les configuracions funcionals abans de fer canvis. Descarregueu el vostre server.cfg i la base de dades abans d'actualitzacions importants.
5. Consulteu els fòrums i la documentació de Cfx.re a docs.fivem.net per a documentació oficial que s'aplica tant a FiveM com a RedM.
6. Verifiqueu la compatibilitat dels recursos amb la versió del vostre servidor. Els recursos creats per a versions anteriors poden no funcionar amb les compilacions actuals de RedM.

Articles relacionats

• Guia de configuració del servidor RedM — Claus de llicència, configuració de server.cfg, gestió de recursos i connexió.
• Com trobar la IP i el port del vostre servidor
• Com pujar fitxers via SFTP
• Començar amb el vostre nou servidor

Necessiteu ajuda?

Encara teniu problemes amb el vostre servidor RedM? Obriu un tiquet de suport i incloeu qualsevol missatge d'error de la consola del vostre servidor. El nostre equip us ajudarà a diagnosticar i resoldre el problema.