Guía de server.cfg de FiveM: Configuración inicial segura

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sets sv_projectName "My Server"
sets sv_projectDesc "A clear one-sentence description"
sv_hostname "My Server"
set onesync on
sv_maxclients 48
sv_licenseKey "replace_with_portal_key"
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

El server.cfg file es el corazón de cada servidor FiveM. Define cómo funciona su servidor: ranuras, red, compilación del juego, OneSync, registro y visibilidad en la lista de servidores. Esta guía es para dueños de servidores y desarrolladores que desean configuraciones predeterminadas seguras, endurecimiento de producción y las mejores prácticas de rendimiento. Siempre mantenga copias de seguridad y use control de versiones. Si es nuevo, comience con el nuestro Cómo crear un servidor FiveM. Para optimizaciones más profundas, consulte nuestro centro de rendimiento.

TL;DR: Línea base lista para producción (anotada)

Una configuración limpia server.cfg es la base de la estabilidad. A continuación se presentan dos ejemplos: una configuración mínima configuración de desarrollo y una configuración de producción endurecida.

Configuración de desarrollo mínima

# server.cfg (development)
# Basic config for local testing

# Network
endpoint_add_tcp "0.0.0.0:30120" # TCP port binding
endpoint_add_udp "0.0.0.0:30120" # UDP port binding

# Server info
sv_hostname "My Dev Server"
sv_maxclients 8

# OneSync
set onesync on

# Resources (basic example)
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure baseevents

# Permissions (default ACL)
exec permissions.cfg

Configuración de producción endurecida

# server.cfg (production)

# Network
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Security
sv_endpointPrivacy true # Hides player IP addresses from public server reports; it does not hide the server origin
sv_scriptHook 0 # Disable client mods
# Leave rcon_password unset unless legacy RCon is explicitly required

# Slots
sv_maxclients 64 # Adjust to host capacity

# Game build (use latest recommended)
# Optional: pin a documented game build only when your resources require it

# Project info
sv_hostname "FIVEMX Roleplay | Serious RP"
sets sv_projectName "FIVEMX RP Server"
sets sv_projectDesc "Realistic RP with QBCore & custom scripts"
sets tags "roleplay, seriousrp, qbcore"
sets locale "en-US"
load_server_icon mylogo.png
sets banner_detail "https://cdn.example.com/banner.png"
sets banner_connecting "https://cdn.example.com/loading.png"

# OneSync
set onesync on

# Resources (use resource list)
exec resources.cfg

# Logging & ACL
set sv_logLevel 2
exec permissions.cfg

# txAdmin integration
# Load framework/database configuration from a separately permissioned config; do not publish real credentials

Consejo: Siempre valide su configuración después de las ediciones con las comprobaciones de salud de txAdmin y los registros de la consola. Consulte registros de txAdmin.

Información del servidor y lista

Las siguientes convars controlan cómo aparece su servidor en el navegador de servidores y API:

Ver el referencia oficial de comandos y cvars del servidor Cfx.re para la sintaxis y comportamiento actuales.

Red y slots

Los servidores FiveM usan puntos finales TCP/UDP. Por defecto, el puerto 30120 se usa.

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 64

• Ejecutar múltiples servidores en una máquina con desplazamientos de puerto: p.ej 30121, 30122.
• Ajustar reglas de firewall para abrir puertos TCP/UDP.
• sv_maxclients afecta directamente el uso de CPU y RAM — no establezca un valor superior al que su hardware puede manejar. Ver Proveedores de alojamiento de servidores

Advertencia: No exponga los puertos de MySQL o RCON a Internet.

Game build & artifacts

Una versión de artefacto FXServer y una compilación de juego GTA son opciones separadas. Actualice los artefactos a través de la ruta de compilación recomendada por Cfx.re; configure sv_enforceGameBuild solo cuando los recursos del servidor requieran una construcción de contenido GTA documentada, y verifica el valor en función de la referencia actual del comando Cfx.re.

# Optional startup-only setting; choose a value from the current Cfx.re reference
# sv_enforceGameBuild 

• [Documento oficial de convars][1] lista los números de compilación válidos.
• Establecer construcción en server.cfg o en txAdmin → Configuración → FXServer → Argumentos adicionales:

+set sv_enforceGameBuild 2944

• Descargar última versión artefactos de [runtime.fivem.net][4] (Windows) o la página de compilación de Linux.
• Nunca mezcle builds de cliente y servidor.

Configuración de OneSync

OneSync habilita sincronización de entidades del lado del servidor: más jugadores, estados precisos, mejor transmisión. Siempre use OneSync activado para frameworks modernos (QBCore, ESX).

Consejo: Escala sv_maxclients con hardware. Use Guía de Resmon para medir el impacto de los recursos.

Orden y dependencias de inicio de recursos

Los recursos se cargan en el orden definido por ensure. Siempre inicie las dependencias primero.

# resources.cfg (split file)
ensure oxmysql
ensure qb-core
ensure qb-adminmenu
ensure qb-inventory
ensure qb-policejob
ensure my-custom-scripts

En server.cfg:

exec resources.cfg

• Mantenga los frameworks y los conectores de DB en primer lugar.
• Agrupe los recursos relacionados.
• Evitar ensure * en producción; causa un orden no determinista.

Endurecimiento de seguridad y abuso

Seguro server.cfg evita fugas y abusos.

Lista de verificación:

