Acest ghid acoperă configurarea administratorilor, resursele de pe partea serverului, hărțile personalizate, gestionarea vehiculelor și depanarea pentru serverul tău BeamMP pe Legion Hosting. Pentru configurarea inițială a serverului, cheile de autentificare și configurarea de bază, consultă Ghidul de Configurare a Serverului BeamMP.

Configurarea Administratorilor

BeamMP nu are un sistem tradițional de autentificare sau de parolă pentru administratori. În schimb, comenzile de administrare sunt executate prin consola serverului sau prin plugin-uri Lua de pe partea serverului care verifică identificatorii jucătorilor.

Comenzi de Consolă

Consola serverului din GPanel oferă acces direct la comenzile încorporate ale serverului. Tastează comenzile direct în câmpul de intrare al consolei:

Structura Folderului Resources

BeamMP folosește un folder Resources pentru a organiza conținutul de pe partea serverului. Acest folder conține două subdirectoare cu scopuri distincte:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Resurse Client

Fișierele plasate în Resources/Client/ sunt descărcate automat de jucători atunci când se conectează. Acest lucru este folosit pentru:

• Hărți personalizate — Fișiere .zip de mod de hartă de care jucătorii au nevoie pentru a încărca harta serverului.
• Vehicule personalizate — Fișiere .zip de mod de vehicul care adaugă mașini noi sau modifică cele existente.
• Alte mod-uri client — Orice mod BeamNG.drive care trebuie să fie prezent pe client.

Resurse Server (Plugin-uri Lua)

Directorul Resources/Server/ conține plugin-uri Lua de pe partea serverului. Acestea rulează doar pe server și nu sunt trimise jucătorilor. Fiecare plugin se află în propriul subfolder cu un fișier main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Plugin-urile de pe partea serverului pot:

• Răspunde la evenimente ale jucătorilor (alăturare, plecare, mesaje de chat, apariții de vehicule).
• Implementa comenzi personalizate declanșate prin chat (de ex., /tp, /give).
• Gestiona permisiunile și limitele vehiculelor.
• Adăuga sisteme de economie, teleportare sau alte funcții de gameplay personalizate.
• Înregistra activitatea jucătorilor și impune reguli.

Adăugarea Hărților Personalizate

Pentru a rula o hartă personalizată (non-implicită) pe serverul tău BeamMP:

1. Descarcă mod-ul hărții ca fișier .zip dintr-o sursă de mod-uri BeamNG.drive (de ex., depozitul de mod-uri BeamNG.drive).
2. Oprește serverul în GPanel.
3. Încarcă fișierul .zip în Resources/Client/ prin fila Files sau prin SFTP. Nu extrage arhiva zip.
4. Actualizează variabila de pornire MAP (sau Map în ServerConfig.toml) la calea corectă a hărții pentru harta personalizată. Această cale este de obicei în formatul /levels/map_name/info.json — verifică documentația mod-ului pentru calea exactă.
5. Pornește serverul.

Gestionarea Vehiculelor

Gestionarea vehiculelor pe serverele BeamMP este controlată prin setarea MaxCars și, opțional, prin plugin-uri Lua de pe partea serverului.

Setarea MaxCars

Setarea MaxCars din ServerConfig.toml (sau variabila de pornire MAX_CARS) controlează câte vehicule poate genera simultan fiecare jucător:

• 1 — Fiecare jucător poate avea un singur vehicul la un moment dat (recomandat pentru servere mai mari).
• 2–3 — Permite jucătorilor să aibă câteva vehicule, util pentru servere mai mici sau întâlniri de mașini.
• Valorile mai mari cresc proporțional încărcarea serverului.

Mod-uri de Vehicule Personalizate

Pentru a adăuga vehicule personalizate pe serverul tău:

1. Descarcă mod-ul vehiculului ca fișier .zip.
2. Plasează-l în Resources/Client/.
3. Repornește serverul. Jucătorii vor descărca automat mod-ul vehiculului la conectare.

Restricționarea Vehiculelor prin Plugin-uri

Pentru un control mai granular (de ex., interzicerea anumitor vehicule, limitarea tipurilor de vehicule), vei avea nevoie de un plugin Lua de pe partea serverului. Aceste plugin-uri pot intercepta evenimentele de apariție a vehiculelor și le pot permite sau refuza pe baza unor reguli personalizate. Verifică forumurile BeamMP pentru plugin-uri de gestionare a vehiculelor.

Instalarea și Gestionarea Plugin-urilor

