server.cfg di FiveM: come configurarlo (nome, slot e risorse)
Introduzione
Il file server.cfg è il file di configurazione principale di un server FiveM. Questa guida ti mostra come configurare il server.cfg di FiveM da OuiPanel, il pannello di gioco di OuiHeberg. Passa in rassegna ogni impostazione comune con la sua riga di configurazione e si chiude con un esempio completo.
| Categoria | Esempi |
|---|---|
| Identità | Nome del server, descrizione, tag |
| Licenza | Chiave di licenza Cfx.re, obbligatoria |
| Giocatori | Numero di slot, OneSync |
| Risorse | Script, mappe, veicoli |
| Permessi | ACE e ACL, admin, gruppi |
| Rete | Porte, RCON |
Ottenere una chiave di licenza
Un server FiveM non si avvia senza chiave di licenza. La chiave è gratuita e si crea sul portale Cfx.re, che ha sostituito Keymaster.
Accedi a portal.cfx.re con il tuo account Cfx.re. Anche il vecchio indirizzo
keymaster.fivem.netporta lì. Se non hai un account, clicca su Sign Up.Apri la pagina Server Registration Keys e clicca su Generate Key.
Scrivi un nome per la chiave in Display Name e clicca su Generate.
Copia la chiave generata. Inizia con
cfxk_.
La guida Keymaster FiveM spiega nel dettaglio il portale, la gestione delle chiavi e gli errori di licenza.

Una chiave vale per un solo server alla volta. Tienila segreta e creane una per ogni server se ne hai più di uno.
Aprire il file server.cfg
Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server FiveM.
Nella Console, ferma il server con il pulsante Ferma.
Nel menu laterale, clicca su Gestione file.
Clicca su
server.cfg, nella cartella principale. Si apre la finestra «Modifica di server.cfg».Modifica il file e clicca su Salva.
Riavvia il server dalla Console.
Le righe sotto ### AUTOMATICALLY SET BY PTERODACTYL ###, in cima al file, le scrive il pannello. Lasciale come sono.

Ferma il server prima di modificare questo file. Il server rilegge server.cfg solo al riavvio successivo.
Scegliere l'edizione Legacy o Enhanced
OuiPanel propone FiveM in due edizioni, Legacy ed Enhanced. Il pannello le chiama canali. L'edizione si sceglie in Configurazione FiveM, scheda Canale FiveM, dove il badge Attuale indica quella del server.
Passare da un'edizione all'altra
Nel menu laterale, clicca su Configurazione FiveM.
Nella scheda Canale FiveM, clicca su Legacy o su Enhanced.
Si apre la finestra «Fai un backup prima di installare». Clicca su Salva e continua oppure su Continua senza backup.
Il pannello reinstalla il server sull'edizione scelta. La scheda precisa che il cambio mantiene la tua configurazione.

Prima di passare a Enhanced, metti la tua chiave nella variabile fivem license. Senza, il server si arresta all'avvio.
Cosa cambia nel pannello
| Impostazione | Legacy | Enhanced |
|---|---|---|
| txAdmin | Disponibile, con le variabili txAdmin Port e Activer txadmin | Non disponibile, la pagina lo segnala con il titolo «txAdmin non disponibile su Enhanced» |
| Versione dell'artifact | Scelta da un elenco con Scegli una versione | Pulsante disattivato, la scelta dall'elenco è riservata a Legacy |
| Versione installata | Numero di build, per esempio 38220 | Identificativo breve, per esempio 019ffb4d |
| Variabile di versione | fivem version | fivem version (Enhanced / UUID) |
La guida Cambiare la versione dell'artifact del tuo server FiveM spiega come scegliere una build su Legacy. Per aprire txAdmin, consulta Creare una whitelist FiveM con Discord e txAdmin.

Configurazione di base
Chiave di licenza (obbligatoria)
sv_licenseKey "la_tua_chiave_di_licenza_qui"
Sostituisci il valore con la chiave ottenuta sul portale Cfx.re. Senza una chiave valida, il server non si avvia.
In OuiPanel, la chiave si inserisce anche in Configurazione › Impostazioni del server, blocco Variabili d'ambiente, campo fivem license. Incolla la chiave e clicca sulla spunta a destra del campo per salvarla. Se il tuo server.cfg contiene una riga sv_licenseKey, mettici la stessa chiave.
Sull'edizione Enhanced serve una chiave tua. Lì Cfx.re rifiuta la chiave predefinita della variabile, e il server si arresta subito all'avvio.
Lo stesso blocco contiene Nom du serveur (nome del server), Joueurs maximum (giocatori massimi) e Clé API Web Steam (obsolète) (chiave API web di Steam, obsoleta). Tieni gli stessi valori nelle variabili e nel file. Su Legacy contiene anche txAdmin Port e l'interruttore Activer txadmin (attiva txAdmin).

