Questa guida ti accompagna nella configurazione del tuo server FiveM (multiplayer GTA V) ospitato con Legion Hosting — dall'ottenimento della chiave di licenza CFX e la configurazione di TXAdmin, alla modifica di server.cfg e alla connessione dei giocatori.

Prerequisiti

• Un server FiveM Legion Hosting (attivo nel tuo account)
• Un account sul forum Cfx.re (gratuito — necessario per generare la chiave di licenza)
• Accesso a GPanel
• Client FiveM installato sul tuo PC (fivem.net)

Passaggio 1: Ottenere la Chiave di Licenza CFX

Ogni server FiveM richiede una chiave di licenza unica da Cfx.re (gli sviluppatori di FiveM). Questa chiave è gratuita e legata al tuo account Cfx.re.

1. Vai su https://keymaster.fivem.net/ e accedi con il tuo account del forum Cfx.re.
2. Clicca New Server (o Register a new server).
3. Compila i dettagli:
   • Label: Un nome descrittivo per il tuo server (es. "My Legion FiveM Server")
   • Server IP Address: Inserisci l'indirizzo IP del tuo server da GPanel (vedi Come Trovare l'IP e la Porta del Tuo Server)
   • Server Type: Seleziona il tipo appropriato (solitamente "Other / Apache / nginx")
4. Clicca Generate.
5. Copia la chiave di licenza generata — ne avrai bisogno nei passaggi successivi.

Passaggio 2: Primo Avvio del Server e Configurazione di TXAdmin

I server FiveM ospitati con Legion Hosting includono TXAdmin — un pannello di gestione web che funziona insieme al tuo server FiveM. Al primo avvio, TXAdmin ti guiderà attraverso la configurazione iniziale.

Avvio del Server

1. Accedi a GPanel e seleziona il tuo server FiveM.
2. Vai alla scheda Startup e individua la variabile FIVEM_LICENSE (o con nome simile). Incolla qui la tua chiave di licenza CFX e salva.
3. Vai alla scheda Console e clicca Start.
4. Osserva l'output della console. Al primo avvio, il server scaricherà gli artifact FiveM necessari — questo può richiedere alcuni minuti.
5. Quando TXAdmin è pronto, vedrai un messaggio nella console contenente l'URL di TXAdmin e un codice PIN.

Completamento della Configurazione di TXAdmin

1. Apri l'URL di TXAdmin nel tuo browser.
2. Inserisci il PIN mostrato nell'output della console di GPanel.
3. Crea il tuo account amministratore TXAdmin (nome utente e password).
4. TXAdmin ti guiderà attraverso una procedura guidata di configurazione:
   • Server Name: Scegli il nome visualizzato nel browser dei server FiveM.
   • Deployment Type: Seleziona un template (es. "Popular Recipes" per una base preconfigurata, o "Remote URL / Template" se hai una configurazione personalizzata).
   • Server Data Folder: Lascia il valore predefinito a meno che tu non abbia un motivo specifico per cambiarlo.
   • CFX Key: Se richiesto nuovamente, incolla la tua chiave di licenza.
5. Completa la procedura guidata e lascia che TXAdmin finisca il deploy dei file del server. Questo potrebbe richiedere alcuni minuti.

Passaggio 3: Configurare server.cfg

Il file server.cfg è il file di configurazione principale del tuo server FiveM. TXAdmin ne genera uno di base durante la configurazione, ma vorrai revisionarlo e personalizzarlo.

Accesso a server.cfg

1. In GPanel, clicca sulla scheda Files.
2. Naviga nella cartella dati del server (tipicamente la directory principale o una cartella creata dal template TXAdmin).
3. Clicca su server.cfg per aprirlo nell'editor integrato.

Impostazioni Essenziali

Un esempio minimo di server.cfg:

# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"

# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"

# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"

# Player Limit
sv_maxclients 48

# Privacy
sv_endpointprivacy true

# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

Passaggio 4: Connettersi al Tuo Server FiveM

Una volta che il tuo server è configurato e in esecuzione, i giocatori possono connettersi usando il browser dei server FiveM o una connessione diretta.

Connessione Diretta

1. Apri il client FiveM.
2. Premi F8 per aprire la console FiveM, oppure clicca il pulsante Direct Connect nella schermata principale.
3. Inserisci l'IP del tuo server e la porta di gioco nel formato IP:PORT.
4. Clicca Connect.

Browser dei Server

1. Apri il client FiveM e clicca Play.
2. Nel browser dei server, cerca il nome del tuo server (il valore sv_hostname da server.cfg).
3. Clicca sul tuo server e poi clicca Connect.

Gestione del Server con TXAdmin

Dopo la configurazione iniziale, TXAdmin fornisce una dashboard web per la gestione quotidiana del server. Accedi tramite http://YOUR_SERVER_IP:TXADMIN_PORT.

Ottenere Aiuto

Se hai seguito questa guida e riscontri ancora problemi:

1. Copia eventuali messaggi di errore dalla console di GPanel o dal log di TXAdmin.
2. Prendi nota del passaggio in cui sei bloccato e di ciò che hai già provato.
3. Apri un ticket di supporto su https://legionhosting.net/submitticket.php con queste informazioni. Il nostro team ti assisterà il più rapidamente possibile.

Articoli Correlati

• Risorse, Script e Configurazione del Database per FiveM
• Risoluzione dei Problemi di FiveM
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File tramite SFTP
• Guida all'Avvio del Server