Configurar server.cfg en FiveM : guía completa de recursos y OneSync

Configurar correctamente el server.cfg FiveM es el paso que separa un servidor estable de uno que se cae cada dos horas o que sufre de lag de sincronización constante. Este archivo controla los recursos que se cargan, el modo OneSync, los permisos y las variables de rendimiento que definen cómo se comporta tu instancia de Cfx.re en producción.

En este artículo repasamos, punto por punto, qué líneas debe contener un server.cfg funcional, cómo activar y ajustar OneSync según el número de jugadores, y qué variables de configuración suelen generar errores cuando se dejan por defecto o se copian sin entender su función.

Estructura básica del server.cfg FiveM

El server.cfg FiveM se ejecuta de arriba hacia abajo en cada arranque del proceso. El orden de las líneas importa: si defines un convar después de cargar un recurso que depende de él, ese recurso puede leer un valor vacío o por defecto. La estructura recomendada sigue siempre este orden lógico:

1. Información del servidor (nombre, tags, locale)
2. Variables de red y OneSync
3. Claves y credenciales (sv_licenseKey, steam_webApiKey)
4. Permisos ACE y roles
5. Carga de recursos (ensure)
6. Variables de gameplay específicas de los recursos

sv_hostname "Mi Servidor RP - FiveM"
sets tags "roleplay, economia, whitelist"
sets locale "es-ES"
sv_maxclients 64

Si estás preparando este archivo antes de poner el servidor en marcha, conviene tener claro dónde vas a alojarlo. Puedes revisar el alojamiento servidor FiveM de Fly-Serv, que incluye panel Pterodactyl para editar el server.cfg directamente desde el gestor de archivos, instalación instantánea del recurso base y anti-DDoS incluido por defecto, sin necesidad de tocar la infraestructura subyacente.

Recursos: orden de carga y ensure vs start

La instrucción ensure es la forma recomendada de cargar un recurso: si el recurso falla al arrancar, FiveM reintenta automáticamente. La instrucción start antigua no reintenta, por lo que casi todos los frameworks actuales (ESX, QBCore, QBox) la han sustituido por ensure en su documentación.

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Framework y dependencias
ensure oxmysql
ensure es_extended
ensure esx_menu_default

Un error habitual es cargar un recurso que depende de una base de datos (como oxmysql) después del recurso que la consume. Verifica siempre el orden: primero las librerías de conexión, después el framework, y al final los scripts de gameplay que dependen de ambos.

Errores comunes al declarar recursos

• Recurso duplicado: dos carpetas con el mismo nombre de resource dan un error silencioso en consola.
• Carpeta mal nombrada: el nombre de la carpeta debe coincidir exactamente con el que se referencia en el server.cfg, sin espacios ni tildes.
• fxmanifest.lua ausente: sin este archivo, el recurso no se registra aunque esté declarado con ensure.

Configurar OneSync en el server.cfg FiveM

OneSync es el sistema de sincronización de entidades que permite superar el límite clásico de 32 jugadores y sincronizar vehículos, peds y objetos entre todos los clientes conectados. Sin OneSync activo, cada jugador solo ve una parte limitada del mundo simulado por el servidor, lo que rompe cualquier escenario de roleplay con más de 32 usuarios simultáneos.

sv_maxclients 128
onesync on
onesync_population true
onesync_distanceCullVehicles true
onesync_forceMigration true

Modos disponibles: legacy, on e infinity

Modo	Jugadores recomendados	Uso típico
legacy	hasta 32	Servidores pequeños, sin necesidad de sincronización extendida
on	hasta 128	Roleplay estándar, la mayoría de frameworks ESX/QBCore
infinity	más de 128	Servidores grandes con recursos optimizados para carga masiva

El modo onesync on es el estándar actual para la mayoría de comunidades de roleplay. El modo onesync infinity exige más CPU por tick, ya que el servidor calcula la posición y el estado de muchas más entidades por segundo; en ese escenario, un procesador con buena frecuencia por núcleo marca una diferencia real en la fluidez percibida por los jugadores.

Variables de población y distancia de streaming

La densidad de tráfico y peatones que ve cada jugador se controla desde variables independientes de OneSync, pero que dependen de que este esté activo:

onesync_population true
sets sv_pedsDensity "1.0"
sets sv_vehicleDensity "1.0"
sets sv_scenarioDensity "1.0"

Bajar estos valores en servidores con muchos jugadores concurrentes reduce el número de entidades que el servidor debe sincronizar en cada tick, lo que ayuda a mantener el rendimiento cuando el mapa está muy poblado en zonas concretas, como el centro de una ciudad RP.

