FiveMPublicado el 15 de diciembre de 2025Lectura de 13 min

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íaEjemplos
IdentidadNombre del servidor, descripción, tags
LicenciaClave de licencia de Cfx.re, obligatoria
JugadoresNúmero de slots, OneSync
RecursosScripts, mapas, vehículos
PermisosACE y ACL, admins, grupos
RedPuertos, 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.

  1. Inicia sesión en portal.cfx.re con tu cuenta de Cfx.re. La antigua dirección keymaster.fivem.net también lleva allí. Si no tienes cuenta, haz clic en Sign Up.

  2. Abre la página Server Registration Keys y haz clic en Generate Key.

  3. Escribe un nombre para la clave en Display Name y haz clic en Generate.

  4. 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.

Página Server Registration Keys del portal de Cfx.re con el botón Generate Key

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

  1. Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor FiveM.

  2. En la Consola, detén el servidor con el botón Detener.

  3. En el menú lateral, haz clic en Gestor de archivos.

  4. Haz clic en server.cfg, en la raíz. Se abre la ventana «Edición de server.cfg».

  5. Edita el archivo y haz clic en Guardar.

  6. 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.

Ventana Edición de server.cfg del Gestor de archivos con el botón Guardar

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

  1. En el menú lateral, haz clic en Configuración FiveM.

  2. En la tarjeta Canal FiveM, haz clic en Legacy o en Enhanced.

  3. 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.

Ventana Haz una copia de seguridad antes de instalar con los botones Continuar sin copia de seguridad y Guardar y continuar

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

AjusteLegacyEnhanced
txAdminDisponible, con las variables txAdmin Port y Activer txadminNo disponible, la página lo indica con el título «txAdmin no disponible en Enhanced»
Versión del artefactoSe elige en una lista con Elegir una versiónBotón en gris, la selección por lista está reservada a Legacy
Versión instaladaNúmero de build, por ejemplo 38220Identificador corto, por ejemplo 019ffb4d
Variable de versiónfivem versionfivem 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.

Página Configuración FiveM en Enhanced con el aviso txAdmin no disponible y el botón Elegir una versión en gris


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).

Variables de entorno de un servidor FiveM Legacy con fivem license, txAdmin Port y Activer 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_projectDesc y load_server_icon como 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-serious

  • español, spanish, es

  • economy, jobs, police, ems

  • custom-cars, drift, racing

  • esx, 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.

SlotsCondición
32Servidor pequeño o de pruebas
48Límite sin suscripción a Cfx.re, con OneSync
64 a 128Suscripción Element Club Argentum o Aurum
Hasta 2048Suscripció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
ModoEfecto
offDesactivado, límite de 32 jugadores
onActivado, el modo recomendado
legacyModo 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.

ComandoEfecto
restart [recurso]Reinicia un recurso
stop [recurso]Detiene un recurso
start [recurso]Inicia un recurso
refreshActualiza la lista de recursos
statusMuestra los jugadores conectados
quitDetiene 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.

  • user es el usuario de MySQL.

  • password es su contraseña.

  • host es la dirección del servidor MySQL.

  • 3306 es el puerto de MySQL.

  • database es 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.

  1. En el menú lateral, haz clic en Configuración FiveM.

  2. En la tarjeta Insertar la conexión MySQL, haz clic en Elegir una base de datos.

  3. 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.

Página Configuración FiveM con la ventana Seleccionar una base de datos abierta

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.

BuildActualización de GTA V
2060Los Santos Summer Special
2189Cayo Perico Heist
2372Los Santos Tuners
2545The Contract
2699The Criminal Enterprises
2802Los Santos Drug Wars
2944San Andreas Mercenaries
3095The Chop Shop
3258Bottom Dollar Bounties
3407Agents of Sabotage
3570Money Fronts
3751A Safehouse in the Hills
3889The 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"
ComandoVisibilidad
setSolo en el servidor
setrReplicada a los clientes
setsVisible 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

MensajeSolución
Invalid license keyRevisa la clave en el portal de Cfx.re y en la variable fivem license
License key not setRellena la variable fivem license o la línea sv_licenseKey
A valid license check is required to run this serverMensaje 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 resourceComprueba que el recurso existe en la carpeta resources
MySQL connection failedRevisa 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

CausaSolución
Clave de licencia no válidaGenera una nueva clave en el portal de Cfx.re
Líneas endpoint modificadasVuelve a poner el puerto principal, visible en Gestión de puertos
Servidor aún arrancandoEspera unos minutos

Un recurso no carga

CausaSolución
Falta una dependenciaInstala las dependencias que indica el autor
Error en el scriptLee la consola del servidor, o la consola del juego con F8
Orden de carga incorrectoReordena las líneas ensure
Falta fxmanifest.luaComprueba que el archivo existe en la carpeta del recurso

Error de base de datos

MensajeSolución
Access deniedRevisa el usuario y la contraseña de MySQL
Unknown databaseCrea la base de datos
Connection refusedRevisa el host y el puerto

Los permisos ACE no se aplican

CausaSolución
Identificador incorrectoRevisa el prefijo (steam:, discord:, license:)
Servidor sin reiniciarReinicia después de cada cambio
Error tipográficoRevisa 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.

¿Te ha sido útil este artículo?

2463 vistas
Compartir este artículo
FiveM
¿Necesitas un servidor GTA/FiveM?

Descubre nuestros planes de alojamiento GTA V / FiveM desde 2,99 €/mes, con tu servidor listo en 60 segundos.

Ver ofertas →

Artículos relacionados

¿No encontraste lo que buscabas?

El equipo de soporte responde 7 días a la semana.

Abrir un ticketDesde tu área de clienteDiscord de la comunidadAyuda y anunciosEstado de los serviciosstatus.ouiheberg.com