• sv_endpointPrivacy true
• sv_scriptHook 0 (bloquear mods del cliente)
• Fuerte o deshabilitado rcon_password
• Usar add_principal y add_ace para ACLs
• Mantenga los secretos fuera de los repositorios públicos y los archivos de recursos compartidos/cliente; restrinja el acceso a la configuración solo del servidor que los contiene
• Actualizar artefactos regularmente
• Monitor registros de txAdmin
• Usar Guía de Resmon para atrapar scripts pesados

Ejemplo de ACL:

add_ace group.admin command allow
add_principal identifier.steam:110000112345678 group.admin

CDN y transmisión de activos (cuándo usar)

Para grandes MLOs, coches personalizados y texturas, usa un CDN para reducir tiempos de unión.

• Almacenar archivos en un CDN como Cloudflare R2 (establecer [encabezados CORS][6]).
• Para un alto rendimiento, BunnyCDN admite [solicitudes de rango][7] (necesarias para .rpf streaming).
• Agregue URLs con versión para evitar conflictos de caché.

Vea nuestro Optimizar tiempos de carga guía.

Mitos y banderas obsoletas

Muchas configs en línea aún muestran Variables del motor Source como:

sv_maxrate 0
sv_minrate 30000
sv_maxupdaterate 60

No usar. Estos no son compatibles en FiveM y no tienen efecto. Consulte [convars oficiales][1].

convars obsoletos/legados:

• sv_master1 → ya no es necesario.
• sv_useDirectListing → reemplazado por sv_endpointPrivacy.

Validación y solución de problemas

Verificaciones de claves después de editar server.cfg:

Packs de servidor

Explora productos de servidor completos para lanzamientos y renovaciones.

Packs de servidorBase del servidor ESX (por RibSosay)$53.99

Packs de servidorServidor completo QBus / QBCore v4.1$43.99

Packs de servidorPlantilla de servidor ESX Pro$136.99

Recursos internos & próximos pasos

• Cómo crear un servidor FiveM
• /fivem-servers

Preguntas frecuentes

1. ¿Qué es server.cfg en FiveM?
Es el archivo de configuración principal que define el nombre del servidor, las ranuras, los recursos, la red, la seguridad y la visibilidad.

2. ¿Dónde debo colocar server.cfg?
Dentro de la carpeta raíz de tu servidor (junto a server.exe o FXServer punto de entrada). txAdmin lo carga automáticamente.

3. ¿Cuál es la diferencia entre set, sets, y setr?

• set: variable solo para el servidor.
• sets: aparece en la lista del servidor (información pública).
• setr: sincronizado con los clientes.

4. ¿Por qué mi servidor no aparece en la lista?
Controlar sv_hostname, sets tags, sets locale, y sv_endpointPrivacy. También asegúrate de que tus puertos estén abiertos.

5. ¿Cómo aumento los slots de jugadores?
Cambiar sv_maxclients. Escala gradualmente y monitorea con Guía de Resmon. Asegúrese de que su hardware y red puedan manejarlo.

6. ¿Qué es sv_enforceGameBuild?
Un convar que obliga a los clientes a usar una versión específica del juego GTA. Evita los errores por versiones incompatibles. Consulta la [documentación de Convars][1].

7. ¿Debo usar números de compilación o alias?
Cualquiera funciona. Numérico (2944) es explícito; alias (mp2024_02) es más fácil de rastrear. Ambos son compatibles.

8. ¿Dónde lo configuro? sv_enforceGameBuild en txAdmin?
In txAdmin → Settings → FXServer → Additional arguments. Example: +set sv_enforceGameBuild 2944.

9. ¿Qué es OneSync?
Un sistema que permite más jugadores, transmisión de entidades precisa, autoridad del servidor. Requerido para frameworks modernos. Ver [OneSync docs][3].

10. Infinity vs Legacy OneSync?
Legacy = hasta 64 ranuras. Infinity = soporta 128+, sincronización avanzada de entidades. Siempre usa onesync on (Infinito por defecto).

11. ¿Cómo organizo los recursos?
Usar exec resources.cfg. Inicia primero los conectores de la base de datos, luego los frameworks y finalmente los trabajos/guiones. Evita ensure *.

12. ¿Por qué mis banners no aparecen en la lista del servidor?.
Asegúrate de que las URLs sean HTTPS, públicas y apunten a los tamaños de imagen correctos. Usa un CDN para fiabilidad.

13. What are txAdmin logs for?
Muestra errores, fallos, problemas de recursos. Ver registros de txAdmin.

14. ¿Cómo verifico problemas de rendimiento?
Usar resmon 1 en consola. Ver nuestro Guía de Resmon para más detalles.

15. ¿Son necesarios los indicadores de tasa del motor Source?
No. sv_maxrate, sv_minrate, sv_maxupdaterate no hacer nada en FiveM. Usa [doc de Convars][1] en su lugar.

Créditos:

• [Convars – Cfx.re Docs][1]
• [Comandos del servidor – Cfx.re Docs][2]
• [OneSync – Documentación Cfx.re][3]
• [Artefactos (compilaciones de Windows) – runtime.fivem.net

Para los campos específicos de la lista y actuales sv_master1 comportamiento, continuar con el Guía de configuración de la lista de servidores FiveM.

Referencias actuales del servidor.cfg oficial

• Ejemplo de configuración de FXServer Cfx.re vanilla
• comandos y convars del servidor Cfx.re
• Cfx.re Configuración de txAdmin