Cómo configurar el archivo server.cfg de tu servidor FiveM

El archivo server.cfg FiveM es el núcleo de configuración de cualquier servidor de este framework: ahí se definen convars, permisos, recursos y parámetros de sincronización que determinan si tu partida funciona sin cuelgues o se cae cada dos horas. Este artículo repasa, línea por línea, cómo montar un server.cfg sólido, con OneSync bien ajustado y una carga de recursos ordenada.

Estructura básica del server.cfg FiveM

Antes de tocar convars avanzadas conviene entender el orden de lectura del archivo. FXServer procesa el server.cfg de arriba hacia abajo, así que la posición de cada línea importa: los permisos deben cargarse antes de que se ejecuten los recursos que dependen de ellos, y las convars de red deben fijarse antes de abrir los endpoints.

Un esqueleto típico de server.cfg incluye, en este orden lógico:

• Convars de identidad del servidor (nombre, tags, ícono).
• Convars de red y de OneSync.
• Carga del archivo de permisos (ACE).
• Ensure/start de los recursos base y de gameplay.
• Convars específicas de recursos (bases de datos, claves de APIs externas).

Si necesitas desplegar este tipo de configuración en un entorno ya preparado con panel de gestión, consola en vivo y anti-DDoS incluido, puedes revisar el alojamiento servidor FiveM de Fly-Serv, donde el server.cfg se edita directamente desde el gestor de archivos sin pasar por FTP externo.

Convars esenciales del server.cfg FiveM

Las convars son variables que FXServer lee al arrancar. Algunas son obligatorias, otras opcionales pero recomendadas para evitar comportamientos erráticos en producción.

Identidad y conexión

sv_hostname "^2Mi servidor RP ^7| FiveM"
sv_projectName "Ciudad Libre RP"
sv_projectDesc "Roleplay serio, whitelist activa"
sv_maxclients 64
sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXX"
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

La sv_licenseKey se obtiene en el portal de Cfx.re y es obligatoria: sin ella el servidor no aparece en la lista y algunos recursos se niegan a iniciar. Ajusta sv_maxclients según la capacidad real de tu CPU: subir este valor sin tener recursos de procesamiento suficientes provoca ticks lentos y desincronización de entidades.

Convars de red y rendimiento

set sv_enforceGameBuild 2802
sets tags "roleplay, economy, whitelist"
set sv_scriptHookAllowed 0
set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

sv_enforceGameBuild fuerza a todos los clientes a usar la misma build del juego, lo que evita desincronizaciones de props y animaciones cuando un jugador tiene una versión distinta de FiveM. sv_scriptHookAllowed en 0 bloquea el uso de ScriptHookV, práctica estándar en servidores con anti-cheat activo.

OneSync: la convar que decide cuántos jugadores soporta tu server.cfg FiveM

OneSync es el sistema de sincronización de entidades que permite superar los 32 jugadores clásicos de GTA Online. Sin activarlo correctamente, cualquier intento de subir sv_maxclients por encima de ese límite genera pérdida de vehículos, NPCs fantasma y errores de colisión.

Configuración recomendada

set onesync on
set onesync_population true
set onesync_distanceCullVehicles true
set onesync_forceMigration true

Desde las versiones recientes de FXServer, onesync on activa el modo "infinity", pensado para servidores grandes con más de 128 jugadores. Si tu comunidad ronda los 32-64 jugadores, este mismo valor funciona sin penalización de rendimiento; lo importante es no dejarlo en legacy, un modo obsoleto que ya no recibe soporte activo.

Cull de entidades y distancia de simulación

onesync_distanceCullVehicles reduce la carga de red descartando vehículos fuera del radio de interés de cada jugador. En mapas grandes o servidores de rol con mucho tráfico, esta convar marca la diferencia entre una latencia estable y picos de lag cuando varios jugadores convergen en la misma zona.

Convar	Función	Valor recomendado
onesync	Activa la sincronización extendida de entidades	on
onesync_population	Gestiona el spawn de peds y tráfico por el servidor	true
onesync_distanceCullVehicles	Descarta vehículos lejanos para ahorrar ancho de banda	true

Permisos ACE, principals y carga de recursos

El sistema de permisos de FXServer se basa en ACE (Access Control Entries) y principals. Este bloque suele vivir en un archivo separado, permissions.cfg, que se importa desde el server.cfg con exec.

exec permissions.cfg
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.discord:XXXXXXXXXXXXXXXX group.admin

