Guía de solución de problemas para problemas comunes del servidor RedM, incluyendo errores de clave de licencia, visibilidad en el navegador de servidores, fallos de recursos, conexiones de clientes, problemas de base de datos y optimización del rendimiento. Para instrucciones de configuración inicial, consulta nuestra Guía de Configuración del Servidor RedM.

Errores de Clave de Licencia

Los problemas con la clave de licencia son el problema más común al iniciar un nuevo servidor RedM. Aquí están los errores típicos y sus soluciones:

"Invalid license key" o "Could not authenticate"

El Servidor No Aparece en el Navegador

Si tu servidor está funcionando pero los jugadores no pueden encontrarlo en el navegador de servidores de RedM:

Lista de Verificación

1. Espera al menos 5 minutos. Después de iniciar, el servidor necesita tiempo para registrarse en la lista maestra de servidores de Cfx.re. Los servidores nuevos pueden tardar varios minutos en aparecer.
2. Verifica que la clave de licencia sea válida. El servidor no aparecerá en la lista sin una clave de licencia funcional. Revisa la consola del servidor en busca de errores relacionados con la licencia.
3. Verifica la configuración de endpoints. Asegúrate de que endpoint_add_tcp y endpoint_add_udp en server.cfg usen el puerto correcto:

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

   El puerto debe coincidir con el asignado en GPanel.
4. Verifica "sv_master1" o configuraciones de listado. Asegúrate de que no hayas establecido accidentalmente que el servidor no se liste. No debe haber sv_master1 "" en tu configuración (esto desactiva el registro en la lista maestra).
5. Verifica que el servidor esté realmente en ejecución. Revisa la consola de GPanel. Si el servidor se detuvo o falló, no aparecerá en el navegador.
6. Intenta la conexión directa. Incluso si el servidor no está en el navegador, la conexión directa debería funcionar. Haz que un jugador presione F8 en RedM y escriba:

   connect YOUR_SERVER_IP:PORT

Fallos en la Carga de Recursos

Los errores de recursos son comunes al añadir nuevos scripts o frameworks a tu servidor. Aquí están los problemas más frecuentes:

"Could not find resource [resource_name]"

• La carpeta del recurso no existe en el directorio resources/, o está en la ubicación incorrecta.
• El nombre de la carpeta no coincide con el nombre usado en ensure. Los nombres de recursos distinguen entre mayúsculas y minúsculas.
• Solución: Verifica que la carpeta del recurso exista y que el nombre en server.cfg coincida exactamente. Usa el administrador de archivos de GPanel o SFTP para verificar.

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

• El archivo fxmanifest.lua o __resource.lua del recurso tiene un error de sintaxis.
• El manifiesto hace referencia a archivos que no existen en la carpeta del recurso.
• Solución: Abre el archivo del manifiesto y busca errores tipográficos, comas faltantes o referencias a archivos inexistentes. Revisa la consola del servidor para el número de línea específico del error.

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

• Un archivo Lua, C# o JavaScript dentro del recurso tiene un error de sintaxis o de ejecución.
• Solución: Lee el mensaje de error completo en la consola. Incluirá el nombre del archivo y el número de línea. Las causas comunes incluyen:
  • Dependencias faltantes (otro recurso que debe cargarse primero)
  • Recurso desactualizado no compatible con la versión actual del servidor RedM
  • Valores de configuración incorrectos en el archivo de configuración del recurso

Problemas de Orden de Carga de Recursos

Los recursos en server.cfg se cargan en el orden en que aparecen. Si un recurso depende de otro (por ejemplo, vorp_inventory depende de vorp_core), la dependencia debe listarse primero:

# 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

Problemas de Conexión del Cliente

Cuando los jugadores no pueden conectarse a tu servidor:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Contraseña del servidor: Si sv_password está configurado, el jugador debe ingresar la contraseña correcta.
• Recurso de whitelist/lista de permitidos: Si tienes un recurso de whitelist habilitado, el jugador debe ser aprobado antes de conectarse.
• Baneo: El jugador puede estar baneado. Revisa tu lista de baneos o base de datos para sus identificadores.

El cliente se cierra al conectarse

• Un recurso en el servidor está enviando datos incorrectos o tiene un error de script del lado del cliente que causa el cierre.
• Solución: Desactiva los recursos añadidos recientemente uno por uno para identificar el problemático. Revisa la consola del servidor en busca de errores durante la conexión del cliente.
• Asegúrate de que el cliente RedM del jugador esté actualizado.

