Ovaj vodič pokriva postavljanje administratora, resurse na strani servera, prilagođene mape, upravljanje vozilima i rješavanje problema za vaš BeamMP server na Legion Hosting. Za početno postavljanje servera, autentifikacijske ključeve i osnovnu konfiguraciju pogledajte BeamMP vodič za postavljanje servera.

---

Postavljanje administratora

BeamMP nema tradicionalni sustav prijave administratora ili lozinke. Umjesto toga, administratorske naredbe izvršavaju se putem konzole servera ili putem Lua dodataka na strani servera koji provjeravaju identifikatore igrača.

Naredbe konzole

Konzola servera u GPanel pruža izravan pristup ugrađenim naredbama servera. Upišite naredbe izravno u polje za unos konzole:

---

Struktura mape resursa

BeamMP koristi mapu Resources za organiziranje sadržaja na strani servera. Ova mapa sadrži dva poddirektorija s različitim namjenama:

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

Klijentski resursi

Datoteke smještene u Resources/Client/ automatski se preuzimaju od strane igrača kada se spoje. Ovo se koristi za:

• Prilagođene mape — .zip datoteke modova mapa koje igrači trebaju za učitavanje mape servera.
• Prilagođena vozila — .zip datoteke modova vozila koje dodaju nova vozila ili mijenjaju postojeća.
• Ostali klijentski modovi — Bilo koji BeamNG.drive mod koji mora biti prisutan na klijentu.

Serverski resursi (Lua dodaci)

Direktorij Resources/Server/ sadrži Lua dodatke na strani servera. Oni se pokreću samo na serveru i ne šalju se igračima. Svaki dodatak nalazi se u vlastitoj podmapi s main.lua datotekom:

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

Dodaci na strani servera mogu:

• Reagirati na događaje igrača (pridruživanje, odlazak, chat poruke, stvaranje vozila).
• Implementirati prilagođene naredbe pokrenute putem chata (npr. /tp, /give).
• Upravljati dozvolama i ograničenjima vozila.
• Dodati ekonomske sustave, teleportaciju ili druge prilagođene značajke igre.
• Bilježiti aktivnost igrača i provoditi pravila.

---

Dodavanje prilagođenih mapa

Za pokretanje prilagođene (ne-zadane) mape na vašem BeamMP serveru:

1. Preuzmite mod mape kao .zip datoteku iz izvora modova za BeamNG.drive (npr. BeamNG.drive repozitorij modova).
2. Zaustavite server u GPanel.
3. Prenesite .zip datoteku u Resources/Client/ putem kartice Files ili SFTP. Nemojte raspakiravati zip.
4. Ažurirajte MAP varijablu pokretanja (ili Map u ServerConfig.toml) na ispravan put mape za prilagođenu mapu. Ovaj put je obično u formatu /levels/map_name/info.json — provjerite dokumentaciju moda za točan put.
5. Pokrenite server.

---

Upravljanje vozilima

Upravljanje vozilima na BeamMP serverima kontrolira se putem postavke MaxCars i opcionalno putem Lua dodataka na strani servera.

Postavka MaxCars

Postavka MaxCars u ServerConfig.toml (ili varijabla pokretanja MAX_CARS) kontrolira koliko vozila svaki igrač može istovremeno stvoriti:

• 1 — Svaki igrač može imati jedno vozilo istovremeno (preporučeno za veće servere).
• 2–3 — Omogućuje igračima da imaju par vozila, korisno za manje servere ili okupljanja automobila.
• Veće vrijednosti proporcionalno povećavaju opterećenje servera.

Prilagođeni modovi vozila

Za dodavanje prilagođenih vozila na vaš server:

1. Preuzmite mod vozila kao .zip datoteku.
2. Stavite ga u Resources/Client/.
3. Ponovno pokrenite server. Igrači će automatski preuzeti mod vozila pri spajanju.

Ograničavanje vozila putem dodataka

Za detaljniju kontrolu (npr. zabrana određenih vozila, ograničavanje tipova vozila), trebat će vam Lua dodatak na strani servera. Ti dodaci mogu presresti događaje stvaranja vozila i dopustiti ili odbiti ih na temelju prilagođenih pravila. Provjerite BeamMP forume za dodatke za upravljanje vozilima.

---

Instaliranje i upravljanje dodacima

