Creare un server FiveM: licenza, txAdmin e risorse

Un server FiveM dà vita a una community roleplay su GTA V, con regole, script e veicoli propri. Prima di invitare i giocatori, servono tre elementi: una chiave di licenza valida, uno strumento di amministrazione e un elenco di risorse sotto controllo.

• Un server FiveM richiede una chiave di licenza gratuita, creata sul portale Cfx.re.
• txAdmin, incluso in FiveM, gestisce ricette, riavvii pianificati e moderazione.
• Ogni risorsa va caricata in resources, poi dichiarata con ensure in server.cfg.
• Aggiunga gli script uno alla volta e legga la console dopo ogni riavvio.

Cosa serve prima di iniziare

FiveM è la piattaforma multigiocatore di Cfx.re per GTA V. Ogni giocatore deve possedere il gioco su PC e il server ha bisogno di una chiave di licenza. La chiave è gratuita: si crea con il proprio account sul portale Cfx.re. Occorre anche un database MySQL o MariaDB se si intende usare un framework roleplay.

• Un account Cfx.re per creare la chiave di licenza del server.
• GTA V su PC per ogni giocatore.
• Un database MySQL o MariaDB per ESX, QBCore o Qbox.
• Un nome per il server, una descrizione e regole chiare.

Creare e inserire la chiave di licenza

Sul portale Cfx.re, crei una chiave per il server e la associ al suo indirizzo se il modulo lo richiede. Nel pannello, la chiave va inserita nei parametri di avvio (sv_licenseKey) prima di lanciare il server la prima volta: senza di essa il server non si avvia. La guida per configurare una chiave di licenza o un token descrive ogni passaggio.

• Copi la chiave per intero, senza spazi né virgolette.
• Riavvii il server e legga la console: un errore di token indica una chiave non valida o associata a un altro indirizzo.
• Non pubblichi mai la chiave in uno screenshot o in un repository pubblico.

txAdmin, l’interfaccia di amministrazione

txAdmin è incluso in FiveM. Questa interfaccia web serve a installare una ricetta del server (una base pronta all’uso con il relativo framework), a pianificare i riavvii, a seguire i giocatori connessi e a gestire i ban. Completa la console, il file manager e i parametri di avvio del pannello ACLClouds, senza sostituirli.

• Ricette: un’installazione di partenza con ESX, QBCore o un server vuoto.
• Riavvii pianificati, con avvisi inviati ai giocatori.
• Moderazione: avvertimenti, espulsioni e ban dal browser.
• Gestione degli amministratori, con permessi per ogni membro del team.

Aggiungere risorse senza compromettere il server

Una risorsa è una cartella che contiene un manifest (fxmanifest.lua) e i relativi script Lua, JavaScript o C#. La carichi nella cartella resources con il file manager, poi la dichiari in server.cfg con una riga ensure. L’ordine conta: una risorsa deve avviarsi dopo quelle da cui dipende, a cominciare dal framework e dalla connessione al database.

• Una risorsa alla volta, con un riavvio e una lettura della console dopo ogni aggiunta.
• Script provenienti da fonti note, compatibili con la versione del framework in uso.
• Una copia di server.cfg prima di ogni modifica importante.

Mantenere il server stabile

La maggior parte dei guasti deriva da uno script incompatibile, da una dipendenza mancante o da un database irraggiungibile. La console del pannello mostra questi errori all’avvio: legga il primo, non l’ultimo. Esegua il backup dei file e del database e conservi una copia fuori dal server, come raccomanda la regola dei backup 3-2-1. Quando giocatori e script aumentano, confronti le offerte FiveM e passi a un piano con più RAM e vCPU.

• Leggere il primo errore della console dopo un avvio fallito.
• Eseguire il backup dei file e del database prima di ogni aggiornamento.
• Cambiare piano quando memoria o CPU si saturano nelle ore di punta.
• Protezione anti-DDoS inclusa su ogni server di gioco ACLClouds.