Guida alla risoluzione dei problemi per le questioni comuni dei server RedM, inclusi errori di chiave di licenza, visibilità nel browser dei server, fallimenti delle risorse, connessioni client, problemi di database e ottimizzazione delle prestazioni. Per le istruzioni di configurazione iniziale, consulta la nostra Guida alla Configurazione del Server RedM.

Errori di Chiave di Licenza

I problemi di chiave di licenza sono il problema più comune quando si avvia un nuovo server RedM. Ecco gli errori tipici e le loro soluzioni:

"Invalid license key" o "Could not authenticate"

Server Non Appare nel Browser

Se il tuo server è in esecuzione ma i giocatori non riescono a trovarlo nel browser dei server RedM:

Checklist

1. Attendi almeno 5 minuti. Dopo l'avvio, il server ha bisogno di tempo per registrarsi nella master server list di Cfx.re. I nuovi server possono impiegare diversi minuti per apparire.
2. Verifica che la chiave di licenza sia valida. Il server non sarà elencato senza una chiave di licenza funzionante. Controlla la console del server per errori relativi alla licenza.
3. Controlla la configurazione degli endpoint. Assicurati che endpoint_add_tcp e endpoint_add_udp in server.cfg utilizzino la porta corretta:

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

   La porta deve corrispondere a quella assegnata in GPanel.
4. Controlla le impostazioni di "sv_master1" o di elencazione. Assicurati di non aver accidentalmente impostato il server per non elencarsi. Non dovrebbe esserci sv_master1 "" nella tua configurazione (questo disabilita la registrazione nella master list).
5. Verifica che il server sia effettivamente in esecuzione. Controlla la console GPanel. Se il server si è bloccato o fermato, non apparirà nel browser.
6. Prova la connessione diretta. Anche se il server non è nel browser, la connessione diretta dovrebbe funzionare. Fai premere F8 a un giocatore in RedM e digitare:

   connect YOUR_SERVER_IP:PORT

Fallimenti nel Caricamento delle Risorse

Gli errori delle risorse sono comuni quando si aggiungono nuovi script o framework al tuo server. Ecco i problemi più frequenti:

"Could not find resource [resource_name]"

• La cartella della risorsa non esiste nella directory resources/, o si trova nella posizione sbagliata.
• Il nome della cartella non corrisponde al nome utilizzato in ensure. I nomi delle risorse sono case-sensitive.
• Soluzione: Verifica che la cartella della risorsa esista e che il nome in server.cfg corrisponda esattamente. Usa il file manager di GPanel o SFTP per controllare.

"Failed to load resource [resource_name]: manifest error"

• Il file fxmanifest.lua o __resource.lua della risorsa ha un errore di sintassi.
• Il manifest fa riferimento a file che non esistono nella cartella della risorsa.
• Soluzione: Apri il file manifest e controlla eventuali errori di battitura, virgole mancanti o riferimenti a file inesistenti. Controlla la console del server per il numero di riga specifico dell'errore.

"Error loading script [filename]: [error details]"

