Cómo configurar server.cfg en tu servidor FiveM

Tiempo estimado: 15 minutos
Dificultad: Intermedia ⭐⭐
Servidores compatibles: FiveM

📋 Introducción

El archivo server.cfg es el archivo de configuración principal de tu servidor FiveM. Permite definir el nombre del servidor, el número de jugadores, los recursos a cargar, los permisos y mucho más.

Lo que puedes configurar

Categoría	Ejemplos
🏷️ Identidad	Nombre del servidor, descripción, etiquetas
🔑 Licencia	Clave de licencia Cfx.re (obligatoria)
👥 Jugadores	Slots máximos, OneSync
📦 Recursos	Scripts, mapas, vehículos
🔒 Permisos	ACE/ACL, admins, grupos
⚙️ Red	Puertos, RCON

🔑 Prerrequisitos: Obtener una Clave de Licencia

Antes de configurar tu servidor, necesitas obtener una clave de licencia gratuita en Cfx.re.

Crear una cuenta en Cfx.re

Ve a Cfx.re
Haz clic en Sign Up (o inicia sesión si ya tienes una cuenta)
Crea tu cuenta con email o Discord

Generar la clave de licencia

Inicia sesión en Cfx.re Keymaster
Haz clic en Register a new server

Rellena el formulario:

