server.cfg de FiveM explicado: líneas clave y ejemplo

server.cfg es el fichero de texto que FXServer lee al arrancar: define los puertos en los que escucha el servidor, la clave de licencia, el número de plazas, el game build y qué recursos se cargan. Cada línea es un comando de consola o una convar, y se ejecutan de arriba abajo. Si usas txAdmin, el fichero está en la carpeta de datos del servidor y su ubicación exacta se define en Settings > FXServer (Server Data Folder y CFG File Path).

Dónde está el server.cfg

• Con txAdmin. Al desplegar una receta, txAdmin propone crear el servidor dentro de txData, en una carpeta con un nombre del tipo NombreReceta_número.base. server.cfg está en la raíz de esa carpeta, junto a resources. En Settings > FXServer, Server Data Folder es la carpeta que contiene resources y CFG File Path (opciones avanzadas) es la ruta del fichero, absoluta o relativa a esa carpeta.
• Sin txAdmin (vanilla). Está en tu carpeta server-data y el servidor se arranca desde ahí con +exec server.cfg.

La forma más cómoda de editarlo es la página CFG Editor de txAdmin. Valida el fichero antes de guardar y conserva la versión anterior como server.cfg.bkp.

Diferencia entre set, setr y sets

• set crea una convar que solo leen los scripts del servidor.
• setr la replica a los clientes, de modo que el juego de los jugadores puede leerla.
• sets la hace pública: aparece en la lista de servidores y en http://IP:30120/info.json.

Las claves y contraseñas (licencia, clave de Steam, cadena de conexión de la base de datos) van siempre con set o con su propio comando, nunca con setr ni con sets.

Las líneas imprescindibles del server.cfg

• endpoint_add_tcp y endpoint_add_udp: la dirección y el puerto al que se conectan los jugadores. Usa el mismo ip:puerto para los dos protocolos. Por defecto es 0.0.0.0:30120; cambia la IP solo si la máquina tiene varias interfaces de red.
• sv_licenseKey: la clave de tu servidor, que se crea gratis en el Portal de Cfx.re. Sin ella el servidor no arranca y muestra no license key was specified.
• sv_hostname, sets sv_projectName y sets sv_projectDesc: nombre y descripción en la lista de servidores. Si falta alguna de las dos variables de proyecto, el servidor muestra un error al arrancar y puede no aparecer en la lista.
• sv_maxclients: plazas máximas, de 1 a 2048. A partir de 32 plazas hace falta OneSync, y por encima de 64 debe estar en on. Para más de 48 plazas necesitas la suscripción Element Club Argentum o superior en el Portal de Cfx.re.
• set steam_webApiKey: una clave de la Steam Web API, necesaria para que el servidor devuelva identificadores de Steam.
• sv_enforceGameBuild: la versión de contenido de GTA V que cargan los jugadores. Solo se puede fijar al arrancar. Consulta artifacts y game build de FiveM.
• onesync: set onesync on en un servidor vanilla. Con txAdmin se elige en Settings > FXServer > OneSync, y txAdmin comenta cualquier línea onesync del server.cfg.
• sets tags y sets locale: etiquetas separadas por comas y el idioma principal (es-ES, en-US). El fichero por defecto trae root-AQ, que debes sustituir.
• sv_scriptHookAllowed 0: bloquea Script Hook V. La documentación desaconseja activarlo.
• ensure recurso: arranca un recurso, o lo reinicia si ya estaba en marcha. El orden importa: primero las dependencias (base de datos, framework) y después los scripts que las usan.
• add_ace y add_principal: permisos. add_ace concede un permiso a un grupo y add_principal mete un identificador dentro de ese grupo.

Ejemplo mínimo de server.cfg comentado

# Red: mismo ip:puerto para TCP y UDP
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Lista de servidores
sv_hostname "Mi servidor FiveM"
sets sv_projectName "Mi servidor FiveM"
sets sv_projectDesc "Comunidad de roleplay"
sets tags "roleplay, spanish"
sets locale "es-ES"
#load_server_icon logo.png   # PNG de 96x96

# Plazas y game build
sv_maxclients 48
sv_enforceGameBuild 3095

# OneSync: solo en vanilla. Con txAdmin, en Settings > FXServer
set onesync on

# Seguridad
sv_scriptHookAllowed 0

# Claves: siempre con "set", nunca setr ni sets
set steam_webApiKey ""
sv_licenseKey "cfxk_tu_clave"

# Base de datos (solo si usas oxmysql), antes de cualquier recurso
set mysql_connection_string "mysql://fivem:clave-segura@localhost:3306/fivem"

# Recursos: primero las dependencias
ensure oxmysql
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Permisos de administrador (sustituye por tu identificador de FiveM)
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:123456 group.admin

Si desplegaste un framework (ESX, QBCore, QBox u otros) con una receta de txAdmin, respeta el orden de recursos que creó la receta y añade tus scripts después.

Errores habituales en el server.cfg

• Couldn't find resource X.: el nombre que sigue a ensure no coincide con la carpeta del recurso, o el recurso no está dentro de resources.
• Could not find dependency X for resource Y.: falta una dependencia o no se ha arrancado. Comprueba que existe y que va antes en la lista.
• Resource 'X' can't run: sv_enforceGameBuild needs to be at least N: el recurso necesita un game build más alto. Sube sv_enforceGameBuild y reinicia.
• Líneas comentadas con ## [txAdmin CFG validator]: txAdmin las ha desactivado a propósito. Los casos habituales son onesync (se configura en los ajustes de txAdmin) y ensure monitor (los recursos de txAdmin no se arrancan desde el fichero).
• the endpoint_add_tcp port 40120 is dedicated for txAdmin: los puertos del 40120 al 40150 están reservados para txAdmin. Usa el 30120 u otro puerto libre.
• Your config file does not specify a valid endpoints: faltan las líneas endpoint_add_tcp y endpoint_add_udp, o no comparten el mismo ip:puerto.
• El servidor no aparece en la lista: revisa sv_projectName y sv_projectDesc, comprueba que la línea #sv_master1 "" conserva su # y abre http://IP:30120/info.json para confirmar que el puerto responde.

Si tu servidor está alojado en Astrol Nodes, puedes pegar el error de la consola en Astrol AI, el asistente del panel, para localizar la línea que falla.