El orden importa: una regla deny escrita después de un allow más general sobreescribe el permiso para ese comando concreto. Es la forma correcta de dar acceso amplio a un grupo de administración pero bloquear comandos peligrosos como el reinicio forzado o el kick masivo.

Carga ordenada de recursos

Los recursos se cargan con ensure o start. La diferencia práctica: ensure reinicia el recurso si ya estaba cargado, útil durante pruebas; start simplemente lo arranca si no lo está.

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure fivem-map-skater

ensure oxmysql
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog

El orden de carga es crítico cuando hay dependencias: una base de datos como oxmysql debe iniciarse antes que cualquier framework de rol (ESX, QBCore) que dependa de una conexión activa a la base de datos. Si un recurso da error de "resource not found" al arrancar, revisa que su nombre coincida exactamente con la carpeta dentro de resources/ y que no haya un ensure duplicado más abajo sobreescribiendo el estado.

Convars de base de datos y variables de entorno

set mysql_connection_string "mysql://usuario:contraseña@localhost/basededatos?charset=utf8mb4"
set convar_category_visible false

Nunca dejes credenciales de base de datos en texto plano si compartes el server.cfg públicamente en un repositorio; usa variables separadas o un archivo .cfg adicional excluido del control de versiones.

Buenas prácticas de mantenimiento

• Comenta cada bloque de convars con # para saber qué recurso depende de qué configuración.
• Haz una copia de seguridad del server.cfg antes de instalar un recurso nuevo.
• Reinicia el servidor tras cada cambio de OneSync: esta convar no se aplica en caliente.
• Revisa la consola en vivo al reiniciar para detectar errores de sintaxis en el archivo.

Para administrar todo esto sin depender de accesos SSH manuales, un panel como Pterodactyl permite editar el server.cfg, ver la consola en tiempo real y reiniciar el recurso afectado en segundos. Puedes revisar todos nuestros servidores de juegos para comparar cómo se gestiona cada tipo de configuración según el título, o consultar la documentación oficial de FiveM para la lista completa de comandos y convars disponibles.

Diagnóstico rápido de errores comunes en el server.cfg

Cuando el servidor no arranca o se congela al cargar recursos, el problema casi siempre está en el server.cfg. Una checklist rápida ahorra horas de prueba y error.

El servidor no aparece en la lista

Verifica que sv_licenseKey esté presente y sea válida, que los puertos TCP/UDP estén correctamente declarados en endpoint_add_tcp y endpoint_add_udp, y que no haya un firewall bloqueando el puerto configurado (por defecto 30120).

Los jugadores se desconectan al superar cierto número

Casi siempre es un problema de OneSync mal configurado o de sv_maxclients por encima de lo que soporta el hardware. Comprueba también que onesync_population esté activo si usas más de 48 jugadores simultáneos.

Un recurso no inicia y bloquea el arranque

tail -f /home/container/logs/latest.log

Revisar el log en tiempo real muestra exactamente en qué línea del server.cfg falla la carga, ya sea por dependencia faltante, error de sintaxis en un ensure o conflicto de nombres entre dos recursos.

Si administras el entorno desde un VPS Pterodactyl, tienes acceso directo a la consola y al editor de archivos sin depender de un cliente FTP externo, lo que agiliza este tipo de diagnóstico línea por línea.

Un server.cfg bien estructurado, con convars ordenadas, OneSync ajustado al tamaño real de la comunidad y permisos ACE bien definidos, es lo que separa un servidor estable de uno que se cae en cada actualización de recursos. Revisa cada bloque con calma antes de reiniciar en producción.

FAQ

¿Por qué OneSync no se activa aunque la convar esté en "on"?

Comprueba que no haya otra línea más abajo en el server.cfg sobreescribiendo el valor, y que el número de sv_maxclients sea coherente con el modo elegido. También revisa la consola al arrancar: FXServer muestra un aviso si OneSync no pudo activarse por incompatibilidad de recursos.

¿En qué orden debo cargar los recursos en el server.cfg?

Primero las convars de identidad y red, luego el archivo de permisos con exec, después los recursos base del framework (mapmanager, base de datos) y por último los recursos de gameplay que dependen de ellos.

¿Cómo sé si un error viene del server.cfg o de un recurso concreto?

Revisa la consola en vivo justo después del reinicio: los errores de sintaxis en el server.cfg aparecen antes de que se carguen los recursos, mientras que los fallos de un recurso concreto se muestran con el nombre de la carpeta afectada.