Come creare un server FiveM

Cosa ti serve prima di iniziare

FiveM è il framework di modifica che alimenta il multiplayer personalizzato di GTA V. Il software del server (FXServer) è gratuito; i giocatori entrano dal client gratuito di FiveM, ma ognuno di loro ha bisogno di una copia legittima di GTA V. Prima di costruire qualsiasi cosa, prepara questi elementi:

• Un account Cfx.re e una chiave di licenza del server. Gratuita dal keymaster e necessaria per avviare il server. La vediamo nel prossimo passo.
• Una macchina che resta accesa. FiveM deve girare senza sosta su una connessione pubblica. Un PC da gaming di riserva va bene per una prova in LAN, ma una vera community ha bisogno di una macchina Linux permanente o di un hosting: più avanti spieghiamo perché.
• Una decisione sul framework. La maggior parte dei server usa ESX o QBCore (lavori, denaro, inventario per il roleplay); i server freeroam e di corse spesso restano più vicini allo standalone. Puoi cambiare idea in seguito.
• Un po' di tempo. Metti in conto un'ora per il tuo primo avvio self-hosted; un server gestito è pronto in pochi minuti.

FiveM è più pesante della maggior parte dei server di gioco: la RAM e la velocità della CPU su singolo thread decidono quanto gira in modo fluido, molto più del semplice numero di giocatori. Un server leggero o vanilla si accontenta di 6 GB; un server ESX/QBCore attivo con 30-80 risorse vuole 8 GB; un server di roleplay affollato con oltre 200 risorse, MLO personalizzati e veicoli in streaming ha bisogno di 12-16 GB.

Passo 1: Ottieni la tua chiave di licenza Cfx.re gratuita

Ogni server FiveM ha bisogno di una chiave di licenza. È gratuita e richiede due minuti.

1. Accedi al keymaster. Vai su keymaster.fivem.net e accedi con il tuo account Cfx.re (quello del forum).
2. Registra una nuova chiave del server. Scegli un'etichetta, seleziona "I will run the server on a dedicated machine" (va bene anche per l'hosting) e inserisci l'IP dove girerà il server, oppure genera una chiave portatile se il tuo IP può cambiare.
3. Copia la chiave. La incollerai in server.cfg come sv_licenseKey nei passaggi successivi.

Strada A: Self-hosting di FiveM con FXServer e txAdmin

Questa è la strada completa, a software libero. Il FXServer moderno si avvia direttamente in txAdmin, un pannello web che configura e gestisce il server al posto tuo, quindi la maggior parte del lavoro avviene nel browser. Questi passaggi sono per una macchina Linux (la scelta realistica per un server pubblico); su Windows si segue lo stesso schema con l'artifact per Windows.

1. Scarica gli artifacts di FXServer. Prendi l'ultima build consigliata dalla pagina degli artifacts di FiveM (Linux o Windows) e scompattala in una cartella vuota: questo è il runtime del server.
2. Procurati le risorse di base. Clona i dati di partenza ufficiali accanto agli artifacts, così il server ha una base di risorse da caricare:

   git clone https://github.com/citizenfx/cfx-server-data.git server-data

3. Avvia FXServer per aprire txAdmin. Dalla cartella degli artifacts, esegui il server puntando a una cartella di dati. Si apre txAdmin e viene mostrato un PIN monouso e un indirizzo web (porta predefinita 40120):

   ./run.sh +set serverProfile default +set txAdminPort 40120

   Apri quell'indirizzo in un browser, inserisci il PIN e crea il tuo account amministratore.
4. Esegui il deployer di configurazione. In txAdmin, avvia un nuovo deployment: puntalo al tuo server-data, incolla la tua chiave di licenza Cfx.re del Passo 1 e lascia che costruisca il tuo server.cfg. Imposta il nome del server, sv_maxclients (fino a 32 con la chiave gratuita) e una connessione al database se il tuo framework ne ha bisogno.
5. Conferma gli endpoint e la licenza. Il tuo server.cfg dovrebbe contenere l'essenziale: txAdmin se ne occupa, ma vale la pena sapere cosa scrive:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"
   sv_licenseKey "your_key_here"
   sv_hostname "My FiveM Server"
   sv_maxclients 32
   ensure mapmanager
   ensure chat
   ensure spawnmanager
   ensure sessionmanager

6. Apri la porta 30120. FiveM usa la porta 30120 sia in TCP che in UDP. Su una connessione domestica, accedi al router, trova la sezione Port Forwarding e inoltra TCP e UDP 30120 verso la macchina che esegue il server (assegnale prima un IP locale statico).
   Attenzione: aprire una porta rende pubblico l'IP di casa tua, e i server FiveM sono un bersaglio preferito degli attacchi. Un singolo booter può mettere offline tutta la tua rete domestica, e una linea di casa non ha nulla davanti a sé. Fai self-hosting pubblico solo se sei consapevole di questo rischio.

   