Errores de "Could not download file"

• El servidor está intentando enviar un archivo grande (por ejemplo, un asset de streaming) que excede los límites de transferencia o la conexión es inestable.
• Solución: Reduce el tamaño de los assets transmitidos, usa un CDN/alojamiento externo para archivos grandes si es compatible, o haz que el jugador reintente la conexión.

Problemas de Base de Datos (MySQL / oxmysql)

La mayoría de los frameworks de roleplay de RedM usan MySQL para el almacenamiento persistente de datos. El conector de base de datos más común es oxmysql.

Errores de Conexión Fallida

Si oxmysql (u otro conector MySQL) no puede conectarse, verifica lo siguiente:

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

Tablas Faltantes o Errores de Esquema

Los frameworks de roleplay a menudo requieren que las tablas de la base de datos se configuren antes de funcionar:

1. Revisa la documentación del framework o el repositorio de GitHub para archivos de importación SQL (generalmente nombrados database.sql, schema.sql o similar).
2. Importa el archivo SQL en tu base de datos usando phpMyAdmin o un cliente MySQL.
3. Algunos frameworks crean tablas automáticamente en el primer inicio. Asegúrate de que el usuario de la base de datos tenga privilegios de CREATE TABLE.

Problemas de Rendimiento

Si tu servidor RedM experimenta lag, baja tasa de ticks o bajo rendimiento general:

Identificar Problemas de Rendimiento

Revisa la consola del servidor en busca de advertencias de rendimiento. Los servidores RedM apuntan a una tasa de ticks de alrededor de 30-64 ticks por segundo. Puedes monitorear esto con:

• Panel de txAdmin: Si txAdmin está disponible, muestra métricas de rendimiento del servidor en tiempo real.
• Consola del servidor: Observa advertencias de "slow tick" o "resource hitch".
• Comando resmon: Escribe resmon 1 en la consola del servidor (o la consola F8) para habilitar el monitor de recursos, que muestra el tiempo de CPU por recurso.

Soluciones Comunes de Rendimiento

Prácticas Recomendadas

• Programa reinicios automáticos cada 6-12 horas usando la función de programación de GPanel o txAdmin para limpiar problemas acumulados de memoria y entidades.
• Mantén los recursos actualizados para beneficiarte de correcciones de rendimiento y optimizaciones.
• Evita funcionalidad duplicada — no ejecutes dos recursos que hagan lo mismo (por ejemplo, dos sistemas de clima).
• Prueba nuevos recursos en un servidor de pruebas (o con bajo número de jugadores) antes de implementarlos en tu servidor principal.
• Monitorea las métricas del servidor regularmente a través de GPanel o txAdmin para detectar problemas tempranamente.

Consejos Generales de Solución de Problemas

1. Siempre lee la salida de la consola del servidor. Casi todos los errores incluyen un mensaje en la consola que te dice qué salió mal y dónde.
2. Reinicia el servidor después de cambios de configuración. La mayoría de los cambios en server.cfg requieren un reinicio completo del servidor para tomar efecto.
3. Desactiva recursos uno por uno para aislar problemas. Comenta las líneas ensure en server.cfg con #.
4. Mantén copias de seguridad de las configuraciones funcionales antes de hacer cambios. Descarga tu server.cfg y base de datos antes de actualizaciones importantes.
5. Consulta los foros y documentación de Cfx.re en docs.fivem.net para documentación oficial que aplica tanto a FiveM como a RedM.
6. Verifica la compatibilidad de los recursos con tu versión del servidor. Los recursos construidos para versiones anteriores pueden no funcionar con las compilaciones actuales de RedM.

Artículos Relacionados

• Guía de Configuración del Servidor RedM — Claves de licencia, configuración de server.cfg, gestión de recursos y conexión.
• Cómo Encontrar la IP y el Puerto de tu Servidor
• Cómo Subir Archivos vía SFTP
• Primeros Pasos con tu Nuevo Servidor

¿Necesitas Ayuda?

¿Sigues experimentando problemas con tu servidor RedM? Abre un ticket de soporte e incluye cualquier mensaje de error de la consola de tu servidor. Nuestro equipo te ayudará a diagnosticar y resolver el problema.