FiveM server.cfg Guide

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 (sviluppo) # Configurazione di base per test locali # Rete endpoint_add_tcp "0.0.0.0:30120" # Binding porta TCP endpoint_add_udp "0.0.0.0:30120" # Binding porta UDP # Informazioni sul server sv_hostname "Il mio server di sviluppo" sv_maxclients 8 # OneSync imposta onesync su # Risorse (esempio di base) ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure baseevents # Autorizzazioni (ACL predefinito) exec permissions.cfg

Configurazione di produzione rafforzata

# server.cfg (produzione) # Rete endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" # Sicurezza sv_endpointPrivacy true # Nascondi IP nell'elenco server sv_scriptHook 0 # Disabilita mod client rcon_password "StrongRconPassword123" # Disabilita se non necessario # Slot sv_maxclients 64 # Adatta alla capacità dell'host # Build del gioco (usa l'ultima versione consigliata) sv_enforceGameBuild 2944 # Oppure alias: "mp2024_02" # Informazioni sul progetto sv_hostname "FIVEMX Roleplay | Serious RP" imposta sv_projectName "Server RP FIVEMX" imposta sv_projectDesc "RP realistico con QBCore e script personalizzati" imposta i tag "roleplay, seriousrp, qbcore" imposta le impostazioni locali "en-US" load_server_icon mylogo.png imposta banner_detail "https://cdn.example.com/banner.png" imposta banner_connecting "https://cdn.example.com/loading.png" # OneSync imposta onesync su # Risorse (usa l'elenco delle risorse) esegui resources.cfg # Registrazione e ACL imposta sv_logLevel 2 esegui permissions.cfg # Integrazione txAdmin imposta mysql_connection_string "mysql://user:pass@localhost/fivemdb"

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:

Convar	Scopo	Esempio	Quando cambiare	Avvertenze
sv_nomehost	Nome pubblico nell'elenco dei server	sv_hostname "Il mio server RP [EN]"	Sempre impostato	Evita i caratteri speciali, mantienili puliti
imposta sv_projectName	Nome visualizzato del progetto interno	imposta sv_projectName "MyCommunityRP"	Branding, configurazioni multi-server	Visibile solo nell'interfaccia utente dell'elenco
imposta sv_projectDesc	Descrizione mostrata nell'elenco	imposta sv_projectDesc "Server QBCore RP"	Aggiungi regole, linguaggio, funzionalità	Mantieni < 100 caratteri
imposta i tag	Tag dell'elenco dei server	imposta i tag "gioco di ruolo, auto, qbcore"	Migliorare la rilevabilità	Utilizzare solo tag ufficiali
imposta le impostazioni locali	Lingua predefinita	imposta le impostazioni locali su "en-US"	Lingua del server di corrispondenza	Le impostazioni locali errate potrebbero nascondere il server
sv_endpointPrivacy	Nascondi l'IP pubblico nel browser	sv_endpointPrivacy vero	Consigliato per la produzione	I giocatori si connettono tramite relay Cfx
icona_carica_server	Icona PNG 96×96	load_server_icon mylogo.png	Per il branding	Deve essere quadrato, <96×96 pixel
imposta banner_detail	Grande banner nell'elenco dei server	imposta banner_detail "url"	Facoltativo ma consigliato	Deve essere un URL HTTPS
imposta banner_connecting	Banner mostrato durante la connessione	imposta banner_connecting "url"	Ottimo per il branding/caricamento	Utilizzare CDN per evitare ritardi

Per un riferimento completo, vedere [l'elenco ufficiale delle convar][1].

---

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

Ogni build del server (artefatto) corrisponde a una build del gioco GTA V. Sempre aggiungi una build specifica per evitare cambiamenti inaspettati.

# Esempio di forzatura della build 2944 (aggiornamento Los Santos Drug Wars) sv_enforceGameBuild 2944 # oppure utilizzare l'alias enforce_game_build mp2024_02

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

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

Collocamento	Effetto	Valore tipico	Impatto su CPU/memoria	Documenti
sincronia	Abilita OneSync	SU	Maggiore utilizzo della CPU	[Documenti OneSync][3]
onesync_population	Controlla i PNG/traffico locali	SU (opzionale)	Aggiunge carico alla CPU	[Documenti OneSync][3]
onesync_distanceCullVehicles	Trasmetti in streaming i veicoli in modo efficiente	VERO	Migliori prestazioni, risparmio di larghezza di banda	[Documenti OneSync][3]

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 garantireAvviare sempre prima le dipendenze.

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

In server.cfg:

risorse esecutive.cfg

• Dare priorità ai framework e ai connettori DB.
• Risorse correlate al gruppo.
• Evitare garantire * 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 vero
• sv_scriptHook 0 (blocca i moderatori dei clienti)
• Forte o disabile rcon_password
• Utilizzo aggiungi_principale E aggiungi_asso per ACL
• Nascondi le chiavi API in .ambiente, non in server.cfg
• Aggiorna regolarmente gli artefatti
• Monitor registri txAdmin
• Utilizzo Guida Resmon per catturare script pesanti

Esempio ACL:

comando add_ace group.admin consente 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:

Sintomo	Probabile causa	Aggiustare	Tempo
Il server non si avvia	Errore di sintassi nella configurazione	Controlla la console, rimuovi le righe non valide	5 metri
Non presente nell'elenco dei server	Mancante sv_nomehost/tag	Aggiungi nome host/tag, controlla il firewall, sv_master1	10 metri
I giocatori non riescono a connettersi	Porte chiuse / IP errato	Apri 30120 TCP+UDP, controlla endpoint_add_*	15 metri
Elevato utilizzo della CPU	Troppi slot / script errati	Inferiore sv_maxclients, utilizzo Ottimizzazione delle prestazioni	20 metri
Tempi di caricamento lunghi	Grandi asset non ottimizzati	Utilizzo Ottimizza i tempi di caricamento + CDN	20 metri
Arresti anomali dopo l'aggiornamento	Mancata corrispondenza della build	Spillo sv_enforceGameBuild, aggiorna [artefatti][4]	15 metri

---

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 Server FX entrypoint). txAdmin lo carica automaticamente.

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

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

4. Il mio server non compare nell'elenco. Perché?
Controllo sv_nomehost, imposta i tag, imposta le impostazioni locali, 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: +imposta 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 sincronizzazione attiva (Infinito per impostazione predefinita).

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

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