Questo è un server funzionante. Prima di renderlo permanente, valuta quanto ti costa davvero il self-hosting:

Strada B: Noleggia un server FiveM gestito (online in pochi minuti)

Un server gestito è lo stesso FXServer che gira in un datacenter invece che a casa tua: sempre acceso, dietro una vera protezione DDoS, con txAdmin e gli ultimi artifacts già pronti. Tutto ciò che è macchinoso nella Strada A (artifacts, endpoint, tenere la macchina sveglia) è già risolto. Ecco l'intera configurazione:

1. Scegli una dimensione. Nella pagina di hosting FiveM, scegli un piano in base alla RAM: 6 GB per un server leggero o iniziale, 8 GB per una community ESX/QBCore attiva, 12-16 GB per il roleplay impegnativo. I piani partono da pochi euro al mese e ognuno include un database MySQL.
2. Completa l'ordine. Il server viene predisposto automaticamente pochi minuti dopo il pagamento: FXServer, txAdmin e gli ultimi artifacts di FiveM vengono installati per te. I dati del tuo pannello arrivano via email.
3. Apri txAdmin. Accedi al pannello, incolla la tua chiave di licenza Cfx.re del Passo 1, imposta il nome del server e gli slot, e avvia il server. Non c'è nulla da scaricare e nessuna porta da aprire.
4. Aggiungi il tuo framework. Carica o installa ESX o QBCore tramite il file manager o via SFTP, collegalo al database incluso e attivalo con ensure nella tua configurazione: il pannello rende l'accesso al database e ai file un'operazione da un clic.
5. Invita i giocatori. Condividi il tuo indirizzo così le persone possono fare connect dal client FiveM, oppure distribuisci il tuo link di join cfx.re. Gli amici che ti aiutano a gestire il server possono avere il proprio accesso come sotto-utente del pannello invece della tua password.

Cosa stai pagando, in concreto: il server resta online con un obiettivo del 99,9% di uptime che il tuo PC sia acceso o meno, la protezione DDoS Voxility da oltre 1 Tbps assorbe attacchi che stenderebbero una linea domestica, i file risiedono su NVMe SSD con CPU ad alta frequenza (la velocità su singolo thread di cui vive FiveM), i nodi nell'UE tengono basso il ping in Romania, Moldavia e nei Balcani, e il supporto via live chat è disponibile dalle 8:00 alle 23:00 (ora di Chișinău). Migrare un server esistente è gratis.

Framework e risorse: ESX, QBCore e aggiungere script

Un server FiveM spoglio è una città vuota. I framework e le risorse sono ciò che lo trasformano in un mondo di roleplay, un server di drift o un campionato di corse.

• ESX — il framework di roleplay più consolidato: lavori, denaro, inventario e un'enorme libreria di script della community. Maturo e ampiamente documentato.
• QBCore — il favorito moderno per i nuovi server di roleplay, in sviluppo attivo, con una struttura pulita e un vasto ecosistema di lavori e sistemi già pronti.
• Standalone — nessun framework. Ideale per server freeroam, di corse o di minigiochi che non hanno bisogno di denaro e lavori.

Aggiungere una risorsa segue sempre lo stesso schema: metti la cartella della risorsa nella directory resources/ del tuo server, poi caricala in server.cfg con una sola riga:

ensure resource-name

Riavvia il server (oppure aggiorna e avvia la risorsa da txAdmin) ed è attiva. I framework che memorizzano dati — denaro, personaggi, veicoli — hanno bisogno di un database MySQL e della risorsa oxmysql per comunicare con esso, ed è esattamente per questo che un database è incluso nei nostri piani FiveM.

Mantieni il server online e al sicuro

Poche cose separano un server FiveM che dura da uno che muore nella sua prima settimana:

• Prendi sul serio il DDoS. I server FiveM vengono attaccati di continuo, soprattutto quelli di roleplay competitivo. Una connessione domestica non ha protezione; l'hosting in datacenter mette un filtraggio dedicato (Voxility, nel nostro caso) tra internet e il tuo server.
• Fai il backup del database e delle risorse. Il tuo database MySQL contiene ogni personaggio, lavoro e veicolo: è l'unica cosa che non puoi riscaricare. Fanne uno snapshot prima di aggiungere o aggiornare una risorsa importante.
• Conosci il tuo limite reale di slot. sv_maxclients si può impostare più alto, ma la chiave gratuita Cfx.re ti limita comunque a 32 giocatori: aumentalo solo dopo aver potenziato la tua chiave Element Club.
• Tieni gli artifacts aggiornati, ma non all'ultimissima versione. Attieniti alle build di artifacts consigliate; quelle appena uscite possono rompere le risorse. Nei piani gestiti ci pensiamo noi.