Esta guía cubre soluciones a los problemas más comunes de servidores FiveM — problemas de acceso a TXAdmin, errores de clave de licencia CFX, fallos de conexión a la base de datos, caídas del servidor, problemas de conexión de jugadores y recursos que no cargan. Para la configuración inicial del servidor, consulta la Guía de Configuración del Servidor FiveM.
Consejo general de solución de problemas: Siempre revisa primero la salida de la consola de GPanel y los registros de TXAdmin. La mayoría de los errores producen un mensaje claro que señala la causa.
TXAdmin no carga o es inaccesible
- Verifica que el servidor esté en ejecución en GPanel — TXAdmin solo se inicia cuando el proceso del servidor FiveM está activo.
- Revisa la consola de GPanel para ver la URL y el puerto de TXAdmin. El puerto de TXAdmin es diferente al puerto del juego.
- Asegúrate de estar usando
http://y nohttps://— TXAdmin no usa SSL por defecto. - Si TXAdmin funcionaba antes pero deja de cargar, intenta reiniciar el servidor desde GPanel.
- Limpia la caché de tu navegador o prueba en una ventana de incógnito/privada.
¿Perdiste tu contraseña de TXAdmin? Si no puedes iniciar sesión, puede que necesites eliminar los datos del perfil de TXAdmin y volver a ejecutar el asistente de configuración. Revisa la pestaña de Archivos de GPanel para encontrar el directorio de datos de TXAdmin y elimina sus archivos de perfil, luego reinicia el servidor.
Errores de Clave de Licencia CFX
| Mensaje de Error | Causa | Solución |
|---|---|---|
Invalid license key |
Clave copiada incorrectamente o con espacios en blanco adicionales | Ve a Keymaster, confirma que la clave esté activa y cópiala cuidadosamente. Pégala tanto en la variable de Inicio de GPanel como en sv_licenseKey en server.cfg. |
License key already in use |
La clave está registrada con una IP de servidor diferente | Cada clave solo puede usarse en un servidor a la vez. Revoca la clave anterior en Keymaster y genera una nueva con la IP actual de tu servidor. |
Unable to verify license key |
Los servidores de autenticación de Cfx.re no están disponibles temporalmente | Espera unos minutos y reinicia el servidor. Revisa status.cfx.re para ver interrupciones del servicio. |
Consejo: Asegúrate de que la clave esté configurada en ambos lugares: la variable de Inicio de GPanel y en
server.cfg (sv_licenseKey). Dependiendo de tu configuración, el servidor puede leer de uno u otro.
Errores de Conexión a la Base de Datos
| Mensaje de Error | Causa | Solución |
|---|---|---|
Connection refused o ETIMEDOUT |
Host o puerto de base de datos incorrecto | Verifica la dirección del host y el puerto de la base de datos desde la pestaña Databases de GPanel. No uses localhost ni 127.0.0.1. |
Access denied |
Usuario o contraseña incorrectos | Copia las credenciales directamente desde GPanel para evitar errores tipográficos. Las contraseñas distinguen entre mayúsculas y minúsculas. |
Unknown database |
El nombre de la base de datos no coincide | Asegúrate de que el nombre de la base de datos en tu cadena de conexión coincida exactamente con lo que se muestra en GPanel. |
Pasos adicionales para solucionar problemas de base de datos:
- Si usas oxmysql, asegúrate de tener el recurso
oxmysqlen tu carpetaresources/y queensure oxmysqlaparezca en server.cfg antes de cualquier recurso que requiera base de datos. - Si tu contraseña contiene caracteres especiales como
@,#o%, codifícalos en formato URL en la cadena de conexión (por ejemplo,@se convierte en%40). - Revisa tu cadena de conexión en busca de caracteres faltantes o adicionales — incluso un solo carácter mal colocado causará un fallo.
No uses localhost. El servidor de base de datos está separado del servidor de juego. Siempre usa la dirección completa del host que se muestra en la pestaña Databases de GPanel.
El Servidor se Cae al Iniciar
- Revisa la consola de GPanel en busca de mensajes de error. Las causas comunes incluyen un
server.cfgfaltante o mal configurado, una clave de licencia CFX inválida o un recurso dañado. - Intenta desactivar los recursos personalizados comentándolos en server.cfg (agrega
#antes de cada líneaensure) y reinicia. Agrégalos de nuevo uno a la vez para identificar el recurso problemático. - Asegúrate de que los puertos en
endpoint_add_tcpyendpoint_add_udpcoincidan con el puerto asignado en 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
Búsqueda binaria de recursos problemáticos: Si tienes muchos recursos, comenta la mitad a la vez en lugar de uno por uno. Esto reduce el problema mucho más rápido.
Los Jugadores No Pueden Conectarse
- Confirma que el servidor muestre Running en GPanel.
- Verifica la IP y el puerto — los jugadores deben usar el puerto del juego, no el puerto de TXAdmin.
- Comprueba que
sv_maxclientsno esté configurado en 0 o un número excesivamente bajo. - Si usas una contraseña de servidor (
sv_passworden server.cfg), asegúrate de que los jugadores la conozcan. - Los jugadores deben tener el cliente FiveM instalado — no pueden conectarse usando el lanzador normal de GTA V.
- Revisa la pestaña Network de GPanel y confirma que los puertos en
endpoint_add_tcpyendpoint_add_udpcoincidan. Una discrepancia impedirá las conexiones.
¿El servidor no aparece en el navegador? Los servidores nuevos pueden tardar de 5 a 15 minutos en aparecer en la lista de servidores de FiveM. Usa la conexión directa (
IP:PORT) mientras tanto. También verifica que tu sv_licenseKey sea válida.
Los Recursos No Cargan
- Verifica que la carpeta del recurso esté dentro del directorio
resources/(o una subcarpeta apropiada). - Comprueba que el nombre de la carpeta coincida exactamente con la línea
ensureen server.cfg (distingue mayúsculas y minúsculas). - Cada recurso debe contener un archivo
fxmanifest.luaválido (o el antiguo__resource.lua). Si este archivo falta, el recurso no cargará. - Revisa la consola de TXAdmin o GPanel en busca de mensajes de error relacionados con el recurso. Los errores comunes incluyen dependencias faltantes o errores de sintaxis de Lua.
- Si el recurso requiere un framework (ESX, QBCore), asegúrate de que el framework se cargue antes del recurso en server.cfg.
- Si el recurso requiere una base de datos, asegúrate de que tu recurso MySQL (oxmysql, mysql-async) esté cargado y la conexión a la base de datos funcione.
Revisa la estructura de carpetas. Un error común es subir un recurso y terminar con una carpeta doblemente anidada como
resources/my-resource/my-resource/fxmanifest.lua. El manifiesto debe estar directamente dentro de la carpeta del recurso: resources/my-resource/fxmanifest.lua.
Problemas de Rendimiento del Servidor
- Abre TXAdmin y revisa el Dashboard para ver las métricas de rendimiento (tiempo de tick, cantidad de jugadores, uso de memoria).
- Un servidor FiveM saludable debe mantener un tiempo de tick del servidor (también llamado "hitch") por debajo de 20ms. Picos consistentes por encima de esto indican que un recurso está usando demasiado tiempo de procesamiento.
- Usa la página de Resources de TXAdmin para identificar qué recursos consumen más tiempo del servidor.
- Elimina o reemplaza recursos mal optimizados. Los recursos gratuitos de fuentes desconocidas suelen ser la causa de problemas de rendimiento.
- Reduce la cantidad de recursos cargados si se están alcanzando los límites de memoria o CPU de tu plan de servidor.
Obtener Ayuda
Si has probado las soluciones anteriores y sigues experimentando problemas:
- Copia el mensaje de error completo de la consola de GPanel o del registro de TXAdmin.
- Anota qué pasos de solución de problemas ya has intentado.
- Abre un ticket de soporte en https://legionhosting.net/submitticket.php con esta información. Nuestro equipo te asistirá lo más rápido posible.
