Questa guida tratta le soluzioni ai problemi più comuni dei server FiveM — problemi di accesso a TXAdmin, errori della chiave di licenza CFX, errori di connessione al database, crash del server, problemi di connessione dei giocatori e risorse che non si caricano. Per la configurazione iniziale del server, consulta la Guida alla Configurazione del Server FiveM.
Consiglio generale per la risoluzione dei problemi: Controlla sempre prima l'output della console di GPanel e i log di TXAdmin. La maggior parte degli errori produce un messaggio chiaro che indica la causa.
TXAdmin Non si Carica o è Inaccessibile
- Verifica che il server sia in esecuzione in GPanel — TXAdmin si avvia solo quando il processo del server FiveM è attivo.
- Controlla la console di GPanel per l'URL e la porta di TXAdmin. La porta di TXAdmin è diversa dalla porta di gioco.
- Assicurati di usare
http://e nonhttps://— TXAdmin non usa SSL per impostazione predefinita. - Se TXAdmin funzionava prima ma smette di caricarsi, prova a riavviare il server da GPanel.
- Svuota la cache del browser o prova una finestra in incognito/privata.
Hai perso la password di TXAdmin? Se non riesci ad accedere, potresti dover eliminare i dati del profilo TXAdmin e rieseguire la procedura guidata di configurazione. Controlla la scheda Files di GPanel per la directory dati di TXAdmin e rimuovi i suoi file di profilo, poi riavvia il server.
Errori della Chiave di Licenza CFX
| Messaggio di Errore | Causa | Soluzione |
|---|---|---|
Invalid license key |
Chiave copiata in modo errato o spazi extra | Vai su Keymaster, conferma che la chiave sia attiva e ricopiala con attenzione. Incollala sia nella variabile Startup di GPanel che in sv_licenseKey nel server.cfg. |
License key already in use |
La chiave è registrata su un IP di server diverso | Ogni chiave può essere usata su un solo server alla volta. Revoca la vecchia chiave su Keymaster e generane una nuova con l'IP del tuo server attuale. |
Unable to verify license key |
I server di autenticazione Cfx.re sono temporaneamente non disponibili | Attendi qualche minuto e riavvia il server. Controlla status.cfx.re per eventuali interruzioni. |
Consiglio: Assicurati che la chiave sia impostata sia nella variabile Startup di GPanel sia in
server.cfg (sv_licenseKey). A seconda della configurazione, il server potrebbe leggere dall'una o dall'altra.
Errori di Connessione al Database
| Messaggio di Errore | Causa | Soluzione |
|---|---|---|
Connection refused o ETIMEDOUT |
Indirizzo host o porta del database errati | Ricontrolla l'indirizzo host e la porta del database dalla scheda Databases di GPanel. Non usare localhost o 127.0.0.1. |
Access denied |
Nome utente o password errati | Copia le credenziali direttamente da GPanel per evitare errori di battitura. Le password sono sensibili alle maiuscole/minuscole. |
Unknown database |
Il nome del database non corrisponde | Assicurati che il nome del database nella stringa di connessione corrisponda esattamente a quello mostrato in GPanel. |
Ulteriori passaggi per la risoluzione dei problemi del database:
- Se usi oxmysql, assicurati di avere la risorsa
oxmysqlnella cartellaresources/e cheensure oxmysqlappaia in server.cfg prima di qualsiasi risorsa che richiede un database. - Se la tua password contiene caratteri speciali come
@,#o%, codificali in formato URL nella stringa di connessione (es.@diventa%40). - Verifica che la stringa di connessione non contenga caratteri mancanti o in eccesso — anche un singolo carattere fuori posto causerà un errore.
Non usare localhost. Il server del database è separato dal server di gioco. Usa sempre l'indirizzo host completo mostrato nella scheda Databases di GPanel.
Crash del Server all'Avvio
- Controlla la console di GPanel per messaggi di errore. Le cause comuni includono un
server.cfgmancante o mal configurato, una chiave di licenza CFX non valida o una risorsa difettosa. - Prova a disabilitare le risorse personalizzate commentandole in server.cfg (aggiungi
#prima di ogni rigaensure) e riavvia. Aggiungile di nuovo una alla volta per identificare la risorsa problematica. - Assicurati che le porte in
endpoint_add_tcpeendpoint_add_udpcorrispondano alla porta assegnata in GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Ricerca binaria per risorse difettose: Se hai molte risorse, commentane metà alla volta anziché una per una. Questo restringe il problema molto più velocemente.
I Giocatori Non Riescono a Connettersi
- Conferma che il server mostri Running in GPanel.
- Verifica l'IP e la porta — i giocatori devono usare la porta di gioco, non la porta di TXAdmin.
- Controlla che
sv_maxclientsnon sia impostato su 0 o su un numero irragionevolmente basso. - Se usi una password del server (
sv_passwordin server.cfg), assicurati che i giocatori la conoscano. - I giocatori devono avere il client FiveM installato — non possono connettersi usando il launcher standard di GTA V.
- Controlla la scheda Network di GPanel e conferma che le porte in
endpoint_add_tcpeendpoint_add_udpcorrispondano. Una discrepanza impedirà le connessioni.
Il server non appare nel browser? I nuovi server possono impiegare 5-15 minuti per apparire nella lista dei server FiveM. Usa la connessione diretta (
IP:PORT) nel frattempo. Verifica inoltre che il tuo sv_licenseKey sia valido.
Le Risorse Non si Caricano
- Controlla che la cartella della risorsa sia all'interno della directory
resources/(o di una sottocartella appropriata). - Verifica che il nome della cartella corrisponda esattamente alla riga
ensurein server.cfg (sensibile alle maiuscole/minuscole). - Ogni risorsa deve contenere un file
fxmanifest.luavalido (o il più vecchio__resource.lua). Se questo file manca, la risorsa non verrà caricata. - Controlla la console di TXAdmin o GPanel per messaggi di errore relativi alla risorsa. Gli errori comuni includono dipendenze mancanti o errori di sintassi Lua.
- Se la risorsa richiede un framework (ESX, QBCore), assicurati che il framework sia caricato prima della risorsa in server.cfg.
- Se la risorsa richiede un database, assicurati che la tua risorsa MySQL (oxmysql, mysql-async) sia caricata e che la connessione al database funzioni.
Controlla la struttura delle cartelle. Un errore comune è caricare una risorsa e ritrovarsi con una cartella doppiamente annidata come
resources/my-resource/my-resource/fxmanifest.lua. Il manifesto deve trovarsi direttamente all'interno della cartella della risorsa: resources/my-resource/fxmanifest.lua.
Problemi di Prestazioni del Server
- Apri TXAdmin e controlla la Dashboard per le metriche di prestazione (tick time, numero di giocatori, utilizzo della memoria).
- Un server FiveM sano dovrebbe mantenere un tick time del server (chiamato anche "hitch") inferiore a 20ms. Picchi costanti superiori a questo valore indicano che una risorsa sta usando troppo tempo di elaborazione.
- Usa la pagina Resources di TXAdmin per identificare quali risorse stanno consumando più tempo del server.
- Rimuovi o sostituisci le risorse scarsamente ottimizzate. Le risorse gratuite da fonti sconosciute sono spesso la causa dei problemi di prestazioni.
- Riduci il numero di risorse caricate se i limiti di memoria o CPU del tuo piano server vengono raggiunti.
Ottenere Aiuto
Se hai provato le soluzioni sopra indicate e riscontri ancora problemi:
- Copia il messaggio di errore completo dalla console di GPanel o dal log di TXAdmin.
- Prendi nota dei passaggi di risoluzione che hai già provato.
- Apri un ticket di supporto su https://legionhosting.net/submitticket.php con queste informazioni. Il nostro team ti assisterà il più rapidamente possibile.
