Ghid de depanare pentru problemele comune ale serverului RedM, inclusiv erori de cheie de licență, vizibilitatea în lista de servere, eșecuri ale resurselor, conexiuni ale clienților, probleme cu baza de date și optimizarea performanței. Pentru instrucțiuni de configurare inițială, consultă ghidul nostru Ghid de configurare a serverului RedM.

Erori de cheie de licență

Problemele cu cheia de licență sunt cea mai comună problemă la pornirea unui server RedM nou. Iată erorile tipice și soluțiile lor:

"Invalid license key" sau "Could not authenticate"

Serverul nu apare în lista de servere

Dacă serverul tău rulează, dar jucătorii nu îl pot găsi în lista de servere RedM:

Listă de verificare

1. Așteaptă cel puțin 5 minute. După pornire, serverul are nevoie de timp pentru a se înregistra în lista master de servere Cfx.re. Serverele noi pot dura câteva minute până să apară.
2. Verifică dacă cheia de licență este validă. Serverul nu va fi listat fără o cheie de licență funcțională. Verifică consola serverului pentru erori legate de licență.
3. Verifică configurația endpoint-urilor. Asigură-te că endpoint_add_tcp și endpoint_add_udp din server.cfg folosesc portul corect:

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

   Portul trebuie să corespundă cu cel atribuit în GPanel.
4. Verifică setările "sv_master1" sau de listare. Asigură-te că nu ai setat din greșeală serverul să nu se listeze. Nu ar trebui să existe niciun sv_master1 "" în configurația ta (acest lucru dezactivează înregistrarea în lista master).
5. Verifică dacă serverul rulează cu adevărat. Verifică consola GPanel. Dacă serverul s-a blocat sau s-a oprit, nu va apărea în lista de servere.
6. Încearcă conectarea directă. Chiar dacă serverul nu este în listă, conectarea directă ar trebui să funcționeze. Cere unui jucător să apese F8 în RedM și să tasteze:

   connect YOUR_SERVER_IP:PORT

Eșecuri la încărcarea resurselor

Erorile de resurse sunt comune la adăugarea de scripturi sau cadre noi pe serverul tău. Iată cele mai frecvente probleme:

"Could not find resource [resource_name]"

• Folderul resursei nu există în directorul resources/ sau se află în locația greșită.
• Numele folderului nu corespunde cu numele folosit în ensure. Numele resurselor sunt sensibile la majuscule.
• Soluție: Verifică dacă folderul resursei există și dacă numele din server.cfg corespunde exact. Folosește managerul de fișiere GPanel sau SFTP pentru a verifica.

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

• Fișierul fxmanifest.lua sau __resource.lua al resursei are o eroare de sintaxă.
• Manifestul face referire la fișiere care nu există în folderul resursei.
• Soluție: Deschide fișierul manifest și verifică greșeli de scriere, virgule lipsă sau referințe la fișiere inexistente. Verifică consola serverului pentru numărul exact al liniei erorii.

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

• Un fișier Lua, C# sau JavaScript din cadrul resursei are o eroare de sintaxă sau de execuție.
• Soluție: Citește mesajul complet de eroare din consolă. Acesta va include numele fișierului și numărul liniei. Cauzele comune includ:
  • Dependențe lipsă (o altă resursă care trebuie încărcată mai întâi)
  • Resursă învechită, incompatibilă cu versiunea curentă a serverului RedM
  • Valori de configurare incorecte în fișierul de configurare al resursei

Probleme cu ordinea de încărcare a resurselor

Resursele din server.cfg sunt încărcate în ordinea în care apar. Dacă o resursă depinde de alta (de ex., vorp_inventory depinde de vorp_core), dependența trebuie listată 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

Probleme de conectare a clienților

Când jucătorii nu se pot conecta la serverul tău:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Parola serverului: Dacă sv_password este setată, jucătorul trebuie să introducă parola corectă.
• Resursă de whitelist/allowlist: Dacă ai o resursă de whitelist activată, jucătorul trebuie să fie aprobat înainte de a se conecta.
• Ban: Jucătorul poate fi banat. Verifică lista ta de bany sau baza de date pentru identificatorii săi.

Clientul se blochează la conectare

