03 - server.cfg

3 min read

server.cfg — Configurazione

INFO

Il server.cfg è il file di configurazione principale del server. Imposta endpoint, license key, convars, e ordine di avvio delle risorse.

ObiettivoDettagli
Cosa imparerai• Strutturare un server.cfg completo
• Configurare port, license key, endpoint
• Impostare convars di base
• Ordinare correttamente l’avvio delle risorse
Prerequisiti• Server FXServer avviato (nota 02)
• License key e nome server

Struttura di Base

# ==========================
# SERVER NAME
# ==========================
sv_hostname "Il Mio Server RP"
sets sv_projectName "My Community"
sets sv_projectDesc "Server roleplay italiano"
gametype "RP"
mapname "Los Santos"
 
# ==========================
# NETWORK
# ==========================
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_licenseKey "cfxk_XXXX"
 
# ==========================
# ONE SYNC (vedi nota 04)
# ==========================
onesync on
 
# ==========================
# SERVER ICON
# ==========================
load_server_icon "server.png"
 
# ==========================
# RESOURCES (ordine!)
# ==========================
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_target
ensure ox_inventory
ensure chat
ensure spawnmanager
ensure mapmanager

Endpoint e Porte

ConvarRuolo
endpoint_add_tcpPorta TCP (sincronizzazione client)
endpoint_add_udpPorta UDP (traffico di gioco)
sv_maxclientsMax giocatori (1–2048)

WARNING

La porta default è 30120. Se la cambi, devi aggiornare anche firewall/NAT sul router o VPS. sv_maxclients sopra 64 richiede onesync on.

Ordine di Avvio delle Risorse

L’ordine è critico: ogni risorsa che dipende da un’altra deve partire dopo. Catena tipica:

1. oxmysql        ← Database
2. ox_lib         ← Libreria UI condivisa
3. Framework      ← es_extended / qb-core / ox_core
4. ox_target      ← Interazioni (prima di ox_inventory)
5. ox_inventory   ← Inventario
6. Altre risorse  ← Script, mappe, sistema

TIP

Usa ensure (non start) per le risorse che devono ripartire dopo un restart. In txAdmin, l’ordine si gestisce dal pannello oppure direttamente nel server.cfg.

Convars di Base

ConvarDefaultDescrizione
sv_pureLevel1Blocca file client modificati (1=audio/graph mod ok, 2=tutto bloccato)
sv_scriptHookAllowedfalseTienilo false — consente Script Hook V, insicuro
sv_endpointPrivacytrueNasconde gli IP nelle segnalazioni
sv_authMinTrust1Fiducia minima dell’autenticazione
sv_requestParanoia0Blocca flood HTTP (usa 1-2 se attaccato)

WARNING

sv_scriptHookAllowed true è un grave rischio di sicurezza. Abilita cheat che usano Script Hook V. Lascialo false sempre.

Convars per GTA V Enhanced (gen9)

Se usi il client GTA V Enhanced, aggiungi:

# Build del gioco da far usare ai client
sv_enforceGameBuild 3407

TIP

sv_enforceGameBuild costringe i client a usare una build specifica. I server RP mantengono la build che meglio supporta i loro mod. Aggiorna quando serve per restare compatibile.

Template Completo Consigliato

sv_hostname "Il Mio Server"
sets sv_projectName "My Community"
sets sv_projectDesc "Server roleplay italiano"
gametype "RP"
mapname "Los Santos"
load_server_icon "server.png"
 
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_licenseKey "cfxk_XXXX"
 
onesync on
 
sv_pureLevel 1
sv_scriptHookAllowed false
sv_endpointPrivacy true
 
# Framework + librerie
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_target
ensure ox_inventory
 
# Risorse di base
ensure chat
ensure spawnmanager
ensure mapmanager
 
# Le tue risorse
ensure my_server_core
ensure my_custom_map
ensure my_weapon_resource

Verifica

  • Porta 30120 aperta su firewall/NAT
  • License key valida (nessun errore “invalid license” nel log)
  • Risorse si avviano senza errori
  • onesync on presente per >64 slot o se richiesto dal framework
  • sv_scriptHookAllowed false

TIP

Prossimo passo: 04 - OneSync

Torna alla: Indice Generale