Lua dodaci na strani servera proširuju funkcionalnost vašeg servera. Evo kako ih instalirati i upravljati njima:

Instaliranje dodatka

1. Preuzmite datoteke dodatka (obično mapa koja sadrži main.lua i moguće druge datoteke).
2. Zaustavite server.
3. Prenesite mapu dodatka u Resources/Server/ putem kartice Files ili SFTP.
4. Provjerite je li struktura mapa ispravna: Resources/Server/PluginName/main.lua.
5. Pokrenite server. Konzola će prikazati poruke dok se dodaci učitavaju.

Uklanjanje dodatka

1. Zaustavite server.
2. Izbrišite mapu dodatka iz Resources/Server/.
3. Pokrenite server.

---

Rješavanje problema

Pogreške autentifikacijskog ključa

• Provjerite je li ključ ispravno zalijepljen u AUTH_KEY varijablu pokretanja — bez dodatnih razmaka ili prijeloma redova.
• Provjerite nije li ključ opozvan ili istekao na BeamMP Keymaster.
• Svaki ključ može se koristiti samo na jednom serveru istovremeno. Ako koristite isti ključ drugdje, neće raditi.
• Konzola će prikazati pogreške autentifikacije pri pokretanju ako je ključ nevažeći.

Igrači se ne mogu spojiti

• Potvrdite da je server potpuno pokrenut i da se prikazuje kao online u GPanel.
• Provjerite koristi li igrač BeamMP pokretač, a ne standardni BeamNG.drive pokretač.
• Ako je server postavljen na Private = true, igrači se moraju spojiti izravnim spajanjem s ispravnim IP-om i portom. Pogledajte Kako pronaći IP adresu i port vašeg servera.
• Provjerite je li verzija BeamMP pokretača igrača kompatibilna s verzijom servera. Zastarjeli pokretači možda se neće moći spojiti.
• Ako je server pun (dosegnut MaxPlayers), dodatni igrači ne mogu se pridružiti dok netko ne ode.

Problemi sa sinkronizacijom modova

• Ako igrači zapnu pri preuzimanju ili dobiju pogreške o nedostajućim modovima, provjerite da .zip datoteke modova u Resources/Client/ nisu oštećene.
• Ponovno preuzmite i ponovno prenesite datoteku moda ako je .zip oštećen.
• Vrlo velike datoteke modova mogu uzrokovati isteke vremena za igrače na sporim vezama. Razmislite o uklanjanju nepotrebnih velikih modova.
• Provjerite da .zip datoteke modova nisu ugniježđene (tj. .zip unutar mape unutar drugog .zip-a).

Problemi s performansama s mnogo igrača/vozila

• Smanjite MaxCars na 1 po igraču.
• Smanjite MaxPlayers ako server ima stalni lag.
• Prebacite se na jednostavniju mapu (Grid Map ili Industrial) za bolje performanse s velikim brojem igrača.
• Uklonite nepotrebne klijentske modove iz Resources/Client/ kako biste smanjili vrijeme preuzimanja i korištenje memorije.
• Provjerite grafove korištenja resursa u GPanel — ako su CPU ili RAM stalno na granici, razmislite o nadogradnji plana servera. Otvorite zahtjev za podršku da razgovarate o opcijama.

Server se ne pojavljuje u pregledniku

• Provjerite je li Private postavljen na false u vašoj konfiguraciji.
• Provjerite je li autentifikacijski ključ važeći i ne koristi li ga drugi server.
• Pričekajte 1–2 minute nakon pokretanja da se server registrira kod BeamMP pozadinskog sustava.
• Provjerite konzolu za eventualne pogreške povezane s vezom na glavni server.

---

Povezani članci

• BeamMP vodič za postavljanje servera — Početno postavljanje, autentifikacijski ključ, konfiguracija i upute za spajanje
• Kako pronaći IP adresu i port vašeg servera
• Kako prenijeti datoteke putem SFTP
• Vodič za pokretanje servera — Opći vodič za pokretanje bilo kojeg poslužitelja igara na Legion Hosting

---

Trebate dodatnu pomoć?

Ako imate problema koji nisu pokriveni ovim vodičem, naš tim za podršku je dostupan za pomoć. Otvorite zahtjev na legionhosting.net/submitticket.php s detaljima vašeg servera, opisom problema i svim relevantnim porukama o pogreškama iz GPanel konzole.