• Un file Lua, C# o JavaScript all'interno della risorsa ha un errore di sintassi o runtime.
• Soluzione: Leggi il messaggio di errore completo nella console. Includerà il nome del file e il numero di riga. Le cause comuni includono:
  • Dipendenze mancanti (un'altra risorsa che deve essere caricata per prima)
  • Risorsa obsoleta non compatibile con la versione attuale del server RedM
  • Valori di configurazione errati nel file di configurazione della risorsa

Problemi di Ordine di Caricamento delle Risorse

Le risorse in server.cfg vengono caricate nell'ordine in cui appaiono. Se una risorsa dipende da un'altra (es. vorp_inventory dipende da vorp_core), la dipendenza deve essere elencata per prima:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

Problemi di Connessione del Client

Quando i giocatori non riescono a connettersi al tuo server:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Password del server: Se sv_password è impostata, il giocatore deve inserire la password corretta.
• Risorsa di whitelist/allowlist: Se hai una risorsa di whitelist abilitata, il giocatore deve essere approvato prima di connettersi.
• Ban: Il giocatore potrebbe essere bannato. Controlla la tua lista dei ban o il database per i suoi identificatori.

Il client si blocca alla connessione

• Una risorsa sul server sta inviando dati non validi o ha un errore di script lato client che blocca il client.
• Soluzione: Disabilita le risorse aggiunte di recente una alla volta per identificare quella problematica. Controlla la console del server per errori durante la connessione del client.
• Assicurati che il client RedM del giocatore sia aggiornato.

Errori "Could not download file"

• Il server sta tentando di inviare un file di grandi dimensioni (es. un asset di streaming) che supera i limiti di trasferimento o la connessione è instabile.
• Soluzione: Riduci la dimensione degli asset in streaming, usa un CDN/hosting esterno per i file di grandi dimensioni se supportato, o fai riprovare la connessione al giocatore.

Problemi di Database (MySQL / oxmysql)

La maggior parte dei framework di roleplay RedM utilizza MySQL per l'archiviazione persistente dei dati. Il connettore di database più comune è oxmysql.

Errori di Connessione Fallita

Se oxmysql (o un altro connettore MySQL) non riesce a connettersi, controlla quanto segue:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

Tabelle Mancanti o Errori di Schema

I framework di roleplay spesso richiedono che le tabelle del database siano impostate prima di poter funzionare:

1. Controlla la documentazione del framework o il repository GitHub per file di importazione SQL (spesso denominati database.sql, schema.sql o simili).
2. Importa il file SQL nel tuo database utilizzando phpMyAdmin o un client MySQL.
3. Alcuni framework creano automaticamente le tabelle al primo avvio. Assicurati che l'utente del database abbia i privilegi CREATE TABLE.

Problemi di Prestazioni

Se il tuo server RedM presenta lag, basso tick rate o prestazioni generalmente scarse:

Identificare i Problemi di Prestazioni

Controlla la console del server per avvisi sulle prestazioni. I server RedM puntano a un tick rate di circa 30-64 tick al secondo. Puoi monitorarlo con:

• Dashboard txAdmin: Se txAdmin è disponibile, mostra metriche di prestazione del server in tempo reale.
• Console del server: Cerca avvisi "slow tick" o "resource hitch".
• Comando resmon: Digita resmon 1 nella console del server (o nella console F8) per abilitare il monitor delle risorse, che mostra il tempo CPU per risorsa.

Soluzioni Comuni per le Prestazioni

Pratiche Raccomandate

• Pianifica riavvii automatici ogni 6-12 ore utilizzando la funzione di pianificazione di GPanel o txAdmin per cancellare i problemi accumulati di memoria ed entità.
• Mantieni le risorse aggiornate per beneficiare di correzioni e ottimizzazioni delle prestazioni.
• Evita funzionalità duplicate — non eseguire due risorse che fanno la stessa cosa (es. due sistemi meteorologici).
• Testa le nuove risorse su un server di staging (o con un basso numero di giocatori) prima di distribuirle sul tuo server principale.
• Monitora regolarmente le metriche del server tramite GPanel o txAdmin per individuare i problemi in anticipo.

Suggerimenti Generali per la Risoluzione dei Problemi

1. Leggi sempre l'output della console del server. Quasi ogni errore include un messaggio nella console che ti dice cosa è andato storto e dove.
2. Riavvia il server dopo le modifiche alla configurazione. La maggior parte delle modifiche a server.cfg richiede un riavvio completo del server per avere effetto.
3. Disabilita le risorse una alla volta per isolare i problemi. Commenta le righe ensure in server.cfg con #.
4. Mantieni backup delle configurazioni funzionanti prima di apportare modifiche. Scarica il tuo server.cfg e il database prima di aggiornamenti importanti.
5. Controlla i forum e la documentazione Cfx.re su docs.fivem.net per la documentazione ufficiale che si applica sia a FiveM che a RedM.
6. Verifica la compatibilità delle risorse con la tua versione del server. Le risorse create per versioni precedenti potrebbero non funzionare con le build attuali di RedM.

Articoli Correlati

• Guida alla Configurazione del Server RedM — Chiavi di licenza, configurazione di server.cfg, gestione delle risorse e connessione.
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File tramite SFTP
• Iniziare con il Tuo Nuovo Server

Hai Bisogno di Aiuto?

Hai ancora problemi con il tuo server RedM? Apri un ticket di supporto e includi eventuali messaggi di errore dalla console del tuo server. Il nostro team ti aiuterà a diagnosticare e risolvere il problema.