Haz clic en Generate
Copia la clave generada (formato: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

⚠️ Importante:

Una clave = un servidor

Guarda esta clave en secreto

Puedes generar varias claves para varios servidores

📁 Acceder al Archivo server.cfg

A través del Gestor de Archivos

Accede a OuiPanel
Selecciona tu servidor FiveM
En el menú lateral, haz clic en Gestor de archivos
Abre el archivo server.cfg en la raíz

Haz clic en el archivo para poder Modificarlo

⚠️ Importante: Detén tu servidor antes de modificar este archivo, luego reinícialo para aplicar los cambios.

🏷️ Configuración Básica

Clave de Licencia (Obligatorio)

sv_licenseKey "tu_clave_de_licencia_aquí"

Sustitúyela por la clave obtenida en Keymaster.

⚠️ Sin una clave de licencia válida, tu servidor no se iniciará.

Nombre del Servidor

sv_hostname "Mi Servidor FiveM | Roleplay ES"

Es el nombre mostrado en la lista de servidores FiveM.

Consejos para el nombre:

✅ Corto y memorable
✅ Incluir el tipo (RP, Freeroam, Drift...)
✅ Incluir el idioma (ES, EN...)
✅ Usar emojis con moderación

Ejemplos:

sv_hostname "🇪🇸 Revolution RP | Roleplay Serio"
sv_hostname "Vida en Los Santos | RP en Español"
sv_hostname "Paraíso del Drift | Carreras y Tuning"

Descripción del Servidor

sv_projectDesc "Servidor roleplay en español con economía realista, variedad de trabajos y comunidad activa."

Descripción mostrada en los detalles del servidor. Se recomienda un máximo de 200 caracteres.

Nombre del Proyecto

sv_projectName "Revolution RP"

Nombre corto del proyecto (mostrado en algunos menús).

Etiquetas del Servidor

sets tags "roleplay, español, serio, economía, trabajos"

Etiquetas para el posicionamiento en la lista de servidores. Separa por comas.

Etiquetas populares:

roleplay, rp, serio, semi-serio
español, spanish, es
economía, trabajos, policía, ems
coches-personalizados, drift, carreras
esx, qbcore, vrp

Imagen/Banner del Servidor

load_server_icon server_icon.png

Muestra un ícono en la lista de servidores.

Especificaciones:

Formato: PNG
Tamaño: 96x96 píxeles
Nombre: server_icon.png
Ubicación: raíz del servidor

👥 Configuración de los Jugadores

Número Máximo de Slots

sv_maxclients 32

Valor	Recomendación
`32`	Servidor pequeño / Prueba
`64`	Servidor mediano
`128`	Servidor grande
`256+`	Servidor muy grande (OneSync requerido)

⚠️ Más jugadores = más recursos necesarios (RAM, CPU).

Activar OneSync

OneSync permite gestionar más de 32 jugadores y mejora la sincronización.

set onesync on

Modo	Descripción
`off`	Desactivado (límite 32 jugadores)
`on`	Activado (recomendado)
`legacy`	Modo legacy

Configuración OneSync avanzada:

set onesync on
set onesync_population true

# Distancia de culling (alcance de visión de las entidades)
set onesync_distanceCullVehicles false
set onesync_distanceCull 500

Configuración de Spawn

spawnpoint 0 -269.4 -955.3 31.2

Coordenadas de spawn por defecto (X, Y, Z). La mayoría de los frameworks (ESX, QBCore) gestionan el spawn por sí mismos.

📦 Configuración de los Recursos

Iniciar un Recurso

ensure nombre_del_recurso

start nombre_del_recurso

💡 Se recomienda ensure ya que reinicia el recurso si se cae.

Orden de Carga

¡El orden de los ensure es importante! Algunos recursos dependen de otros.

Orden recomendado:

# 1. Recursos básicos de FiveM
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# 2. Base de datos
ensure oxmysql

# 3. Marco de trabajo (ESX o QBCore)
ensure es_extended

# 4. Dependencias comunes
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# 5. Scripts esenciales
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking

# 6. Trabajos / Empleos
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# 7. Otros scripts
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin

# 8. Scripts personalizados
ensure mon_script_custom

Detener un Recurso

Para desactivar un recurso, comenta la línea con #:

# ensure ressource_desactivee

🗄️ Configuración de la Base de Datos

Conexión MySQL

set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

Reemplaza:

user : Nombre de usuario de MySQL
password : Contraseña de MySQL
host : Dirección del servidor de MySQL
3306 : Puerto de MySQL
database : Nombre de la base de datos

📖 Consulta la guía "Crear y Gestionar una Base de Datos MySQL" para crear tu base.

Ejemplo con OuiHeberg:

set mysql_connection_string "mysql://s123_bdd:[email protected]:3306/s123_bdd?charset=utf8mb4"

Alternativas de configuración MySQL

Formato JDBC (antiguo):

set mysql_connection_string "server=mysql-1.ouiheberg.com;uid=s123_bdd;password=MotDePasse123;database=s123_bdd"

🔒 Configuración de Permisos (ACE/ACL)

Sistema ACE

El sistema ACE (Entrada de Control de Acceso) gestiona los permisos en FiveM.

Agregar un Administrador

Por identificador de Steam (recomendado):

add_ace identifier.steam:110000xxxxxxxxx group.admin allow
add_principal identifier.steam:110000xxxxxxxxx group.admin

Por identificador de Discord:

add_ace identifier.discord:123456789012345678 group.admin allow
add_principal identifier.discord:123456789012345678 group.admin

Por identificador de Licencia:

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin

💡 Para encontrar tu identificador de Steam: SteamID.io

Crear Grupos de Permisos

# Crear el grupo admin con todos los permisos
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Crear el grupo moderador
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Heredar permisos
add_principal group.admin group.moderator

Permisos Comunes

# Permitir al grupo admin usar todos los comandos
add_ace group.admin command allow

# Permisos específicos
add_ace group.admin command.restart allow
add_ace group.admin command.stop allow
add_ace group.admin command.start allow
add_ace group.admin command.refresh allow

# Permisos vMenu
add_ace group.admin vMenu.everything allow
add_ace group.moderator vMenu.kick allow
add_ace group.moderator vMenu.ban allow

Asignar un Jugador a un Grupo

add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator

⚙️ Configuración de Red

Puerto del Servidor

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

⚠️ En OuiHeberg, el puerto se gestiona automáticamente. Utiliza el puerto asignado a tu servidor.

RCON (Consola Remota)

rcon_password "MotDePasseRconTresSecure"

Permite controlar el servidor a distancia. ¡Utiliza una contraseña segura!

💡 Deja vacío para desactivar RCON: rcon_password ""

Configuración Steam

set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Clave API de Steam (opcional, para algunas funcionalidades). Obténla en: Steam Web API Key

🎮 Configuración de Jugabilidad

Activar/Desactivar Funcionalidades

# Desactivar el modo pasivo automático
sv_disablePassive false

# Activar el PvP
sv_enablePVP true

# Desactivar la sincronización del tiempo
sv_disableTimeSync true

# Mostrar el logo de FiveM al cargar
sv_showFiveMBanner true

Modo Hardcore / Serio

# Desactivar el radar automático
sv_disableRadar true

# Desactivar las notificaciones nativas
sv_disableClientNotify true

# Modo RP serio
set sv_enforceGameBuild 2944

Build del Juego

sv_enforceGameBuild 2944

Forzar una versión específica de GTA V. Útil para la compatibilidad de recursos.

Build	Versión GTA V
`2060`	Los Santos Summer Special
`2189`	Cayo Perico
`2372`	Los Santos Tuners
`2545`	The Contract
`2699`	Criminal Enterprises
`2944`	San Andreas Mercenaries
`3095`	Chop Shop

📜 Variables Convars Útiles

Definir Variables

set ma_variable "valeur"
setr ma_variable_repliquee "valeur"
sets ma_variable_serverinfo "valeur"

Comando	Visibilidad
`set`	Solo servidor
`setr`	Replicado a los clientes
`sets`	Visible en la información del servidor

Variables Framework ESX

set es_enableCustomData 1
set es_startingCash 50000
set es_startingBank 100000
set es_startingBlackMoney 0

Variables Framework QBCore

set qb_locale "fr"
set qb_starterMoney 5000
set qb_starterBank 10000

📄 Archivo server.cfg Completo (Ejemplo)

Aquí tienes un ejemplo de server.cfg completo y funcional:

# ============================================
# CONFIGURACIÓN DEL SERVIDOR FIVEM
# ============================================

# === LICENCIA ===
sv_licenseKey "tu_clave_de_licencia_aquí"

# === IDENTIDAD DEL SERVIDOR ===
sv_hostname "🇫🇷 Mi Servidor RP | Rol Serio"
sv_projectName "Mi Servidor RP"
sv_projectDesc "Servidor de rol en francés con economía realista y comunidad activa."
sets tags "roleplay, francés, serio, esx, economía"
load_server_icon server_icon.png

# === JUGADORES ===
sv_maxclients 64
set onesync on

# === RED ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# === RCON ===
rcon_password ""

# === BASE DE DATOS ===
set mysql_connection_string "mysql://usuario:contraseña@host:3306/base_de_datos?charset=utf8mb4"

# === STEAM (Opcional) ===
# set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXX"

# === JUEGO ===
sv_enforceGameBuild 2944

# ============================================
# PERMISOS ACE/ACL
# ============================================

# Grupo Admin
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Administradores (reemplace con sus identificadores)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin

# ============================================
# RECURSOS
# ============================================

# === Base FiveM ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# === Base de datos ===
ensure oxmysql

# === Marco de trabajo ESX ===
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# === Scripts ESX ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin

# === Trabajos ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# === Otros scripts ===
ensure esx_vehicleshop
ensure esx_property

# === Scripts personalizados ===
# ensure mon_script

🔧 Solución de problemas

El servidor no se inicia

❌ Error	✅ Solución
`Invalid license key`	Verifique su clave en Keymaster
`License key not set`	Agregue `sv_licenseKey` en server.cfg
`Could not find resource`	Verifique que el recurso exista en la carpeta `resources`
`MySQL connection failed`	Verifique la cadena de conexión MySQL

El servidor no aparece en la lista

❌ Causa	✅ Solución
Clave de licencia inválida	Regenere una clave en Keymaster
Puerto bloqueado	Verifique que los puertos TCP/UDP estén abiertos
Servidor en inicio	Espera unos minutos

Recurso que no se carga

❌ Causa	✅ Solución
Dependencia faltante	Verifique las dependencias requeridas
Error en el script	Consulte la consola (F8 en juego)
Orden de carga incorrecto	Reorganice los `ensure`
`fxmanifest.lua` faltante	Verifique que el archivo exista

Error de base de datos

❌ Error	✅ Solución
`Access denied`	Verifique usuario/contraseña de MySQL
`Unknown database`	Cree la base de datos
`Connection refused`	Verifique el host y el puerto

Permisos ACE no aplicados

❌ Causa	✅ Solución
Identificador incorrecto	Verifique el formato (steam:, discord:, license:)
Servidor no reiniciado	Reinicie después de la modificación
Error tipográfico	Verifique la sintaxis

📝 Comandos Útiles de Consola

Comando	Descripción
`restart [recurso]`	Reinicia un recurso
`stop [recurso]`	Detiene un recurso
`start [recurso]`	Inicia un recurso
`refresh`	Actualiza la lista de recursos
`status`	Muestra los jugadores conectados
`quit`	Detiene el servidor

📝 Resumen

1. Obtener una clave de licencia en Keymaster (Cfx.re)
2. Detener el servidor
3. Administrador de archivos → server.cfg → Modificar
4. Configurar:
   - sv_licenseKey (obligatorio)
   - sv_hostname (nombre del servidor)
   - sv_maxclients (espacios)
   - mysql_connection_string (base de datos)
   - Recursos (ensure)
   - Permisos ACE (admins)
5. Guardar el archivo
6. Reiniciar el servidor
7. Verificar en la lista de servidores FiveM

Cómo configurar server.cfg en tu servidor de FiveM