Ez az útmutató a BeamMP szervered admin beállítását, szerver oldali erőforrásait, egyéni pályáit, járműkezelését és hibaelhárítását ismerteti a Legion Hosting platformon. A szerver kezdeti beállításához, hitelesítési kulcsokhoz és alapvető konfigurációhoz tekintsd meg a BeamMP szerver beállítási útmutatót.

---

Admin beállítás

A BeamMP nem rendelkezik hagyományos admin bejelentkezési vagy jelszó rendszerrel. Ehelyett az admin parancsok a szerver konzolon vagy szerver oldali Lua bővítményeken keresztül hajthatók végre, amelyek a játékos azonosítókat ellenőrzik.

Konzol parancsok

A GPanel szerver konzolja közvetlen hozzáférést biztosít a beépített szerver parancsokhoz. Írd be a parancsokat közvetlenül a konzol beviteli mezőjébe:

---

Erőforrások mappa szerkezet

A BeamMP egy Resources mappát használ a szerver oldali tartalom rendszerezéséhez. Ez a mappa két alkönyvtárat tartalmaz, eltérő célokkal:

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

Kliens erőforrások

A Resources/Client/ mappába helyezett fájlokat a játékosok automatikusan letöltik csatlakozáskor. Ezek a következőkre használhatók:

• Egyéni pályák — Pálya mod .zip fájlok, amelyekre a játékosoknak szükségük van a szerver pályájának betöltéséhez.
• Egyéni járművek — Jármű mod .zip fájlok, amelyek új autókat adnak hozzá vagy módosítják a meglévőket.
• Egyéb kliens modok — Bármely BeamNG.drive mod, amelynek jelen kell lennie a kliensen.

Szerver erőforrások (Lua bővítmények)

A Resources/Server/ könyvtár szerver oldali Lua bővítményeket tartalmaz. Ezek csak a szerveren futnak, és nem kerülnek elküldésre a játékosoknak. Minden bővítmény saját almappában helyezkedik el egy main.lua fájllal:

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

A szerver oldali bővítmények képesek:

• Reagálni a játékos eseményekre (csatlakozás, kilépés, chat üzenetek, jármű lerakás).
• Egyéni parancsokat megvalósítani chaten keresztül (pl. /tp, /give).
• Jármű jogosultságokat és korlátokat kezelni.
• Gazdasági rendszereket, teleportálást vagy más egyéni játékmenet funkciókat hozzáadni.
• Játékos tevékenységet naplózni és szabályokat betartatni.

---

Egyéni pályák hozzáadása

Egyéni (nem alapértelmezett) pálya futtatásához a BeamMP szervereden:

1. Töltsd le a pálya modot .zip fájlként egy BeamNG.drive mod forrásból (pl. a BeamNG.drive mod tárolóból).
2. Állítsd le a szerveredet a GPanel-ben.
3. Töltsd fel a .zip fájlt a Resources/Client/ mappába a Files fülön vagy SFTP-n keresztül. Ne csomagold ki a zip fájlt.
4. Frissítsd a MAP indítási változót (vagy a Map értéket a ServerConfig.toml fájlban) az egyéni pálya helyes útvonalára. Ez az útvonal általában /levels/map_name/info.json formátumú — ellenőrizd a mod dokumentációját a pontos útvonalért.
5. Indítsd el a szervert.

---

Járműkezelés

A BeamMP szervereken a járműkezelés a MaxCars beállításon és opcionálisan szerver oldali Lua bővítményeken keresztül történik.

MaxCars beállítás

A MaxCars beállítás a ServerConfig.toml fájlban (vagy a MAX_CARS indítási változó) szabályozza, hogy hány járművet helyezhet el egyszerre minden játékos:

• 1 — Minden játékosnak egyszerre egy járműve lehet (nagyobb szerverekhez ajánlott).
• 2–3 — Lehetővé teszi, hogy a játékosoknak pár járműve legyen, kisebb szerverekhez vagy autós találkozókhoz hasznos.
• A magasabb értékek arányosan növelik a szerver terhelését.

Egyéni jármű modok

Egyéni járművek hozzáadásához a szerveredhez:

1. Töltsd le a jármű modot .zip fájlként.
2. Helyezd el a Resources/Client/ mappában.
3. Indítsd újra a szervert. A játékosok automatikusan letöltik a jármű modot csatlakozáskor.

Járművek korlátozása bővítményeken keresztül

Részletesebb szabályozáshoz (pl. adott járművek tiltása, járműtípusok korlátozása) szerver oldali Lua bővítményre lesz szükséged. Ezek a bővítmények elfoghatják a jármű lerakási eseményeket, és egyéni szabályok alapján engedélyezhetik vagy megtagadhatják azokat. Tekintsd meg a BeamMP fórumot járműkezelési bővítményekért.

---

Bővítmények telepítése és kezelése

A szerver oldali Lua bővítmények kiterjesztik a szervered funkcionalitását. Így telepítheted és kezelheted őket:

