Aquesta guia cobreix les solucions als problemes més habituals del servidor de FiveM — problemes d'accés a TXAdmin, errors de clau de llicència CFX, fallades de connexió a la base de dades, fallades del servidor, problemes de connexió dels jugadors i recursos que no es carreguen. Per a la configuració inicial del servidor, consulteu la Guia de configuració del servidor de FiveM.

TXAdmin no es carrega o no és accessible

• Verifiqueu que el servidor estigui en funcionament a GPanel — TXAdmin només s'inicia quan el procés del servidor de FiveM està actiu.
• Comproveu la consola de GPanel per a l'URL i el port de TXAdmin. El port de TXAdmin és diferent del port de joc.
• Assegureu-vos que esteu utilitzant http:// i no https:// — TXAdmin no utilitza SSL per defecte.
• Si TXAdmin funcionava abans però deixa de carregar, proveu de reiniciar el servidor des de GPanel.
• Esborreu la memòria cau del navegador o proveu amb una finestra d'incògnit/privada.

Errors de clau de llicència CFX

Errors de connexió a la base de dades

Passos addicionals per a la resolució de problemes de base de dades:

• Si utilitzeu oxmysql, assegureu-vos que teniu el recurs oxmysql a la carpeta resources/ i que ensure oxmysql apareix al server.cfg abans de qualsevol recurs que requereixi una base de dades.
• Si la vostra contrasenya conté caràcters especials com @, # o %, codifiqueu-los en format URL a la cadena de connexió (p. ex. @ es converteix en %40).
• Comproveu la vostra cadena de connexió per caràcters que faltin o sobrin — fins i tot un sol caràcter mal col·locat causarà una fallada.

El servidor falla en iniciar-se

• Comproveu la consola de GPanel per a missatges d'error. Les causes habituals inclouen un server.cfg absent o mal configurat, una clau de llicència CFX no vàlida o un recurs defectuós.
• Proveu de desactivar els recursos personalitzats comentant-los al server.cfg (afegiu # davant de cada línia ensure) i reinicieu. Torneu-los a afegir un per un per identificar el recurs problemàtic.
• Assegureu-vos que els ports a endpoint_add_tcp i endpoint_add_udp coincideixin amb el port assignat a GPanel.

# 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

Els jugadors no poden connectar-se

• Confirmeu que el servidor mostra Running a GPanel.
• Verifiqueu la IP i el port — els jugadors han d'utilitzar el port de joc, no el port de TXAdmin.
• Comproveu que sv_maxclients no estigui establert a 0 o a un nombre excessivament baix.
• Si utilitzeu una contrasenya de servidor (sv_password al server.cfg), assegureu-vos que els jugadors la coneguin.
• Els jugadors han de tenir el client de FiveM instal·lat — no es poden connectar utilitzant el llançador normal de GTA V.
• Comproveu la pestanya Network de GPanel i confirmeu que els ports a endpoint_add_tcp i endpoint_add_udp coincideixen. Una discrepància impedirà les connexions.

Els recursos no es carreguen

• Comproveu que la carpeta del recurs estigui dins del directori resources/ (o una subcarpeta adequada).
• Verifiqueu que el nom de la carpeta coincideix exactament amb la línia ensure al server.cfg (distingeix majúscules i minúscules).
• Cada recurs ha de contenir un fitxer fxmanifest.lua (o l'antic __resource.lua) vàlid. Si aquest fitxer no existeix, el recurs no es carregarà.
• Comproveu la consola de TXAdmin o GPanel per a missatges d'error relacionats amb el recurs. Els errors habituals inclouen dependències que falten o errors de sintaxi Lua.
• Si el recurs requereix un framework (ESX, QBCore), assegureu-vos que el framework es carregui abans del recurs al server.cfg.
• Si el recurs requereix una base de dades, assegureu-vos que el vostre recurs MySQL (oxmysql, mysql-async) estigui carregat i que la connexió a la base de dades funcioni.

Problemes de rendiment del servidor

• Obriu TXAdmin i comproveu el Dashboard per a les mètriques de rendiment (temps de tick, nombre de jugadors, ús de memòria).
• Un servidor de FiveM saludable hauria de mantenir un temps de tick del servidor (també anomenat "hitch") per sota de 20ms. Pics consistents per sobre d'aquest valor indiquen que un recurs està consumint massa temps de processament.
• Utilitzeu la pàgina de Resources de TXAdmin per identificar quins recursos consumeixen més temps del servidor.
• Elimineu o substituïu els recursos mal optimitzats. Els recursos gratuïts de fonts desconegudes sovint són la causa dels problemes de rendiment.
• Reduïu el nombre de recursos carregats si s'estan assolint els límits de memòria o CPU del vostre pla de servidor.

Obtenir ajuda

Si heu provat les solucions anteriors i encara teniu problemes:

1. Copieu el missatge d'error complet de la consola de GPanel o del registre de TXAdmin.
2. Anoteu quins passos de resolució de problemes ja heu provat.
3. Obriu un tiquet de suport a https://legionhosting.net/submitticket.php amb aquesta informació. El nostre equip us assistirà el més ràpid possible.

Articles relacionats

• Guia de configuració del servidor de FiveM
• Recursos, scripts i configuració de base de dades de FiveM
• Com trobar la IP i el port del vostre servidor
• Guia d'inici del servidor