See juhend käsitleb administraatori seadistamist, serveripoolseid ressursse, kohandatud kaarte, sõidukite haldamist ja veaotsingut teie BeamMP serveril Legion Hosting platvormil. Serveri algseadistuse, autentimisvõtmete ja põhikonfiguratsiooni kohta vaadake BeamMP serveri seadistamise juhendit.

---

Administraatori seadistamine

BeamMP-l puudub traditsiooniline administraatori sisselogimis- või paroolisüsteem. Selle asemel täidetakse administraatori käske serveri konsooli kaudu või serveripoolsete Lua pluginate abil, mis kontrollivad mängija identifikaatoreid.

Konsoolikäsud

GPanel serveri konsool annab otseligipääsu sisseehitatud serverikäskudele. Sisestage käsud otse konsooli sisestusväljale:

---

Ressursside kausta struktuur

BeamMP kasutab kausta Resources serveripoolse sisu korraldamiseks. See kaust sisaldab kahte alamkataloogi erinevate eesmärkidega:

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

Kliendipoolsed ressursid

Kausta Resources/Client/ paigutatud failid laaditakse mängijatele automaatselt alla ühendamisel. Seda kasutatakse järgmiseks:

• Kohandatud kaardid — kaardi modi .zip failid, mida mängijad vajavad serveri kaardi laadimiseks.
• Kohandatud sõidukid — sõiduki modi .zip failid, mis lisavad uusi autosid või muudavad olemasolevaid.
• Muud kliendipoolsed modid — mis tahes BeamNG.drive mod, mis peab olema kliendil olemas.

Serveripoolsed ressursid (Lua pluginad)

Kataloog Resources/Server/ sisaldab serveripoolseid Lua pluginaid. Need töötavad ainult serveris ja neid ei saadeta mängijatele. Iga plugina jaoks on eraldi alamkaust koos main.lua failiga:

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

Serveripoolsed pluginad saavad:

• Reageerida mängija sündmustele (liitumine, lahkumine, vestlussõnumid, sõidukite tekitamine).
• Rakendada kohandatud käske, mida käivitatakse vestluse kaudu (nt /tp, /give).
• Hallata sõidukite õigusi ja piiranguid.
• Lisada majandussüsteeme, teleporteerimist või muid kohandatud mänguomadusi.
• Logida mängijate tegevust ja jõustada reegleid.

---

Kohandatud kaartide lisamine

Kohandatud (mitte-vaikimisi) kaardi käivitamiseks oma BeamMP serveris:

1. Laadige kaardi mod alla .zip failina BeamNG.drive modi allikast (nt BeamNG.drive modi hoidlast).
2. Peatage oma server GPanel paneelil.
3. Laadige .zip fail üles kausta Resources/Client/ Files vahekaardi kaudu või SFTP abil. Ärge pakkige zip-faili lahti.
4. Uuendage MAP käivitusmuutujat (või Map failis ServerConfig.toml) õige kaardi teega kohandatud kaardi jaoks. See tee on tavaliselt formaadis /levels/map_name/info.json — kontrollige modi dokumentatsioonist täpset teed.
5. Käivitage server.

---

Sõidukite haldamine

BeamMP serverite sõidukite haldamine toimub MaxCars seadistuse ja valikuliselt serveripoolsete Lua pluginate kaudu.

MaxCars seadistus

Seadistus MaxCars failis ServerConfig.toml (või MAX_CARS käivitusmuutuja) määrab, mitu sõidukit iga mängija saab korraga tekitada:

• 1 — igal mängijal saab korraga olla üks sõiduk (soovitatav suuremate serverite jaoks).
• 2–3 — võimaldab mängijatel omada paari sõidukit, kasulik väiksemate serverite või autokohtumiste jaoks.
• Kõrgemad väärtused suurendavad serveri koormust proportsionaalselt.

Kohandatud sõidukite modid

Kohandatud sõidukite lisamiseks oma serverile:

1. Laadige sõiduki mod alla .zip failina.
2. Paigutage see kausta Resources/Client/.
3. Taaskäivitage server. Mängijad laadivad sõiduki modi ühendamisel automaatselt alla.

Sõidukite piiramine pluginate abil

Täpsemaks kontrolliks (nt konkreetsete sõidukite keelamine, sõidukitüüpide piiramine) on vaja serveripoolset Lua pluginat. Need pluginad saavad peatada sõidukite tekitamise sündmusi ja lubada või keelata neid kohandatud reeglite alusel. Sõidukite haldamise pluginate leidmiseks vaadake BeamMP foorumeid.

