Cómo configurar server.cfg en tu servidor de FiveM
Introducción
El archivo server.cfg es el archivo de configuración principal de un servidor FiveM. Esta guía te muestra cómo configurar server.cfg en tu servidor FiveM desde OuiPanel, el panel de juego de OuiHeberg. Repasa cada ajuste habitual con su línea de configuración y termina con un ejemplo completo.
| Categoría | Ejemplos |
|---|---|
| Identidad | Nombre del servidor, descripción, tags |
| Licencia | Clave de licencia de Cfx.re, obligatoria |
| Jugadores | Número de slots, OneSync |
| Recursos | Scripts, mapas, vehículos |
| Permisos | ACE y ACL, admins, grupos |
| Red | Puertos, RCON |
Obtener una clave de licencia
Un servidor FiveM no arranca sin clave de licencia. La clave es gratuita y se crea en el portal de Cfx.re, que sustituyó a Keymaster.
Inicia sesión en portal.cfx.re con tu cuenta de Cfx.re. La antigua dirección
keymaster.fivem.nettambién lleva allí. Si no tienes cuenta, haz clic en Sign Up.Abre la página Server Registration Keys y haz clic en Generate Key.
Escribe un nombre para la clave en Display Name y haz clic en Generate.
Copia la clave generada. Empieza por
cfxk_.
La guía Keymaster FiveM explica en detalle el portal, la gestión de las claves y los errores de licencia.

Una clave sirve para un solo servidor a la vez. Mantenla en secreto y crea una por servidor si tienes varios.
Abrir el archivo server.cfg
Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor FiveM.
En la Consola, detén el servidor con el botón Detener.
En el menú lateral, haz clic en Gestor de archivos.
Haz clic en
server.cfg, en la raíz. Se abre la ventana «Edición de server.cfg».Edita el archivo y haz clic en Guardar.
Reinicia el servidor desde la Consola.
Las líneas bajo ### AUTOMATICALLY SET BY PTERODACTYL ###, al principio del archivo, las escribe el panel. Déjalas como están.

Detén el servidor antes de modificar este archivo. El servidor solo vuelve a leer server.cfg en el siguiente arranque.
Elegir la edición Legacy o Enhanced
OuiPanel ofrece FiveM en dos ediciones, Legacy y Enhanced. El panel las llama canales. La edición se elige en Configuración FiveM, tarjeta Canal FiveM, donde la etiqueta Actual marca la del servidor.
Pasar de una edición a otra
En el menú lateral, haz clic en Configuración FiveM.
En la tarjeta Canal FiveM, haz clic en Legacy o en Enhanced.
Se abre la ventana «Haz una copia de seguridad antes de instalar». Haz clic en Guardar y continuar o en Continuar sin copia de seguridad.
El panel reinstala el servidor en la edición elegida. La tarjeta indica que el cambio conserva tu configuración.

Antes de pasar a Enhanced, pon tu propia clave en la variable fivem license. Sin ella, el servidor se detiene al arrancar.
Qué cambia en el panel
| Ajuste | Legacy | Enhanced |
|---|---|---|
| txAdmin | Disponible, con las variables txAdmin Port y Activer txadmin | No disponible, la página lo indica con el título «txAdmin no disponible en Enhanced» |
| Versión del artefacto | Se elige en una lista con Elegir una versión | Botón en gris, la selección por lista está reservada a Legacy |
| Versión instalada | Número de build, por ejemplo 38220 | Identificador corto, por ejemplo 019ffb4d |
| Variable de versión | fivem version | fivem version (Enhanced / UUID) |
La guía Cambiar la versión del artifact de tu servidor FiveM explica cómo elegir un build en Legacy. Para abrir txAdmin, consulta Crear una whitelist de FiveM con Discord y txAdmin.

Configuración básica
Clave de licencia (obligatoria)
sv_licenseKey "tu_clave_de_licencia_aqui"
Sustituye el valor por la clave obtenida en el portal de Cfx.re. Sin una clave válida, el servidor no arranca.
En OuiPanel, la clave también se introduce en Configuración › Parámetros del servidor, bloque Variables de entorno, campo fivem license. Pega la clave y haz clic en la marca de verificación a la derecha del campo para guardarla. Si tu server.cfg tiene una línea sv_licenseKey, pon allí la misma clave.
En la edición Enhanced, una clave propia es imprescindible. Allí Cfx.re rechaza la clave que trae la variable por defecto, y el servidor se detiene nada más arrancar.
El mismo bloque incluye Nom du serveur (nombre del servidor), Joueurs maximum (jugadores máximos) y Clé API Web Steam (obsolète) (clave de la API web de Steam, obsoleta). Mantén los mismos valores en las variables y en el archivo. En Legacy, también incluye txAdmin Port y el interruptor Activer txadmin (activar txAdmin).