• O resursă de pe server trimite date eronate sau are o eroare de script pe partea de client care blochează clientul.
• Soluție: Dezactivează pe rând resursele adăugate recent pentru a o identifica pe cea problematică. Verifică consola serverului pentru erori în timpul conectării clientului.
• Asigură-te că clientul RedM al jucătorului este actualizat.

Erori "Could not download file"

• Serverul încearcă să trimită un fișier mare (de ex., un activ de streaming) care depășește limitele de transfer sau conexiunea este instabilă.
• Soluție: Reduce dimensiunea activelor transmise prin streaming, folosește un CDN/găzduire externă pentru fișierele mari dacă este suportat, sau cere jucătorului să reîncerce conectarea.

Probleme cu baza de date (MySQL / oxmysql)

Majoritatea cadrelor de roleplay RedM folosesc MySQL pentru stocarea persistentă a datelor. Cel mai comun conector de bază de date este oxmysql.

Erori de conexiune eșuată

Dacă oxmysql (sau un alt conector MySQL) nu reușește să se conecteze, verifică următoarele:

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

Tabele lipsă sau erori de schemă

Cadrele de roleplay necesită adesea configurarea unor tabele de bază de date înainte de a putea funcționa:

1. Verifică documentația cadrului sau depozitul GitHub pentru fișiere de import SQL (adesea denumite database.sql, schema.sql sau similar).
2. Importă fișierul SQL în baza ta de date folosind phpMyAdmin sau un client MySQL.
3. Unele cadre creează automat tabelele la prima pornire. Asigură-te că utilizatorul bazei de date are privilegii CREATE TABLE.

Probleme de performanță

Dacă serverul tău RedM se confruntă cu lag, rată scăzută de tick sau performanță slabă în general:

Identificarea problemelor de performanță

Verifică consola serverului pentru avertismente de performanță. Serverele RedM țintesc o rată de tick de aproximativ 30-64 de tick-uri pe secundă. Poți monitoriza acest lucru cu:

• Tabloul de bord txAdmin: Dacă txAdmin este disponibil, afișează metrici de performanță a serverului în timp real.
• Consola serverului: Urmărește avertismentele "slow tick" sau "resource hitch".
• Comanda resmon: Tastează resmon 1 în consola serverului (sau consola F8) pentru a activa monitorul de resurse, care afișează timpul CPU per resursă.

Soluții comune de performanță

Practici recomandate

• Programează reporniri automate la fiecare 6-12 ore folosind funcția de programare din GPanel sau txAdmin pentru a curăța memoria acumulată și problemele de entități.
• Menține resursele actualizate pentru a beneficia de remedieri de performanță și optimizări.
• Evită funcționalitatea duplicată — nu rula două resurse care fac același lucru (de ex., două sisteme de vreme).
• Testează resursele noi pe un server de staging (sau cu un număr mic de jucători) înainte de a le implementa pe serverul tău principal.
• Monitorizează metricile serverului în mod regulat prin GPanel sau txAdmin pentru a depista problemele din timp.

Sfaturi generale de depanare

1. Citește întotdeauna rezultatul consolei serverului. Aproape fiecare eroare include un mesaj în consolă care îți spune ce a mers prost și unde.
2. Repornește serverul după modificările de configurare. Majoritatea modificărilor aduse server.cfg necesită o repornire completă a serverului pentru a intra în vigoare.
3. Dezactivează resursele pe rând pentru a izola problemele. Comentează liniile ensure din server.cfg cu #.
4. Păstrează copii de rezervă ale configurațiilor funcționale înainte de a face modificări. Descarcă fișierul tău server.cfg și baza de date înainte de actualizările majore.
5. Verifică forumurile și documentația Cfx.re la docs.fivem.net pentru documentația oficială care se aplică atât FiveM, cât și RedM.
6. Verifică compatibilitatea resurselor cu versiunea serverului tău. Resursele construite pentru versiuni mai vechi este posibil să nu funcționeze cu build-urile RedM curente.

Articole conexe

• Ghid de configurare a serverului RedM — Chei de licență, configurarea server.cfg, gestionarea resurselor și conectarea.
• Cum să găsești IP-ul și portul serverului tău
• Cum să încarci fișiere prin SFTP
• Primii pași cu noul tău server

Ai nevoie de ajutor?

Încă întâmpini probleme cu serverul tău RedM? Deschide un tichet de asistență și include orice mesaje de eroare din consola serverului tău. Echipa noastră te va ajuta să diagnostichezi și să rezolvi problema.