Come installare txAdmin e creare il tuo server FiveM (tutorial completo)

Quasi tutti i server FiveM attivi oggi sono stati creati con txAdmin — il pannello di controllo web incluso nella build ufficiale del server. Gestisce deploy, riavvii, ban, console e il tuo server.cfg da una scheda del browser, e ti installa una base completa di ESX o QBCore in pochi clic.

Questo tutorial va da una cartella vuota a un server in cui i tuoi amici possono entrare, spiegando perché ogni passaggio conta — non solo dove cliccare.

Cosa ti serve prima di iniziare

• Una macchina su cui farlo girare — il tuo PC per le prove, o un host/VPS per qualsiasi cosa pubblica.
• Un account Cfx.re gratuito per la licenza.
• MySQL o MariaDB — ogni framework serio ha bisogno di un database.
• Circa 45 minuti.

Su Windows, installa prima il Microsoft Visual C++ Redistributable (x64). FXServer non parte senza, e l’errore che mostra è criptico — questa singola dipendenza mancante causa buona parte dei post “si chiude subito”.

Su Linux ti serve xz-utils per estrarre la build, più un server MySQL/MariaDB.

Passo 1 — Ottieni la licenza Cfx.re

Vai su keymaster.fivem.net, accedi con il tuo account Cfx.re (quello del forum) e registra una nuova chiave server.

• Scegli “I’m using a server hosting provider” o un IP fisso se lo conosci — si può cambiare dopo.
• Copia la chiave in un posto sicuro. È una lunga stringa casuale.

Questa chiave identifica il tuo server verso Cfx.re. Trattala come una password: mai in uno screenshot su Discord, mai su GitHub. Una chiave trapelata può finire usata da altri e far revocare la tua.

Passo 2 — Scarica gli artifacts

Gli artifacts sono la build vera del server (FXServer). Scaricali dal runtime ufficiale:

• Windows — runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux — runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Prendi la build indicata come recommended, non la più nuova in cima. Gli artifacts dell’ultima ora rompono spesso le risorse, e quella consigliata è quella su cui gli sviluppatori testano davvero. La seguiamo nella nostra guida agli artifacts.

Estraila in una cartella dedicata — per esempio C:\FXServer\server\ su Windows, o /home/fivem/server/ su Linux.

Passo 3 — Imposta la struttura delle cartelle

Tieni la build e i tuoi dati del server in cartelle separate. È la migliore abitudine con cui puoi partire: aggiornare gli artifacts diventa “cancella e sostituisci una cartella” invece di un intervento chirurgico tra i tuoi file.

C:\FXServer\
├── server\          <- gli artifacts estratti (sostituibili)
└── server-data\     <- le tue risorse, server.cfg, dump del database

Quando aggiornerai FiveM tra sei mesi, cancelli server\, estrai la build nuova, e tutto ciò che è davvero tuo resta intatto.

Passo 4 — Avvia il server per la prima volta

Esegui il binario:

• Windows — doppio clic su FXServer.exe dentro server\.
• Linux — entra nella cartella ed esegui ./run.sh.

Si apre una console e txAdmin parte. Vedrai qualcosa così:

[txAdmin] Starting txAdmin v7.x.x
[txAdmin] Web UI: http://localhost:40120
[txAdmin] PIN: 4821

Apri quell’URL nel browser e inserisci il PIN.

Passo 5 — Crea l’account master

txAdmin ti chiede di creare l’account master — l’admin di livello più alto che nessun altro admin può rimuovere.

Usa una password vera, non admin123. Questo pannello può eseguire comandi di console sul tuo server: chi ci arriva possiede la tua community. Volendo puoi collegare un’identità Cfx.re o Discord per accedere più comodamente.

L’hai persa? Ferma il server e avvialo una volta con --resetadmin:

FXServer.exe --resetadmin

Passo 6 — Prepara il database

Prima che parta il deployer, tieni pronto MySQL/MariaDB. Su Windows la via consueta è XAMPP o un’installazione MariaDB a sé; su Linux, mariadb-server dal gestore pacchetti.

Crea un database vuoto (per esempio fivem) e un utente con tutti i permessi su di esso. Al passo successivo darai a txAdmin una stringa di connessione in questa forma:

mysql://utente:password@localhost/fivem?charset=utf8mb4

Usa un utente dedicato, non root, e dagli una password vera. Il database di un framework finisce per contenere i personaggi, i soldi e l’inventario di ogni giocatore — è l’unica cosa che davvero non puoi ricostruire.

Passo 7 — Installa un framework con il deployer di ricette

Ecco la parte che rende txAdmin prezioso. La pagina di setup offre vari tipi di deploy; scegli ricette popolari, poi la tua base:

• ESX — l’ecosistema più grande; il più facile per trovare script, tutorial e staff che lo conosce.
• QBCore — moderno e orientato al roleplay.
• Qbox — una continuazione di QBCore focalizzata sulle prestazioni.

Indeciso? Leggi il nostro confronto ESX vs QBCore vs Qbox prima di impegnarti — migrare dopo è lavoro vero.

Poi txAdmin chiede:

1. Un nome server e la cartella dati (server-data\).
2. La tua stringa di connessione del passo 6.
3. La tua licenza del passo 1.

