FiveM server.cfg Guide: Safe Starter Config

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

IL server.cfg Il file è il cuore di ogni server FiveM. Definisce il funzionamento del server: slot, networking, build del gioco, OneSync, log e visibilità nell'elenco dei server. Questa guida è per proprietari e sviluppatori di server che desiderano impostazioni predefinite sicure, protezione della produzione e best practice per le prestazioni. Esegui sempre backup e utilizza il controllo delle versioni. Se sei nuovo, inizia con il nostro Come creare un server FiveMPer ottimizzazioni più approfondite, vedere il nostro Centro prestazioni.

TL;DR: Baseline pronta per la produzione (annotata)

Un pulito server.cfg è il fondamento della stabilità. Di seguito sono riportati due esempi: un minimo configurazione di sviluppo e un configurazione di produzione rafforzata.

Configurazione minima dello sviluppatore

# 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

Configurazione di produzione rafforzata

# 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

Mancia: Convalidare sempre la configurazione dopo le modifiche con i controlli di integrità di txAdmin e i log della console. Vedere registri txAdmin.

Informazioni e elenco del server

Le seguenti convar controllano il modo in cui il tuo server appare nel browser del server e API:

Vedi il official Cfx.re server command and convar reference for current syntax and behavior.

Networking e slot

I server FiveM utilizzano Endpoint TCP/UDPPer impostazione predefinita, porta 30120 viene utilizzato.

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

• Esegui più server su una macchina con offset delle porte: per esempio 30121, 30122.
• Abbina le regole del firewall per aprire le porte TCP/UDP.
• sv_maxclients influisce direttamente sull'utilizzo della CPU e della RAM: non impostare un valore superiore a quello gestibile dall'hardware. Vedi i provider di hosting del server

Avvertimento: Non esporre le porte MySQL o RCON a Internet.

Creazione del gioco e artefatti

An FXServer artifact version and a GTA V game build are separate choices. Update artifacts through Cfx.re’s recommended build path; set sv_enforceGameBuild only when the server’s resources require a documented GTA content build, and verify the value against the current Cfx.re command reference.

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

• [Documento ufficiale convars][1] elenca i numeri di build validi.
• Imposta la costruzione server.cfg O in txAdmin → Impostazioni → FXServer → Argomenti aggiuntivi:

+set sv_enforceGameBuild 2944

• Scarica l'ultima versione artefatti da [runtime.fivem.net][4] (Windows) o dalla pagina di compilazione di Linux.
• Non mischiare mai build client e server.

Configurazione OneSync

OneSync abilita sincronizzazione delle entità lato server: più giocatori, stati accurati, streaming migliore. Usa sempre OneSync attivo per framework moderni (QBCore, ESX).

Mancia: Scala sv_maxclients con l'hardware. Utilizzare Guida Resmon per misurare l'impatto sulle risorse.

Ordine di avvio e dipendenze delle risorse

Le risorse vengono caricate nell'ordine definito da ensureAvviare sempre prima le dipendenze.

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

In server.cfg:

exec resources.cfg

• Dare priorità ai framework e ai connettori DB.
• Risorse correlate al gruppo.
• Evitare ensure * nella produzione; provoca un ordine non deterministico.

Rafforzamento della sicurezza e degli abusi

Un sicuro server.cfg previene perdite e abusi.

Lista di controllo:

• sv_endpointPrivacy true
• sv_scriptHook 0 (blocca i moderatori dei clienti)
• Forte o disabile rcon_password
• Utilizzo add_principal E add_ace per ACL
• Keep secrets out of public repositories and client/shared resource files; restrict access to the server-only configuration that contains them
• Aggiorna regolarmente gli artefatti
• Monitor registri txAdmin
• Utilizzo Guida Resmon per catturare script pesanti

Esempio ACL:

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

CDN e streaming di risorse (quando utilizzarlo)

Per MLO di grandi dimensioni, auto personalizzate e texture, utilizzare un CDN per ridurre tempi di partecipazione.

• Ospita i file su un CDN come Cloudflare R2 (imposta [intestazioni CORS][6]).
• Per prestazioni elevate, BunnyCDN supporta [richieste di intervallo][7] (necessarie per .rpf streaming).
• Aggiungere URL con versione per evitare conflitti nella cache.

Vedi il nostro Ottimizza i tempi di caricamento guida.