Nome del server
sv_hostname "Il Mio Server FiveM | Roleplay IT"
È il nome mostrato nella lista dei server FiveM. Qualche consiglio per sceglierlo.
Breve e facile da ricordare.
Con il tipo di server (RP, Freeroam, Drift…).
Con la lingua (IT, EN…).
Con pochi emoji.
Qualche esempio.
sv_hostname "[IT] Revolution RP | Serious Roleplay"
sv_hostname "Los Santos Life | RP Italiano"
sv_hostname "Drift Paradise | Corse & Tuning"
Descrizione del server
sets sv_projectDesc "Server roleplay italiano con economia realistica, mestieri vari e community attiva."
Questa descrizione appare nei dettagli del server. Resta sotto i 200 caratteri.
Nome del progetto
sets sv_projectName "Revolution RP"
È il nome breve del progetto, mostrato in alcuni menu.
La documentazione di Cfx.re segna
sv_projectName,sv_projectDesceload_server_iconcome deprecati. Nome, descrizione e icona si impostano anche sul portale Cfx.re.
Tag del server
sets tags "roleplay, italiano, serious, economy, jobs"
I tag aiutano a trovare il server nella lista. Separali con le virgole. Ecco i più usati.
roleplay,rp,serious,semi-seriousitaliano,italian,iteconomy,jobs,police,emscustom-cars,drift,racingesx,qbcore,vrp
Icona del server
load_server_icon server_icon.png
Questa riga mostra un'icona nella lista dei server. L'immagine deve essere un PNG di 96 × 96 pixel, chiamato server_icon.png e messo nella cartella principale del server. Per caricarla, trascinala sulla cartella principale nella Gestione file.
Configurazione dei giocatori
Numero di slot
sv_maxclients 32
Oltre i 32 slot, OneSync deve essere attivo. Oltre i 64, deve essere impostato su on. Il limite dipende anche dal tuo account Cfx.re.
| Slot | Condizione |
|---|---|
32 | Server piccolo o di prova |
48 | Limite senza abbonamento Cfx.re, con OneSync |
Da 64 a 128 | Abbonamento Element Club Argentum o Aurum |
Fino a 2048 | Abbonamento Element Club Platinum, OneSync su on |
La variabile Joueurs maximum delle Impostazioni del server fissa lo stesso numero. Più giocatori chiedono anche più memoria e più processore.
Attivare OneSync
OneSync permette di superare i 32 giocatori e migliora la sincronizzazione.
set onesync on
| Modalità | Effetto |
|---|---|
off | Disattivato, limite di 32 giocatori |
on | Attivato, la modalità consigliata |
legacy | Modalità di compatibilità, sconsigliata da Cfx.re |
Per regolare OneSync più a fondo, aggiungi queste righe.
set onesync on
set onesync_population true
# Esclude dalla sincronizzazione le entità lontane e fuori dal campo visivo
set onesync_distanceCulling true
set onesync_distanceCullVehicles false
Punto di spawn
Il punto di spawn non si imposta nel server.cfg. Si dichiara in una risorsa di tipo mappa, con le coordinate X, Y e Z. La maggior parte dei framework (ESX, QBCore) gestisce lo spawn da sé.
spawnpoint 'a_m_y_hipster_01' { x = -269.4, y = -955.3, z = 31.2 }
Configurazione delle risorse
Avviare una risorsa
ensure nome_della_risorsa
Funziona anche il comando start.
start nome_della_risorsa
Preferisci
ensure. Avvia la risorsa, oppure la riavvia se è già in esecuzione.
Ordine di caricamento
L'ordine delle righe ensure conta, perché alcune risorse dipendono da altre. Ecco un ordine consigliato.
# 1. Risorse di base FiveM
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog
# 2. Database
ensure oxmysql
# 3. Framework (ESX o QBCore)
ensure es_extended
# 4. Dipendenze comuni
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# 5. Script essenziali
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
# 6. Lavori
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
# 7. Altri script
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin
# 8. Script personalizzati
ensure il_mio_script
Disattivare una risorsa
Per disattivare una risorsa, commenta la sua riga con #.
# ensure risorsa_disattivata
Comandi utili della console
Questi comandi si digitano nella Console di OuiPanel, senza barra iniziale.
| Comando | Effetto |
|---|---|
restart [risorsa] | Riavvia una risorsa |
stop [risorsa] | Ferma una risorsa |
start [risorsa] | Avvia una risorsa |
refresh | Aggiorna l'elenco delle risorse |
status | Mostra i giocatori connessi |
quit | Ferma il server |
Configurazione del database
Connessione MySQL
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
Sostituisci ogni parte con i dati del tuo database.
userè il nome utente MySQL.passwordè la sua password.hostè l'indirizzo del server MySQL.3306è la porta MySQL.databaseè il nome del database.
Trovi questi dati in Database, pulsante Informazioni. La guida Come creare e gestire un database MySQL su OuiPanel spiega come creare il database.
Ecco un esempio con valori fittizi.
set mysql_connection_string "mysql://u123_AbCdEfGh:PasswordSicura123@203.0.113.20:3306/s123_db?charset=utf8mb4"
Inserire la connessione da OuiPanel
OuiPanel può scrivere questa riga al posto tuo.
Nel menu laterale, clicca su Configurazione FiveM.
Nella scheda Inserisci connessione MySQL, clicca su Scegli un database.
Nella finestra «Seleziona un database», scegli il database e clicca su Conferma.
Il pannello aggiunge una riga set mysql_connection_string sotto il blocco ### AUTOMATICALLY SET BY PTERODACTYL ###. Una riga già presente viene commentata.