Bővítmény telepítése

1. Töltsd le a bővítmény fájlokat (általában egy mappa, amely main.lua fájlt és esetleg más fájlokat tartalmaz).
2. Állítsd le a szerveredet.
3. Töltsd fel a bővítmény mappát a Resources/Server/ könyvtárba a Files fülön vagy SFTP-n keresztül.
4. Győződj meg róla, hogy a mappa szerkezet helyes: Resources/Server/PluginName/main.lua.
5. Indítsd el a szervert. A konzolban üzenetek jelennek meg a bővítmények betöltésekor.

Bővítmény eltávolítása

1. Állítsd le a szerveredet.
2. Töröld a bővítmény mappát a Resources/Server/ könyvtárból.
3. Indítsd el a szervert.

---

Hibaelhárítás

Hitelesítési kulcs hibák

• Ellenőrizd, hogy a kulcs helyesen van beillesztve az AUTH_KEY indítási változóba — extra szóközök vagy sortörések nélkül.
• Győződj meg róla, hogy a kulcs nem lett visszavonva vagy nem járt le a BeamMP Keymaster oldalon.
• Minden kulcs egyszerre csak egy szerveren használható. Ha ugyanazt a kulcsot máshol is használod, az sikertelen lesz.
• A konzol hitelesítési hibákat jelenít meg indításkor, ha a kulcs érvénytelen.

A játékosok nem tudnak csatlakozni

• Erősítsd meg, hogy a szerver teljesen elindult és online-ként jelenik meg a GPanel-ben.
• Ellenőrizd, hogy a játékos a BeamMP indítót használja, nem a standard BeamNG.drive indítót.
• Ha a szerver Private = true értékre van állítva, a játékosoknak közvetlen csatlakozást kell használniuk a helyes IP-vel és porttal. Lásd: Hogyan találd meg a szervered IP-jét és portját.
• Győződj meg róla, hogy a játékos BeamMP indító verziója kompatibilis a szerver verziójával. Az elavult indítók nem biztos, hogy csatlakozni tudnak.
• Ha a szerver megtelt (MaxPlayers elérve), további játékosok nem tudnak csatlakozni, amíg valaki el nem hagyja a szervert.

Mod szinkronizálási problémák

• Ha a játékosok elakadnak a letöltésnél vagy hiányzó modokkal kapcsolatos hibákat kapnak, ellenőrizd, hogy a mod .zip fájlok a Resources/Client/ mappában nem sérültek-e.
• Töltsd le újra és töltsd fel újra a mod fájlt, ha a .zip sérült.
• Nagyon nagy mod fájlok időtúllépést okozhatnak lassú kapcsolattal rendelkező játékosoknál. Fontold meg a szükségtelen nagy modok eltávolítását.
• Győződj meg róla, hogy a mod .zip fájlok nincsenek egymásba ágyazva (azaz egy .zip egy mappán belül egy másik .zip-ben).

Teljesítmény problémák sok játékossal/járművel

• Csökkentsd a MaxCars értéket 1-re játékosonként.
• Csökkentsd a MaxPlayers értéket, ha a szerver folyamatosan lag-ol.
• Válts egyszerűbb pályára (Grid Map vagy Industrial) a jobb teljesítmény érdekében magas játékosszámnál.
• Távolítsd el a szükségtelen kliens modokat a Resources/Client/ mappából a letöltési idők és memóriahasználat csökkentése érdekében.
• Ellenőrizd a GPanel erőforrás-használati grafikonjait — ha a CPU vagy RAM folyamatosan a határtértéken van, fontold meg a szerver csomag frissítését. Nyiss egy támogatási jegyet a lehetőségek megbeszéléséhez.

A szerver nem jelenik meg a böngészőben

• Győződj meg róla, hogy a Private értéke false a konfigurációban.
• Ellenőrizd, hogy a hitelesítési kulcs érvényes és nincs másik szerveren használatban.
• Várj 1–2 percet indítás után, amíg a szerver regisztrálja magát a BeamMP háttérrendszerben.
• Ellenőrizd a konzolt a master szerver kapcsolattal kapcsolatos hibákért.

---

Kapcsolódó cikkek

• BeamMP szerver beállítási útmutató — Kezdeti beállítás, hitelesítési kulcs, konfiguráció és csatlakozási útmutató
• Hogyan találd meg a szervered IP-jét és portját
• Fájlok feltöltése SFTP-vel
• Szerver indítási útmutató — Általános útmutató bármely játékszerver indításához a Legion Hosting platformon

---

További segítségre van szükséged?

Ha az útmutatóban nem tárgyalt problémákat tapasztalsz, támogatói csapatunk rendelkezésre áll. Nyiss egy jegyet a legionhosting.net/submitticket.php oldalon a szervered adataival, a probléma leírásával és a GPanel konzolból származó releváns hibaüzenetekkel.