Nombre del servidor
sv_hostname "Mi Servidor FiveM | Roleplay ES"
Es el nombre que aparece en la lista de servidores de FiveM. Algunos consejos para elegirlo.
Corto y fácil de recordar.
Con el tipo de servidor (RP, Freeroam, Drift…).
Con el idioma (ES, EN…).
Con pocos emojis.
Algunos ejemplos.
sv_hostname "[ES] 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
sets sv_projectDesc "Servidor roleplay en español con economía realista, variedad de trabajos y comunidad activa."
Esta descripción aparece en los detalles del servidor. No pases de 200 caracteres.
Nombre del proyecto
sets sv_projectName "Revolution RP"
Es el nombre corto del proyecto, que aparece en algunos menús.
La documentación de Cfx.re marca
sv_projectName,sv_projectDescyload_server_iconcomo obsoletos. El nombre, la descripción y el icono también se configuran en el portal de Cfx.re.
Tags del servidor
sets tags "roleplay, español, serious, economy, jobs"
Los tags ayudan a encontrar el servidor en la lista. Sepáralos con comas. Estos son los más habituales.
roleplay,rp,serious,semi-seriousespañol,spanish,eseconomy,jobs,police,emscustom-cars,drift,racingesx,qbcore,vrp
Icono del servidor
load_server_icon server_icon.png
Esta línea muestra un icono en la lista de servidores. La imagen debe ser un PNG de 96 × 96 píxeles, llamarse server_icon.png y estar en la raíz del servidor. Para subirla, arrástrala a la raíz en el Gestor de archivos.
Configuración de los jugadores
Número de slots
sv_maxclients 32
Por encima de 32 slots, OneSync debe estar activado. Por encima de 64, debe estar en on. El límite también depende de tu cuenta de Cfx.re.
| Slots | Condición |
|---|---|
32 | Servidor pequeño o de pruebas |
48 | Límite sin suscripción a Cfx.re, con OneSync |
64 a 128 | Suscripción Element Club Argentum o Aurum |
Hasta 2048 | Suscripción Element Club Platinum, OneSync en on |
La variable Joueurs maximum de los Parámetros del servidor fija el mismo número. Más jugadores también piden más memoria y más procesador.
Activar OneSync
OneSync permite superar los 32 jugadores y mejora la sincronización.
set onesync on
| Modo | Efecto |
|---|---|
off | Desactivado, límite de 32 jugadores |
on | Activado, el modo recomendado |
legacy | Modo de compatibilidad, desaconsejado por Cfx.re |
Para afinar OneSync, añade estas líneas.
set onesync on
set onesync_population true
# Quita de la sincronización las entidades lejanas y fuera del campo de visión
set onesync_distanceCulling true
set onesync_distanceCullVehicles false
Punto de aparición
El punto de aparición no se define en server.cfg. Se declara en un recurso de tipo mapa, con coordenadas X, Y y Z. La mayoría de los frameworks (ESX, QBCore) gestionan la aparición por su cuenta.
spawnpoint 'a_m_y_hipster_01' { x = -269.4, y = -955.3, z = 31.2 }
Configuración de los recursos
Iniciar un recurso
ensure nombre_del_recurso
El comando start también funciona.
start nombre_del_recurso
Usa mejor
ensure. Inicia el recurso, o lo reinicia si ya está en marcha.
Orden de carga
El orden de las líneas ensure importa, porque algunos recursos dependen de otros. Este es un 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. Framework (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
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
# 7. Otros scripts
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin
# 8. Scripts propios
ensure mi_script_propio
Desactivar un recurso
Para desactivar un recurso, comenta su línea con #.
# ensure recurso_desactivado
Comandos de consola útiles
Estos comandos se escriben en la Consola de OuiPanel, sin barra inicial.
| Comando | Efecto |
|---|---|
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 |
Configuración de la base de datos
Conexión MySQL
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
Sustituye cada parte por los datos de tu base.
useres el usuario de MySQL.passwordes su contraseña.hostes la dirección del servidor MySQL.3306es el puerto de MySQL.databasees el nombre de la base.
Encontrarás estos datos en Bases de datos, botón Información. La guía Cómo crear y gestionar una base de datos MySQL en OuiPanel explica cómo crear la base.
Este es un ejemplo con valores ficticios.
set mysql_connection_string "mysql://u123_AbCdEfGh:Contrasena123@203.0.113.20:3306/s123_bdd?charset=utf8mb4"
Insertar la conexión desde OuiPanel
OuiPanel puede escribir esta línea por ti.
En el menú lateral, haz clic en Configuración FiveM.
En la tarjeta Insertar la conexión MySQL, haz clic en Elegir una base de datos.
En la ventana «Seleccionar una base de datos», elige la base y haz clic en Confirmar.
El panel añade una línea set mysql_connection_string bajo el bloque ### AUTOMATICALLY SET BY PTERODACTYL ###. Si ya existía una línea, queda comentada.

Formato clave=valor
oxmysql también acepta la cadena en pares clave=valor. La primera línea es el formato antiguo y la segunda, el que escribe OuiPanel.
set mysql_connection_string "server=203.0.113.20;uid=u123_AbCdEfGh;password=Contrasena123;database=s123_bdd"
set mysql_connection_string "user=u123_AbCdEfGh;password=Contrasena123;host=203.0.113.20;port=3306;database=s123_bdd"
Configuración de permisos (ACE/ACL)
El sistema ACE (Access Control Entry) gestiona los permisos en FiveM. La guía Cómo configurar los permisos ACE en FiveM va más allá.
Añadir un administrador
Un jugador pasa a ser administrador cuando lo añades al grupo group.admin. El identificador de Steam es el más habitual.
add_principal identifier.steam:110000xxxxxxxxx group.admin
Por identificador de Discord.
add_principal identifier.discord:123456789012345678 group.admin
Por identificador de licencia de Rockstar.
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin
Tu identificador de Steam está en SteamID.io. Necesitas su forma hexadecimal, que empieza por
110000.
Crear grupos de permisos
# Grupo admin con todos los comandos salvo quit
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Grupo moderador
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
# El grupo admin hereda los permisos del grupo moderador
add_principal group.admin group.moderator
Permisos habituales
# El grupo admin puede usar todos los comandos
add_ace group.admin command allow
# Permisos concretos
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 de vMenu
add_ace group.admin vMenu.Everything allow
add_ace group.moderator vMenu.OnlinePlayers.Kick allow
add_ace group.moderator vMenu.OnlinePlayers.TempBan 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 OuiPanel, estas dos líneas forman parte del bloque que escribe el panel. Usan el puerto principal de tu servidor, que ves en Configuración › Gestión de puertos. No las cambies.
RCON (consola remota)
rcon_password "ContrasenaRconMuySegura"
RCON permite controlar el servidor a distancia. Elige una contraseña larga y única. Para desactivar RCON, deja el valor vacío con rcon_password "".
Clave de la API de Steam
FiveM ya no usa steam_webApiKey desde el 4 de noviembre de 2026, según su documentación oficial. Deja la variable Clé API Web Steam (obsolète) de OuiPanel en none y no la añadas a server.cfg. Para exigir una cuenta de Steam, usa sv_enforceSteamAuth en un servidor con el build 38004 o posterior, como explica la guía Cómo configurar los permisos ACE en FiveM.
Configuración de la jugabilidad
El PvP, el radar o el modo pasivo no se configuran en server.cfg. Dependen de tus recursos y de tu framework. El archivo sí guarda algunos ajustes útiles para la jugabilidad.
Versión del juego (game build)
sv_enforceGameBuild 2944
Esta línea impone una versión de GTA V a los jugadores. Mantiene la compatibilidad de los recursos, como vehículos o mapas de una actualización reciente.
| Build | Actualización de GTA V |
|---|---|
2060 | Los Santos Summer Special |
2189 | Cayo Perico Heist |
2372 | Los Santos Tuners |
2545 | The Contract |
2699 | The Criminal Enterprises |
2802 | Los Santos Drug Wars |
2944 | San Andreas Mercenaries |
3095 | The Chop Shop |
3258 | Bottom Dollar Bounties |
3407 | Agents of Sabotage |
3570 | Money Fronts |
3751 | A Safehouse in the Hills |
3889 | The Kortz Center Heist |
En el canal Enhanced de FiveM, solo se admite la última versión del juego.
Script Hook y archivos modificados
# Rechaza a los jugadores que usan Script Hook V (valor por defecto)
sv_scriptHookAllowed 0
# Bloquea los archivos del juego modificados, salvo el audio y los mods gráficos conocidos
sv_pureLevel 1
Con sv_pureLevel 2, se bloquean todos los archivos modificados. Cfx.re desaconseja permitir Script Hook, que expone el servidor a fallos de seguridad.
Convars útiles
Definir variables
set mi_variable "valor"
setr mi_variable_replicada "valor"
sets mi_variable_serverinfo "valor"
| Comando | Visibilidad |
|---|---|
set | Solo en el servidor |
setr | Replicada a los clientes |
sets | Visible en la información del servidor |
Variables del framework ESX
setr esx:locale "es"
Esta línea fija el idioma de ESX Legacy. El dinero inicial y los demás ajustes están en el archivo de configuración de es_extended, no en server.cfg.
Variables del framework QBCore
setr qb_locale "es"
Esta línea fija el idioma de QBCore. El dinero inicial se configura en qb-core/config.lua.
Ejemplo de server.cfg completo
Aquí tienes un server.cfg completo. Mantén al principio de tu archivo el bloque que escribe OuiPanel.
# ============================================
# CONFIGURACIÓN DEL SERVIDOR FIVEM
# ============================================
# === LICENCIA ===
sv_licenseKey "tu_clave_de_licencia_aqui"
# === IDENTIDAD DEL SERVIDOR ===
sv_hostname "[ES] Mi Servidor RP | Roleplay Serio"
sets sv_projectName "Mi Servidor RP"
sets sv_projectDesc "Servidor roleplay en español con economía realista y comunidad activa."
sets tags "roleplay, español, serious, esx, economy"
load_server_icon server_icon.png
# === JUGADORES ===
sv_maxclients 48
set onesync on
# === RED (líneas que escribe OuiPanel con el puerto principal) ===
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://user:password@host:3306/database?charset=utf8mb4"
# FiveM ya no usa steam_webApiKey desde el 04/11/2026
# === JUGABILIDAD ===
sv_enforceGameBuild 2944
# ============================================
# PERMISOS ACE/ACL
# ============================================
# Grupo admin
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Administradores (sustituye por tus identificadores)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin
# ============================================
# RECURSOS
# ============================================
# === Base de FiveM ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog
# === Base de datos ===
ensure oxmysql
# === Framework 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 propios ===
# ensure mi_script
Solución de problemas
El servidor no arranca
| Mensaje | Solución |
|---|---|
Invalid license key | Revisa la clave en el portal de Cfx.re y en la variable fivem license |
License key not set | Rellena la variable fivem license o la línea sv_licenseKey |
A valid license check is required to run this server | Mensaje de la edición Enhanced. Pon tu propia clave en la variable fivem license |
Command not found (sv_endpointprivacy) | Visto en la edición Enhanced, que no reconoce este comando. Este mensaje por sí solo no detiene el servidor |
Could not find resource | Comprueba que el recurso existe en la carpeta resources |
MySQL connection failed | Revisa la cadena de conexión MySQL |
Cuando FXServer escribe «Could not authenticate server license key», la consola de OuiPanel abre la ventana «Clave de licencia de FiveM rechazada». Su botón Abrir los ajustes del servidor te lleva directamente a la variable que hay que corregir. En Enhanced, el mensaje de rechazo es otro y esta ventana no se abre.
El servidor no aparece en la lista
| Causa | Solución |
|---|---|
| Clave de licencia no válida | Genera una nueva clave en el portal de Cfx.re |
Líneas endpoint modificadas | Vuelve a poner el puerto principal, visible en Gestión de puertos |
| Servidor aún arrancando | Espera unos minutos |
Un recurso no carga
| Causa | Solución |
|---|---|
| Falta una dependencia | Instala las dependencias que indica el autor |
| Error en el script | Lee la consola del servidor, o la consola del juego con F8 |
| Orden de carga incorrecto | Reordena las líneas ensure |
Falta fxmanifest.lua | Comprueba que el archivo existe en la carpeta del recurso |
Error de base de datos
| Mensaje | Solución |
|---|---|
Access denied | Revisa el usuario y la contraseña de MySQL |
Unknown database | Crea la base de datos |
Connection refused | Revisa el host y el puerto |
Los permisos ACE no se aplican
| Causa | Solución |
|---|---|
| Identificador incorrecto | Revisa el prefijo (steam:, discord:, license:) |
| Servidor sin reiniciar | Reinicia después de cada cambio |
| Error tipográfico | Revisa la sintaxis de cada línea |
¿Necesitas ayuda?
Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.
Descubre nuestros planes de alojamiento GTA V / FiveM desde 2,99 €/mes, con tu servidor listo en 60 segundos.
Ver ofertas →