Formato chiave=valore
oxmysql accetta anche la stringa in coppie chiave=valore. La prima riga è il formato più vecchio, la seconda quello che scrive OuiPanel.
set mysql_connection_string "server=203.0.113.20;uid=u123_AbCdEfGh;password=PasswordSicura123;database=s123_db"
set mysql_connection_string "user=u123_AbCdEfGh;password=PasswordSicura123;host=203.0.113.20;port=3306;database=s123_db"
Configurazione dei permessi (ACE/ACL)
Il sistema ACE (Access Control Entry) gestisce i permessi su FiveM. La guida Come configurare i permessi ACE su FiveM approfondisce il tema.
Aggiungere un amministratore
Un giocatore diventa amministratore quando lo aggiungi al gruppo group.admin. L'identificativo Steam è il più usato.
add_principal identifier.steam:110000xxxxxxxxx group.admin
Con l'identificativo Discord.
add_principal identifier.discord:123456789012345678 group.admin
Con l'identificativo di licenza Rockstar.
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin
Il tuo identificativo Steam si trova su SteamID.io. Serve la forma esadecimale, che inizia con
110000.
Creare gruppi di permessi
# Gruppo admin con tutti i comandi tranne quit
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Gruppo moderatore
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
# Il gruppo admin eredita i permessi del gruppo moderatore
add_principal group.admin group.moderator
Permessi comuni
# Il gruppo admin può usare tutti i comandi
add_ace group.admin command allow
# Permessi specifici
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
# Permessi vMenu
add_ace group.admin vMenu.Everything allow
add_ace group.moderator vMenu.OnlinePlayers.Kick allow
add_ace group.moderator vMenu.OnlinePlayers.TempBan allow
Assegnare un giocatore a un gruppo
add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator
Configurazione di rete
Porta del server
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
In OuiPanel, queste due righe fanno parte del blocco scritto dal pannello. Usano la porta principale del tuo server, visibile in Configurazione › Gestione porte. Non modificarle.
RCON (console remota)
rcon_password "PasswordRconMoltoSicura"
RCON permette di controllare il server a distanza. Scegli una password lunga e unica. Per disattivare RCON, lascia il valore vuoto con rcon_password "".
Chiave API di Steam
FiveM non usa più steam_webApiKey dal 4 novembre 2026, secondo la sua documentazione ufficiale. Lascia la variabile Clé API Web Steam (obsolète) di OuiPanel su none e non aggiungerla a server.cfg. Per richiedere un account Steam, usa sv_enforceSteamAuth su un server con la build 38004 o successiva, come spiega la guida Permessi ACE su FiveM.
Configurazione del gameplay
Il PvP, il radar o la modalità passiva non si impostano nel server.cfg. Dipendono dalle tue risorse e dal tuo framework. Il file contiene comunque alcune impostazioni utili al gameplay.
Versione del gioco (game build)
sv_enforceGameBuild 2944
Questa riga impone ai giocatori una versione di GTA V. Garantisce la compatibilità delle risorse, come veicoli o mappe di un aggiornamento recente.
| Build | Aggiornamento di 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 |
Sul canale Enhanced di FiveM è supportata solo l'ultima versione del gioco.
Script Hook e file modificati
# Rifiuta i giocatori che usano Script Hook V (valore predefinito)
sv_scriptHookAllowed 0
# Blocca i file di gioco modificati, tranne l'audio e le mod grafiche note
sv_pureLevel 1
Con sv_pureLevel 2, vengono bloccati tutti i file modificati. Cfx.re sconsiglia di consentire Script Hook, che espone il server a falle di sicurezza.
Convar utili
Definire variabili
set la_mia_variabile "valore"
setr la_mia_variabile_replicata "valore"
sets la_mia_variabile_serverinfo "valore"
| Comando | Visibilità |
|---|---|
set | Solo sul server |
setr | Replicata ai client |
sets | Visibile nelle informazioni del server |
Variabili del framework ESX
setr esx:locale "it"
Questa riga imposta la lingua di ESX Legacy. Il denaro iniziale e le altre impostazioni si trovano nel file di configurazione di es_extended, non nel server.cfg.
Variabili del framework QBCore
setr qb_locale "it"
Questa riga imposta la lingua di QBCore. Il denaro iniziale si imposta in qb-core/config.lua.
Esempio di server.cfg completo
Ecco un server.cfg completo. Lascia in cima al file il blocco scritto da OuiPanel.
# ============================================
# CONFIGURAZIONE DEL SERVER FIVEM
# ============================================
# === LICENZA ===
sv_licenseKey "la_tua_chiave_di_licenza_qui"
# === IDENTITÀ DEL SERVER ===
sv_hostname "[IT] Il Mio Server RP | Serious Roleplay"
sets sv_projectName "Il Mio Server RP"
sets sv_projectDesc "Server roleplay italiano con economia realistica e community attiva."
sets tags "roleplay, italiano, serious, esx, economy"
load_server_icon server_icon.png
# === GIOCATORI ===
sv_maxclients 48
set onesync on
# === RETE (righe scritte da OuiPanel con la porta principale) ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# === RCON ===
rcon_password ""
# === DATABASE ===
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
# FiveM non usa più steam_webApiKey dal 04/11/2026
# === GAMEPLAY ===
sv_enforceGameBuild 2944
# ============================================
# PERMESSI ACE/ACL
# ============================================
# Gruppo admin
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Amministratori (sostituisci con i tuoi identificativi)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin
# ============================================
# RISORSE
# ============================================
# === Base FiveM ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog
# === Database ===
ensure oxmysql
# === Framework ESX ===
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# === Script ESX ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin
# === Lavori ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
# === Altri script ===
ensure esx_vehicleshop
ensure esx_property
# === Script personalizzati ===
# ensure il_mio_script
Risoluzione dei problemi
Il server non si avvia
| Messaggio | Soluzione |
|---|---|
Invalid license key | Controlla la chiave sul portale Cfx.re e nella variabile fivem license |
License key not set | Compila la variabile fivem license o la riga sv_licenseKey |
A valid license check is required to run this server | Messaggio dell'edizione Enhanced. Metti la tua chiave nella variabile fivem license |
Command not found (sv_endpointprivacy) | Visto sull'edizione Enhanced, che non riconosce questo comando. Da solo, questo messaggio non arresta il server |
Could not find resource | Verifica che la risorsa esista nella cartella resources |
MySQL connection failed | Controlla la stringa di connessione MySQL |
Quando FXServer scrive «Could not authenticate server license key», la console di OuiPanel apre la finestra «Chiave di licenza FiveM rifiutata». Il suo pulsante Apri le impostazioni del server ti porta direttamente alla variabile da correggere. Su Enhanced il messaggio di rifiuto è diverso e questa finestra non si apre.
Il server non compare nella lista
| Causa | Soluzione |
|---|---|
| Chiave di licenza non valida | Genera una nuova chiave sul portale Cfx.re |
Righe endpoint modificate | Rimetti la porta principale, visibile in Gestione porte |
| Server ancora in avvio | Attendi qualche minuto |
Una risorsa non si carica
| Causa | Soluzione |
|---|---|
| Dipendenza mancante | Installa le dipendenze indicate dall'autore |
| Errore nello script | Leggi la console del server, o la console del gioco con F8 |
| Ordine di caricamento sbagliato | Riordina le righe ensure |
fxmanifest.lua mancante | Verifica che il file esista nella cartella della risorsa |
Errore del database
| Messaggio | Soluzione |
|---|---|
Access denied | Controlla utente e password MySQL |
Unknown database | Crea il database |
Connection refused | Controlla host e porta |
I permessi ACE non si applicano
| Causa | Soluzione |
|---|---|
| Identificativo sbagliato | Controlla il prefisso (steam:, discord:, license:) |
| Server non riavviato | Riavvia dopo ogni modifica |
| Errore di battitura | Rileggi la sintassi di ogni riga |
Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.
Scopri le nostre offerte di hosting GTA V / FiveM a partire da 2,99 €/mese, con il server pronto in 60 secondi.
Vedi le offerte →