Area cliente
FiveM•15 dicembre 2025• 1523 visualizzazioni

Come configurare server.cfg sul proprio server FiveM

Come configurare server.cfg sul proprio server FiveM

Tempo stimato : 15 minuti
Difficoltà : Intermedia ⭐⭐
Server compatibili : FiveM

📋 Introduzione

Il file server.cfg è il file di configurazione principale del tuo server FiveM. Permette di definire il nome del server, il numero di giocatori, le risorse da caricare, i permessi e molto altro ancora.

Ciò che puoi configurare

Categoria Esempi
🏷️ Identità Nome del server, descrizione, tag
🔑 Licenza Chiave di licenza Cfx.re (obbligatoria)
👥 Giocatori Slot max, OneSync
📦 Risorse Script, mappe, veicoli
🔒 Permessi ACE/ACL, admin, gruppi
⚙️ Rete Porti, RCON

🔑 Requisiti: Ottenere una Chiave di Licenza

Prima di configurare il tuo server, devi ottenere una chiave di licenza gratuita su Cfx.re.

Creare un account Cfx.re

  1. Vai su Cfx.re
  2. Clicca su Sign Up (o accedi se hai già un account)
  3. Crea il tuo account con email o Discord

Generare la chiave di licenza

  1. Accedi su Cfx.re Keymaster
  2. Clicca su Register a new server
    Immagine
  1. Compila il modulo :
    Immagine
  1. Clicca su Generate
  2. Copia la chiave generata (formato: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

Immagine

⚠️ Importante :

  • Una chiave = un server
  • Conserva questa chiave segreta
  • Puoi generare più chiavi per più server

📁 Accedere al File server.cfg

Via il Gestore di File

  1. Accedi a OuiPanel
  2. Seleziona il tuo server FiveM
  3. Nel menu laterale, clicca su Gestore di file
  4. Apri il file server.cfg nella radice

Immagine

  1. Clicca sul file per poterlo Modificare

Immagine

⚠️ Importante : Ferma il tuo server prima di modificare questo file, poi riavvialo per applicare le modifiche.

🏷️ Configurazione di Base

Chiave di Licenza (Obbligatoria)

sv_licenseKey "la_tua_chiave_di_licenza_qui"

Sostituisci con la chiave ottenuta su Keymaster.

⚠️ Senze una chiave di licenza valida, il tuo server non si avvierà.

Nome del Server

sv_hostname "Il Mio Server FiveM | Roleplay IT"

È il nome visualizzato nell'elenco dei server FiveM.

Consigli per il nome :

  • ✅ Breve e memorabile
  • ✅ Includere il tipo (RP, Freeroam, Drift...)
  • ✅ Includere la lingua (IT, EN...)
  • ✅ Usare emoji con moderazione

Esempi :

sv_hostname "🇮🇹 Revolution RP | Serious Roleplay"
sv_hostname "Los Santos Life | RP Italofono"
sv_hostname "Drift Paradise | Corsa & Tuning"

Descrizione del Server

sv_projectDesc "Server roleplay italofono con economia realistica, mestieri variati e comunità attiva."

Descrizione visualizzata nei dettagli del server. Massimo 200 caratteri consigliati.

Nome del Progetto

sv_projectName "Revolution RP"

Nome breve del progetto (visualizzato in alcuni menu).

Tag del Server

sets tags "roleplay, italiano, serious, economy, jobs"

Tag per il posizionamento nell'elenco dei server. Separare con virgole.

Tag popolari :

  • roleplay, rp, serious, semi-serious
  • italiano, italian, it
  • economy, jobs, police, ems
  • custom-cars, drift, racing
  • esx, qbcore, vrp

Immagine/Banner del Server

load_server_icon server_icon.png

Mostra un'icona nell'elenco dei server.

Specifiche :

  • Formato : PNG
  • Dimensione : 96x96 pixel
  • Nome : server_icon.png
  • Posizione : radice del server

👥 Configurazione dei Giocatori

Numero di Slot Massimo

sv_maxclients 32
Valore Raccomandazione
32 Piccolo server / Test
64 Server medio
128 Grande server
256+ Server molto grande (OneSync richiesto)

⚠️ Più giocatori = più risorse necessarie (RAM, CPU).

Attivare OneSync

OneSync consente di gestire più di 32 giocatori e migliora la sincronizzazione.

set onesync on
Modalità Descrizione
off Disattivato (limite 32 giocatori)
on Attivato (raccomandato)
legacy Modalità legacy

Configurazione OneSync avanzata :

set onesync on
set onesync_population true

# Distanza di culling (portata di vista delle entità)
set onesync_distanceCullVehicles false
set onesync_distanceCull 500

Configurazione dello Spawn

spawnpoint 0 -269.4 -955.3 31.2

Coordinate di spawn predefinite (X, Y, Z). La maggior parte dei framework (ESX, QBCore) gestisce lo spawn da soli.

📦 Configurazione delle Risorse

Avviare una Risorsa

ensure nome_della_risorsa

Oppure :

start nome_della_risorsa

💡 ensure è raccomandato perché riavvia la risorsa se si arresta.

Ordine di Caricamento

L'ordine delle ensure è importante! Alcune risorse dipendono da altre.

Ordine raccomandato :

# 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 / Mestieri
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# 7. Altri script
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin

# 8. Script custom
ensure il_mio_script_custom

Fermare una Risorsa

Per disattivare una risorsa, commenta la riga con # :

# ensure risorsa_disattivata

🗄️ Configurazione del Database

Connessione MySQL

set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

Sostituisci :

  • user : Nome utente MySQL
  • password : Password MySQL
  • host : Indirizzo del server MySQL
  • 3306 : Porta MySQL
  • database : Nome del database

📖 Consulta la guida "Creare e Gestire un Database MySQL" per creare il tuo database.

Esempio con OuiHeberg :

set mysql_connection_string "mysql://s123_bdd:[email protected]:3306/s123_bdd?charset=utf8mb4"

Alternative di configurazione MySQL

Formato JDBC (vecchio) :

set mysql_connection_string "server=mysql-1.ouiheberg.com;uid=s123_bdd;password=PasswordSicura123;database=s123_bdd"

🔒 Configurazione dei Permessi (ACE/ACL)

Sistema ACE

Il sistema ACE (Access Control Entry) gestisce i permessi su FiveM.

Aggiungere un Amministratore

Per identificativo Steam (raccomandato) :

add_ace identifier.steam:110000xxxxxxxxx group.admin allow
add_principal identifier.steam:110000xxxxxxxxx group.admin

Per identificativo Discord :

add_ace identifier.discord:123456789012345678 group.admin allow
add_principal identifier.discord:123456789012345678 group.admin

Per identificativo Licenza :

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin

💡 Per trovare il tuo identificativo Steam : SteamID.io

Creare Gruppi di Permessi

# Creare il gruppo admin con tutti i permessi
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Creare il gruppo moderatore
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Eredita i permessi
add_principal group.admin group.moderator

Permessi Comuni

# Permettere al gruppo admin di utilizzare 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.kick allow
add_ace group.moderator vMenu.ban allow

Assegnare un Giocatore a un Gruppo

add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator

⚙️ Configurazione Rete

Porto del Server

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

⚠️ Su OuiHeberg, il porto è gestito automaticamente. Usa il porto assegnato al tuo server.

RCON (Console Remota)

rcon_password "PasswordRconMoltoSicura"

Permette di controllare il server da remoto. Usa una password forte!

💡 Lascia vuoto per disattivare RCON : rcon_password ""

Configurazione Steam

set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Chiave API Steam (opzionale, per alcune funzionalità). Ottienila su : Steam Web API Key

🎮 Configurazione Gameplay

Attivare/Disattivare le Funzionalità

# Disattivare la modalità passiva automatica
sv_disablePassive false

# Attivare il PvP
sv_enablePVP true

# Disattivare la sincronizzazione del tempo
sv_disableTimeSync true

# Mostrare il logo FiveM al caricamento
sv_showFiveMBanner true

Modalità Hardcore / Seria

# Disattivare il radar automatico
sv_disableRadar true

# Disattivare le notifiche native
sv_disableClientNotify true

# Modalità RP seria
set sv_enforceGameBuild 2944

Build del Gioco

sv_enforceGameBuild 2944

Forza una versione specifica di GTA V. Utile per la compatibilità delle risorse.

Build Versione GTA V
2060 Los Santos Summer Special
2189 Cayo Perico
2372 Los Santos Tuners
2545 The Contract
2699 Criminal Enterprises
2944 San Andreas Mercenaries
3095 Chop Shop

📜 Variabili Convars Utili

Definire Variabili

set la_mia_variabile "valore"
setr la_mia_variabile_replicata "valore"
sets la_mia_variabile_serverinfo "valore"
Comando Visibilità
set Solo server
setr Replicata ai client
sets Visibile nelle info server

Variabili Framework ESX

set es_enableCustomData 1
set es_startingCash 50000
set es_startingBank 100000
set es_startingBlackMoney 0

Variabili Framework QBCore

set qb_locale "it"
set qb_starterMoney 5000
set qb_starterBank 10000

📄 File server.cfg Completo (Esempio)

Ecco un esempio di server.cfg completo e funzionante :

# ============================================
# CONFIGURAZIONE DEL SERVER FIVEM
# ============================================

# === LICENZA ===
sv_licenseKey "la_tua_chiave_di_licenza_qui"

# === IDENTITÀ DEL SERVER ===
sv_hostname "🇮🇹 Il Mio Server RP | Serious Roleplay"
sv_projectName "Il Mio Server RP"
sv_projectDesc "Server roleplay italofono con economia realistica e comunità attiva."
sets tags "roleplay, italiano, serious, esx, economy"
load_server_icon server_icon.png

# === GIOCATORI ===
sv_maxclients 64
set onesync on

# === RETE ===
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"

# === STEAM (Opzionale) ===
# set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXX"

# === 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

# === Mestieri ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# === Altri script ===
ensure esx_vehicleshop
ensure esx_property

# === Script custom ===
# ensure il_mio_script

🔧 Risoluzione dei Problemi

Il server non si avvia

❌ Errore ✅ Soluzione
Invalid license key Controlla la tua chiave su Keymaster
License key not set Aggiungi sv_licenseKey in server.cfg
Could not find resource Controlla che la risorsa esista nella cartella resources
MySQL connection failed Controlla la stringa di connessione MySQL

Il server non appare nell'elenco

❌ Causa ✅ Soluzione
Chiave di licenza non valida Rigenera una chiave su Keymaster
Porto bloccato Controlla che i porti TCP/UDP siano aperti
Server in avvio Attendi qualche minuto

Risorsa che non si carica

❌ Causa ✅ Soluzione
Dipendenza mancante Controlla le dipendenze richieste
Errore nello script Controlla la console (F8 in gioco)
Ordine di caricamento errato Riordina le ensure
fxmanifest.lua mancante Controlla che il file esista

Errore di database

❌ Errore ✅ Soluzione
Access denied Controlla user/password MySQL
Unknown database Crea il database
Connection refused Controlla l'host e la porta

Permessi ACE non applicati

❌ Causa ✅ Soluzione
Identificativo errato Controlla il formato (steam:, discord:, license:)
Server non riavviato Riavvia dopo la modifica
Errore di battitura Controlla la sintassi

📝 Comandi Console Utili

Comando Descrizione
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

📝 Riepilogo

1. Ottenere una chiave di licenza su Keymaster (Cfx.re)
2. Fermare il server
3. Gestore file → server.cfg → Modifica
4. Configurare :
   - sv_licenseKey (obbligatorio)
   - sv_hostname (nome del server)
   - sv_maxclients (slot)
   - mysql_connection_string (database)
   - Risorse (ensure)
   - Permessi ACE (admins)
5. Salvare il file
6. Riavviare il server
7. Controllare nella lista dei server FiveM

Hai bisogno di un server GTA/FiveM?

Scopri le nostre offerte di hosting GTA V / FiveM a partire da 9,98€/mese con deployment istantaneo.

Vedi le offerte
Torna alla documentazione