Permisos ACE y variables clave del server.cfg FiveM

El sistema de permisos de FiveM se basa en ACE (Access Control Entries) combinado con principals. Esto permite definir qué comandos, recursos o rutas de consola puede ejecutar cada rol sin tocar el código de los scripts.

add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:110000112345678 group.admin
add_principal identifier.license:abcdef1234567890 group.moderator

Variables de identidad y seguridad

• sv_licenseKey: clave única obtenida en el portal de Cfx.re, obligatoria para que el servidor aparezca en la lista pública.
• steam_webApiKey: necesaria si usas identificadores Steam para el sistema de permisos o whitelist.
• sv_authMaxVariance y sv_authMinTrust: controlan el nivel de verificación de identidad de FiveM, útiles contra cuentas sospechosas.
• rcon_password: define una contraseña robusta y distinta a cualquier otra usada en el panel; el acceso RCON mal protegido es una de las vías más comunes de compromiso de un servidor.

sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXX"
steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXX"
rcon_password "una-contraseña-larga-y-unica"
sv_authMinTrust 5

Buenas prácticas de administración

• Nunca subas el server.cfg con claves reales a un repositorio público; usa variables de entorno o un archivo separado ignorado por git.
• Activa whitelist temporal (sv_enforceGameBuild y un recurso de whitelist) durante pruebas de recursos nuevos, antes de abrir el servidor al público.
• Programa sauvegardas regulares del server.cfg y de la base de datos antes de cada actualización de framework, para poder revertir rápido si un recurso rompe la sincronización.
• Revisa la consola tras cada reinicio: los errores de carga de recursos aparecen ahí antes que en cualquier reporte de jugador.

Para gestionar todo esto sin depender de una máquina personal encendida 24/7, muchas comunidades optan por administrar su instancia desde un VPS Pterodactyl, donde el panel permite editar el server.cfg, reiniciar el proceso y consultar la consola en vivo sin acceso SSH directo. Si además gestionas un servidor complementario en el mismo universo de roleplay, el Servidor RedM comparte buena parte de esta lógica de configuración basada en Cfx.re.

Diagnóstico rápido de problemas frecuentes

Cuando el servidor arranca pero los jugadores no pueden conectarse, o ven el mundo con retraso, el problema casi siempre está en una de estas cuatro áreas del server.cfg FiveM:

Síntoma	Causa probable	Revisar
Servidor no aparece en la lista	Licencia inválida o ausente	sv_licenseKey
Vehículos y jugadores "saltan"	OneSync desactivado o mal configurado	onesync, onesync_population
Recurso no carga sin error visible	Dependencia cargada en orden incorrecto	orden de ensure
Comandos de admin no funcionan	ACE mal asignado al identifier	add_ace, add_principal

Antes de tocar código, revisa siempre la consola del proceso: la mayoría de errores de resource loading incluyen el nombre exacto del recurso y la línea del fxmanifest.lua que falla, lo que ahorra mucho tiempo de depuración.

Si buscas comparar otras opciones dentro del catálogo, puedes consultar Todos nuestros servidores de juegos antes de decidir cómo estructurar tu infraestructura de roleplay o de mundo abierto.

Conclusión

Un server.cfg bien estructurado, con OneSync ajustado al número real de jugadores y permisos ACE bien definidos, es la base de cualquier instancia FiveM estable. Revisa el orden de carga de recursos, protege tus claves y mantén una sauvegarda reciente antes de cada cambio importante.

FAQ

¿Por qué mis vehículos y jugadores parpadean o desaparecen con OneSync activado?

Suele deberse a una densidad de entidades demasiado alta para la CPU disponible o a onesync_population mal configurado. Baja sv_vehicleDensity y sv_pedsDensity, y confirma que onesync_forceMigration esté activo para redistribuir la carga entre clientes.

¿Qué diferencia hay entre ensure y start en el server.cfg FiveM?

Ensure reintenta cargar el recurso si falla al primer intento, mientras que start no lo hace. Por eso los frameworks modernos como ESX o QBCore recomiendan usar siempre ensure para evitar recursos que quedan sin iniciar tras un reinicio.

¿Cómo sé si mi sv_licenseKey es válida?

Revisa la consola al arrancar: si la clave es incorrecta o está vacía, FiveM lo indica explícitamente y el servidor no aparecerá en la lista pública de Cfx.re. Genera una nueva desde el portal oficial si el error persiste.