---

Pluginate installimine ja haldamine

Serveripoolsed Lua pluginad laiendavad teie serveri funktsionaalsust. Siit saate teada, kuidas neid installida ja hallata:

Plugina installimine

1. Laadige alla plugina failid (tavaliselt kaust, mis sisaldab main.lua ja võimalikke muid faile).
2. Peatage oma server.
3. Laadige plugina kaust üles kausta Resources/Server/ Files vahekaardi kaudu või SFTP abil.
4. Veenduge, et kaustastruktuur on õige: Resources/Server/PluginName/main.lua.
5. Käivitage server. Konsool kuvab teateid pluginate laadimise kohta.

Plugina eemaldamine

1. Peatage oma server.
2. Kustutage plugina kaust kaustast Resources/Server/.
3. Käivitage server.

---

Veaotsing

Autentimisvõtme vead

• Kontrollige, et võti on õigesti kleebitud AUTH_KEY käivitusmuutujasse — ilma lisatühikute või reavahetusteta.
• Veenduge, et võti pole tühistatud ega aegunud BeamMP Keymaster lehel.
• Iga võtit saab korraga kasutada ainult ühes serveris. Kui kasutate sama võtit mujal, tekib tõrge.
• Konsool kuvab käivitamisel autentimisvigu, kui võti on kehtetu.

Mängijad ei saa ühenduda

• Kinnitage, et server on täielikult käivitunud ja kuvatakse GPanel paneelil võrgus olevana.
• Kontrollige, et mängija kasutab BeamMP käivitajat, mitte tavalist BeamNG.drive käivitajat.
• Kui server on seadistatud valikule Private = true, peavad mängijad ühenduma otseühenduse kaudu õige IP ja pordiga. Vaadake Kuidas leida oma serveri IP-d ja porti.
• Veenduge, et mängija BeamMP käivitaja versioon ühildub serveri versiooniga. Aegunud käivitajad ei pruugi ühenduda.
• Kui server on täis (MaxPlayers piir on saavutatud), ei saa lisanduvad mängijad liituda enne, kui keegi lahkub.

Modi sünkroonimise probleemid

• Kui mängijad jäävad allalaadimise juurde kinni või saavad veateateid puuduvate modide kohta, kontrollige, et modi .zip failid kaustas Resources/Client/ pole rikutud.
• Laadige modi fail uuesti alla ja laadige üles, kui .zip on kahjustatud.
• Väga suured modi failid võivad aeglase ühendusega mängijatele põhjustada aegumisi. Kaaluge tarbetute suurte modide eemaldamist.
• Veenduge, et modi .zip failid pole pesastatud (st .zip kausta sees teise .zip sees).

Jõudlusprobleemid paljude mängijate/sõidukitega

• Vähendage MaxCars väärtusele 1 mängija kohta.
• Vähendage MaxPlayers väärtust, kui serveril esineb pidevat viivitust.
• Vahetage lihtsama kaardi vastu (Grid Map või Industrial) parema jõudluse tagamiseks suure mängijate arvuga.
• Eemaldage tarbetud kliendipoolsed modid kaustast Resources/Client/, et vähendada allalaadimisaegu ja mälukasutust.
• Kontrollige GPanel ressursikasutuse graafikuid — kui CPU või RAM on pidevalt piiri peal, kaaluge serveriplaani uuendamist. Avage tugipäring valikute arutamiseks.

Server ei ilmu brauseris

• Veenduge, et Private on teie konfiguratsioonis seadistatud väärtusele false.
• Kontrollige, et autentimisvõti on kehtiv ja seda ei kasuta teine server.
• Oodake pärast käivitamist 1–2 minutit, kuni server registreerib end BeamMP taustasüsteemis.
• Kontrollige konsooli master-serveri ühendusega seotud vigade osas.

---

Seotud artiklid

• BeamMP serveri seadistamise juhend — algseadistus, autentimisvõti, konfiguratsioon ja ühendumisjuhised
• Kuidas leida oma serveri IP-d ja porti
• Kuidas laadida faile üles SFTP kaudu
• Serveri käivitamise juhend — üldine juhend mis tahes mänguserveri käivitamiseks Legion Hosting platvormil

---

Vajate lisaabi?

Kui teil esineb probleeme, mida see juhend ei käsitle, on meie tugimeeskond valmis aitama. Avage päring aadressil legionhosting.net/submitticket.php koos oma serveri andmete, probleemi kirjelduse ja asjakohaste veateadetega GPanel konsoolist.