Miti e flag deprecati

Molte configurazioni online mostrano ancora Cvar del motore sorgente Piace:

sv_maxrate 0
sv_minrate 30000
sv_maxupdaterate 60

Non utilizzare. Questi non sono supportati in FiveM e non hanno alcun effetto. Vedi [convar ufficiali][1].

Convar obsolete/obsolete:

• sv_master1 → non più necessario.
• sv_useDirectListing → sostituito da sv_endpointPrivacy.

Validazione e risoluzione dei problemi

Controlli chiave dopo la modifica server.cfg:

Pacchetti server

Esplora prodotti server completi per avvii e ricostruzioni.

Pacchetti serverBase del server ESX (di RibSosay)$53.99

Pacchetti serverServer completo QBus/QBCore v4.1$43.99

Pacchetti serverModello di server ESX Pro$136.99

Risorse interne e prossimi passi

• Come creare un server FiveM
• /fivem-server

Domande frequenti

1. Che cosa è server.cfg in FiveM?
È il file di configurazione principale che definisce il nome del server, gli slot, le risorse, la rete, la sicurezza e la visibilità.

2. Dove dovrei posizionare server.cfg?
All'interno della cartella radice del tuo server (accanto a server.exe O FXServer entrypoint). txAdmin lo carica automaticamente.

3. Qual è la differenza tra set, sets, E setr?

• set: variabile riservata al server.
• sets: viene visualizzato nell'elenco dei server (informazioni pubbliche).
• setr: sincronizzato con i client.

4. Il mio server non compare nell'elenco. Perché?
Controllo sv_hostname, sets tags, sets locale, E sv_endpointPrivacyAssicurati inoltre che le porte siano aperte.

5. Come posso aumentare gli slot dei giocatori?
Modifica sv_maxclients. Scalare gradualmente e monitorare con Guida ResmonAssicurati che l'hardware e la rete siano in grado di gestirlo.

6. Che cosa è sv_enforceGameBuild?
Una convar che obbliga i client a utilizzare una build specifica di GTA V. Previene gli arresti anomali dovuti a versioni non corrispondenti. Vedi [Convars doc][1].

7. Dovrei usare numeri di build o alias?
Entrambi funzionano. Numerico (2944) è esplicito; alias (mp2024_02) è più facile da tracciare. Entrambi sono supportati.

8. Dove devo impostare sv_enforceGameBuild in txAdmin?
In txAdmin → Impostazioni → FXServer → Argomenti aggiuntivi. Esempio: +set sv_enforceGameBuild 2944.

9. Che cos'è OneSync?
Un sistema che consente più giocatori, streaming accurato delle entità e autorità del server. Necessario per i framework moderni. Vedi [Documentazione OneSync][3].

10. Infinity o OneSync legacy?
Legacy = fino a 64 slot. Infinity = supporta 128+, sincronizzazione avanzata delle entità. Usare sempre onesync on (Infinito per impostazione predefinita).

11. Come organizzo le risorse?
Utilizzo exec resources.cfgAvviare prima i connettori DB, poi i framework, quindi i lavori/script. Evitare ensure *.

12. I miei banner non vengono visualizzati nell'elenco dei server.
Assicurati che gli URL siano HTTPS, pubblici e puntino alle dimensioni corrette delle immagini. Utilizza una CDN per garantire l'affidabilità.

13. A cosa servono i log di txAdmin?
Mostrano errori, arresti anomali, problemi di risorse. Vedi registri txAdmin.

14. Come posso verificare i problemi di prestazioni?
Utilizzo resmon 1 nella console. Vedi il nostro Guida Resmon per i dettagli.

15. Sono necessari i flag di tariffazione del motore di origine?
NO. sv_maxrate, sv_minrate, sv_maxupdaterate non fare nulla in FiveM. Usa invece [Convars doc][1].

Crediti:

• [Convars – Documentazione Cfx.re][1]
• [Comandi del server – Documentazione Cfx.re][2]
• [OneSync – Documentazione Cfx.re][3]
• [Artefatti (build di Windows) – runtime.fivem.net

For the listing-specific fields and current sv_master1 behavior, continue with the FiveM server list configuration guide.

Current official server.cfg references

• Cfx.re vanilla FXServer configuration example
• Cfx.re server commands and convars
• Configurazione di Cfx.re txAdmin