Avvia il deploy. txAdmin scarica il framework, importa l’SQL, scrive un server.cfg funzionante e avvia il server. Guarda il log: se qualcosa fallisce, ti dice esattamente quale pezzo.

Passo 8 — Controlla il tuo server.cfg

La ricetta scrive una configurazione funzionante, ma dovresti capire cosa contiene. txAdmin ha un editor integrato (Settings → CFG Editor), quindi non serve toccare i file via FTP per modifiche piccole.

Le righe che contano di più:

sv_hostname "Il mio server roleplay"
sv_maxclients 48
sv_licenseKey "la-tua-chiave-qui"

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

# OneSync — necessario oltre i 32 giocatori
set onesync on
sv_enforceGameBuild 3095

Due cose che si imparano a proprie spese:

• sv_maxclients non è una strategia di crescita. Parti da 32–48. Un server vuoto da 128 slot sembra morto; uno pieno da 48 sembra vivo.
• sv_enforceGameBuild fissa la build di GTA che il server si aspetta. Cambiala solo quando una risorsa ha davvero bisogno di contenuti DLC più recenti, e metti in conto di ritestare tutto.

Passo 9 — Apri le porte giuste

I giocatori si connettono sulla 30120, TCP e UDP. Se apri solo il TCP, il server compare in lista ma nessuno riesce a entrare — il classico che costa un pomeriggio.

Non esporre mai la 40120 pubblicamente. Se ti serve accesso remoto, mettila dietro una VPN o un reverse proxy con HTTPS e password robusta. Un pannello txAdmin aperto su internet è una console remota completa del tuo server, e i bot lo cercano.

Passo 10 — Impara a usare il pannello

Dedicaci dieci minuti; si ripagano da soli:

• Dashboard — grafico delle prestazioni in tempo reale. Quando i giocatori dicono “lagga”, qui lo confermi.
• Live Console — la vera console del server nel browser. Leggila dall’alto in basso e correggi sempre il primo errore rosso; il resto di solito è conseguenza.
• Players — cercare, avvisare, espellere, bannare e vedere lo storico per identificatore.
• Restarter — riavvii programmati. Impostali dal primo giorno (vedi sotto).
• CFG Editor — modificare server.cfg senza FTP.
• Bot Discord — opzionale; messaggi di stato e whitelist tramite ruoli.

Imposta subito i riavvii programmati

In Settings → Restarter, programma riavvii ogni 6–12 ore. Un FXServer acceso da molto tempo accumula memoria e degrada piano piano, e un riavvio programmato con conto alla rovescia è invisibile ai giocatori. Un crash imprevisto nell’ora di punta no.

Passo 11 — Aggiungi le prime risorse

Con il framework attivo, le risorse vanno in server-data/resources/, ognuna attivata con una riga ensure. L’ordine conta — le dipendenze partono per prime:

# Nucleo — questi per primi
ensure oxmysql
ensure ox_lib
ensure es_extended

# Gameplay
ensure mio-inventario
ensure mio-hud

Aggiungi le risorse una alla volta, riavviando tra una e l’altra. Se ne butti dentro quindici e il server muore, hai quindici sospettati. Una alla volta, sai sempre esattamente cosa l’ha rotto.

I sistemi che i giocatori notano per primi sono l’inventario e l’HUD — sono sullo schermo di continuo, quindi definiscono come si sente il tuo server più di qualsiasi script di lavoro. La nostra guida ai migliori inventari FiveM confronta le opzioni; se ne vuoi uno che copra ESX, QB, QBCore e Qbox da un’unica base di codice, Quasar Inventory è il tuttofare rifinito a cui continuiamo a tornare nei test. Per l’installazione passo passo, segui il nostro tutorial di installazione dell’inventario.

Passo 12 — Prova per bene, poi apri

Connettiti in locale con connect localhost dal client FiveM (console F8), poi fai entrare un amico dal tuo indirizzo pubblico.

Percorri tutto il ciclo prima di annunciare qualsiasi cosa: spawn, prendere un lavoro, guadagnare, aprire l’inventario, riporre un oggetto, comprare e ritirare un’auto, rifare il login e verificare che tutto sia rimasto. Il relog è la prova vera — la maggior parte dei “il mio server perde i dati dei giocatori” è un problema di database che salta fuori solo alla riconnessione.

Fai il backup del database — txAdmin non lo fa per te

È la lacuna più comune in server per il resto ben gestiti. txAdmin gestisce il tuo server; non fa il backup del tuo database. Predisponi il tuo dump programmato:

mysqldump -u fivem -p fivem > backup-$(date +%F).sql

Automatizzalo (cron o Utilità di pianificazione) e tieni le copie fuori dalla macchina. Un server che ricostruisci in un pomeriggio è una seccatura. Un database che non puoi ripristinare è la fine della community.

Risoluzione dei problemi

Dove andare adesso

Ora hai un server funzionante, riavviabile e con backup. Le due cose che decidono se i giocatori restano sono le prestazioni e un ciclo di gioco coerente — non quanti script hai.

Leggi la nostra guida all’ottimizzazione prima della tua prima serata affollata, e come ridurre il lag quando arriverà, perché arriverà. Poi chiudi le porte: la nostra guida alla sicurezza copre cosa irrobustire prima che valga la pena attaccarti.