Plugin-urile Lua de pe partea serverului extind funcționalitatea serverului tău. Iată cum să le instalezi și să le gestionezi:

Instalarea unui Plugin

1. Descarcă fișierele plugin-ului (de obicei un folder care conține main.lua și posibil alte fișiere).
2. Oprește serverul.
3. Încarcă folderul plugin-ului în Resources/Server/ prin fila Files sau prin SFTP.
4. Asigură-te că structura folderului este corectă: Resources/Server/PluginName/main.lua.
5. Pornește serverul. Consola va afișa mesaje pe măsură ce plugin-urile se încarcă.

Eliminarea unui Plugin

1. Oprește serverul.
2. Șterge folderul plugin-ului din Resources/Server/.
3. Pornește serverul.

Depanare

Erori la Cheia de Autentificare

• Verifică dacă cheia este lipită corect în variabila de pornire AUTH_KEY — fără spații suplimentare sau întreruperi de linie.
• Asigură-te că cheia nu a fost revocată sau nu a expirat pe BeamMP Keymaster.
• Fiecare cheie poate fi folosită doar pe un singur server la un moment dat. Dacă folosești aceeași cheie în altă parte, va eșua.
• Consola va afișa erori de autentificare la pornire dacă cheia este invalidă.

Jucătorii Nu se Pot Conecta

• Confirmă că serverul este pornit complet și apare ca online în GPanel.
• Verifică dacă jucătorul folosește launcher-ul BeamMP, nu launcher-ul standard BeamNG.drive.
• Dacă serverul este setat la Private = true, jucătorii trebuie să folosească conectarea directă cu IP-ul și portul corecte. Consultă Cum să Găsești IP-ul și Portul Serverului Tău.
• Asigură-te că versiunea launcher-ului BeamMP al jucătorului este compatibilă cu versiunea serverului. Launcher-ele învechite pot eșua la conectare.
• Dacă serverul este plin (MaxPlayers atins), jucătorii suplimentari nu se pot alătura până când nu pleacă cineva.

Probleme de Sincronizare a Mod-urilor

• Dacă jucătorii rămân blocați la descărcare sau primesc erori despre mod-uri lipsă, verifică dacă fișierele .zip ale mod-urilor din Resources/Client/ nu sunt corupte.
• Descarcă din nou și reîncarcă fișierul mod-ului dacă .zip-ul este deteriorat.
• Fișierele de mod foarte mari pot cauza timeout-uri pentru jucătorii cu conexiuni lente. Ia în considerare eliminarea mod-urilor mari inutile.
• Asigură-te că fișierele .zip ale mod-urilor nu sunt imbricate (adică un .zip într-un folder dintr-un alt .zip).

Probleme de Performanță cu Mulți Jucători/Vehicule

• Redu MaxCars la 1 per jucător.
• Scade MaxPlayers dacă serverul prezintă întârzieri constante.
• Treci la o hartă mai simplă (Grid Map sau Industrial) pentru o performanță mai bună cu un număr mare de jucători.
• Elimină mod-urile client inutile din Resources/Client/ pentru a reduce timpii de descărcare și utilizarea memoriei.
• Verifică graficele de utilizare a resurselor din GPanel — dacă CPU-ul sau RAM-ul este constant la limită, ia în considerare actualizarea planului serverului tău. Deschide un tichet de asistență pentru a discuta opțiunile.

Serverul Nu Apare în Browser

• Asigură-te că Private este setat la false în configurația ta.
• Verifică dacă cheia de autentificare este validă și nu este folosită de un alt server.
• Așteaptă 1–2 minute după pornire pentru ca serverul să se înregistreze la backend-ul BeamMP.
• Verifică consola pentru orice erori legate de conexiunea cu serverul master.

Articole Conexe

• Ghidul de Configurare a Serverului BeamMP — Configurare inițială, cheie de autentificare, configurare și instrucțiuni de conectare
• Cum să Găsești IP-ul și Portul Serverului Tău
• Cum să Încarci Fișiere prin SFTP
• Ghidul de Pornire a Serverului — Ghid general pentru pornirea oricărui server de joc pe Legion Hosting

Ai Nevoie de Mai Mult Ajutor?

Dacă întâmpini probleme care nu sunt acoperite în acest ghid, echipa noastră de asistență este disponibilă să te ajute. Deschide un tichet la legionhosting.net/submitticket.php cu detaliile serverului tău, o descriere a problemei și orice mesaje de eroare relevante din consola GPanel.