FiveMPubblicato il 15 dicembre 2025Lettura di 13 min

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.

CategoriaEsempi
IdentitàNome del server, descrizione, tag
LicenzaChiave di licenza Cfx.re, obbligatoria
GiocatoriNumero di slot, OneSync
RisorseScript, mappe, veicoli
PermessiACE e ACL, admin, gruppi
RetePorte, 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.

  1. Accedi a portal.cfx.re con il tuo account Cfx.re. Anche il vecchio indirizzo keymaster.fivem.net porta lì. Se non hai un account, clicca su Sign Up.

  2. Apri la pagina Server Registration Keys e clicca su Generate Key.

  3. Scrivi un nome per la chiave in Display Name e clicca su Generate.

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

Pagina Server Registration Keys del portale Cfx.re con il pulsante Generate Key

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

  1. Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server FiveM.

  2. Nella Console, ferma il server con il pulsante Ferma.

  3. Nel menu laterale, clicca su Gestione file.

  4. Clicca su server.cfg, nella cartella principale. Si apre la finestra «Modifica di server.cfg».

  5. Modifica il file e clicca su Salva.

  6. Riavvia il server dalla Console.

Le righe sotto ### AUTOMATICALLY SET BY PTERODACTYL ###, in cima al file, le scrive il pannello. Lasciale come sono.

Finestra Modifica di server.cfg nella Gestione file con il pulsante Salva

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

  1. Nel menu laterale, clicca su Configurazione FiveM.

  2. Nella scheda Canale FiveM, clicca su Legacy o su Enhanced.

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

Finestra Fai un backup prima di installare con i pulsanti Continua senza backup e Salva e continua

Prima di passare a Enhanced, metti la tua chiave nella variabile fivem license. Senza, il server si arresta all'avvio.

Cosa cambia nel pannello

ImpostazioneLegacyEnhanced
txAdminDisponibile, con le variabili txAdmin Port e Activer txadminNon disponibile, la pagina lo segnala con il titolo «txAdmin non disponibile su Enhanced»
Versione dell'artifactScelta da un elenco con Scegli una versionePulsante disattivato, la scelta dall'elenco è riservata a Legacy
Versione installataNumero di build, per esempio 38220Identificativo breve, per esempio 019ffb4d
Variabile di versionefivem versionfivem 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.

Pagina Configurazione FiveM su Enhanced con l'avviso txAdmin non disponibile e il pulsante Scegli una versione disattivato


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

Variabili d'ambiente di un server FiveM Legacy con fivem license, txAdmin Port e Activer 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_projectDesc e load_server_icon come 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-serious

  • italiano, italian, it

  • economy, jobs, police, ems

  • custom-cars, drift, racing

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

SlotCondizione
32Server piccolo o di prova
48Limite senza abbonamento Cfx.re, con OneSync
Da 64 a 128Abbonamento Element Club Argentum o Aurum
Fino a 2048Abbonamento 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
offDisattivato, limite di 32 giocatori
onAttivato, la modalità consigliata
legacyModalità 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.

ComandoEffetto
restart [risorsa]Riavvia una risorsa
stop [risorsa]Ferma una risorsa
start [risorsa]Avvia una risorsa
refreshAggiorna l'elenco delle risorse
statusMostra i giocatori connessi
quitFerma 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.

  1. Nel menu laterale, clicca su Configurazione FiveM.

  2. Nella scheda Inserisci connessione MySQL, clicca su Scegli un database.

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

Pagina Configurazione FiveM con la finestra Seleziona un database aperta

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.

BuildAggiornamento di 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

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"
ComandoVisibilità
setSolo sul server
setrReplicata ai client
setsVisibile 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

MessaggioSoluzione
Invalid license keyControlla la chiave sul portale Cfx.re e nella variabile fivem license
License key not setCompila la variabile fivem license o la riga sv_licenseKey
A valid license check is required to run this serverMessaggio 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 resourceVerifica che la risorsa esista nella cartella resources
MySQL connection failedControlla 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

CausaSoluzione
Chiave di licenza non validaGenera una nuova chiave sul portale Cfx.re
Righe endpoint modificateRimetti la porta principale, visibile in Gestione porte
Server ancora in avvioAttendi qualche minuto

Una risorsa non si carica

CausaSoluzione
Dipendenza mancanteInstalla le dipendenze indicate dall'autore
Errore nello scriptLeggi la console del server, o la console del gioco con F8
Ordine di caricamento sbagliatoRiordina le righe ensure
fxmanifest.lua mancanteVerifica che il file esista nella cartella della risorsa

Errore del database

MessaggioSoluzione
Access deniedControlla utente e password MySQL
Unknown databaseCrea il database
Connection refusedControlla host e porta

I permessi ACE non si applicano

CausaSoluzione
Identificativo sbagliatoControlla il prefisso (steam:, discord:, license:)
Server non riavviatoRiavvia dopo ogni modifica
Errore di battituraRileggi 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.

Questo articolo ti è stato utile?

2465 visualizzazioni
Condividi questo articolo
FiveM
Hai bisogno di un server GTA/FiveM?

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 →

Articoli correlati