Cómo se hace

server.cfg de FiveM: ejemplo explicado

Un server.cfg de FiveM comentado de principio a fin: endpoints, sv_maxclients, OneSync, licenseKey, orden de ensure y secretos aparte. Listo para copiar y adaptar.

El problema

Tienes un servidor de FiveM (txAdmin o manual) pero no entiendes qué hace cada línea del server.cfg, en qué orden deben ir los recursos, ni cómo poner OneSync para superar los 32 jugadores sin que todo crashee.

La causa

El server.cfg es el fichero que arranca tu servidor: define la conexión de red, los límites, la licencia, OneSync y QUÉ recursos se cargan y EN QUÉ ORDEN. Si una directiva está mal escrita o un recurso se carga antes que su dependencia, el servidor no levanta o los scripts fallan con errores de tipo «nil value».

La solución

Aquí tienes un server.cfg de ejemplo completo y comentado. Cada bloque está explicado: endpoints de red, hostname, número de jugadores, OneSync, licenseKey (de keymaster, nunca se comparte), la cadena de conexión a MySQL, el orden correcto de ensure (dependencias primero) y los permisos de admin. Las claves sensibles van en un secrets.cfg aparte que se carga con exec.

cfg

# ===========================================================
#  server.cfg de ejemplo — FiveM (comentado línea a línea)
# ===========================================================

# --- 1. Red / endpoints --------------------------------------
# Puerto en el que escucha el servidor (TCP para la lista, UDP para el juego).
# 0.0.0.0 = escucha en todas las interfaces. 30120 es el puerto por defecto.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Oculta tu IP/endpoint real en la lista de servidores (recomendado).
sv_endpointprivacy true

# --- 2. Identidad del servidor -------------------------------
# Nombre que aparece en la lista. Acepta colores con ^1, ^2, etc.
sv_hostname "^2Crxative-M ^7| ESX Roleplay ^8[ES]"

# Máximo de jugadores. Por encima de 32 NECESITAS OneSync (abajo).
sv_maxclients 64

# Idioma y metadatos para la lista de servidores.
sets locale "es-ES"
sets tags "esx, roleplay, español"
sets Discord "discord.gg/tu-servidor"

# --- 3. OneSync ----------------------------------------------
# OneSync sincroniza entidades en el servidor. OBLIGATORIO para > 32 jugadores.
#   on        -> recomendado para servidores modernos
#   legacy    -> compatibilidad antigua
# Con OneSync 'on' puedes subir sv_maxclients hasta 1024 (si tu VPS aguanta).
set onesync on

# --- 4. Licencia (¡SECRETO!) ---------------------------------
# Tu clave de https://keymaster.fivem.net  —  NUNCA la subas a GitHub
# ni la compartas. Lo ideal es moverla a secrets.cfg (ver abajo).
sv_licenseKey "TU_LICENSE_KEY_DE_KEYMASTER"

# Token Steam Web API (opcional, mejora identificadores de jugador).
# set steam_webApiKey "TU_STEAM_WEB_API_KEY"

# --- 5. Base de datos (oxmysql) ------------------------------
# Cadena de conexión a MySQL/MariaDB que usa oxmysql/ESX.
# También es un secreto: muévela a secrets.cfg en producción.
set mysql_connection_string "mysql://usuario:contraseña@localhost:3306/esx_db?charset=utf8mb4"

# --- 6. Carga de recursos (¡EL ORDEN IMPORTA!) ---------------
# Regla de oro: las DEPENDENCIAS van ANTES que lo que las usa.
# 'ensure' = inicia el recurso y lo reinicia si ya estaba arrancado.

# 6.1 Dependencias base (primero de todo)
ensure oxmysql          # capa de base de datos
ensure ox_lib           # librería compartida (cache, UI, callbacks)

# 6.2 Framework
ensure es_extended      # ESX Legacy — DEBE ir antes que cualquier script ESX

# 6.3 Recursos del jugador / mundo (dependen de ESX + ox_lib)
ensure ox_inventory
ensure esx_menu_default
ensure esx_society
ensure esx_jobs

# 6.4 Tus recursos propios (al final, ya tienen todo lo que necesitan)
ensure mi_recurso_hud
ensure mi_recurso_garaje

# --- 7. Permisos de administrador (ACE) ----------------------
# add_ace: concede un permiso a un principal.
# add_principal: asocia un identificador (license/steam) a un grupo.
# Aquí 'group.admin' recibe acceso total ("command") y un jugador se hace admin.
add_ace group.admin command allow
add_principal identifier.license:PON_AQUI_TU_LICENSE_HEX group.admin

# Da permiso a ESX para gestionar el grupo admin (ejemplo típico).
add_ace group.admin esx.admin allow

# --- 8. Secretos en fichero aparte ---------------------------
# En lugar de dejar licenseKey / mysql_string aquí, créalos en
# 'secrets.cfg' (añádelo a .gitignore) y cárgalo con exec:
# exec secrets.cfg
#
# Ejemplo de secrets.cfg:
#   sv_licenseKey "..."
#   set mysql_connection_string "mysql://..."

Paso a paso

1.Crea o edita server.cfg en la raíz de tu servidor (junto a la carpeta resources/).
2.Configura endpoint_add_tcp/udp con "0.0.0.0:30120" y pon sv_endpointprivacy true para no exponer tu IP.
3.Ajusta sv_hostname, sv_maxclients y locale. Si superas 32 jugadores, activa OneSync con `set onesync on`.
4.Pega tu sv_licenseKey desde keymaster.fivem.net y la cadena mysql_connection_string de oxmysql. NUNCA las subas a GitHub.
5.Ordena los `ensure`: primero oxmysql y ox_lib, luego es_extended, luego los recursos que dependen de ESX, y tus scripts al final.
6.Da permisos con add_ace/add_principal usando tu identifier.license real (lo ves con el comando `status` o en txAdmin).
7.Mueve licenseKey y mysql_connection_string a un secrets.cfg aparte, añádelo a .gitignore y cárgalo con `exec secrets.cfg`.
8.Reinicia el servidor completo para aplicar los cambios de orden y de OneSync.

¿Tu caso es distinto?

Pega tu error en la herramienta IA y te da la solución al instante.

Probar la herramienta

Guías relacionadas

Cómo crear un servidor de FiveM desde cero Permisos ACE no funcionan (add_ace / add_principal)Cómo dar permisos de admin en ESX

Última actualización: 2026-06-29. Crxative-M no está afiliado a Cfx.re ni Rockstar Games.