Ovaj vodič pokriva podešavanje administracije, resurse na strani servera, prilagođene mape, upravljanje vozilima i rešavanje problema za vaš BeamMP server na Legion Hosting. Za inicijalno podešavanje servera, ključeve za autentifikaciju i osnovnu konfiguraciju, pogledajte Vodič za podešavanje BeamMP servera.

---

Podešavanje administracije

BeamMP nema tradicionalni sistem prijave administratora ili lozinke. Umesto toga, administratorske komande se izvršavaju kroz konzolu servera ili putem Lua dodataka na strani servera koji proveravaju identifikatore igrača.

Konzolne komande

Konzola servera u GPanel-u pruža direktan pristup ugrađenim komandama servera. Ukucajte komande direktno u polje za unos konzole:

---

Struktura foldera Resources

BeamMP koristi folder Resources za organizaciju sadržaja na strani servera. Ovaj folder sadrži dva poddirektorijuma sa različitim namenama:

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

Resursi klijenta

Fajlovi smešteni u Resources/Client/ automatski se preuzimaju od strane igrača kada se povežu. Ovo se koristi za:

• Prilagođene mape — .zip fajlovi modova mapa koji su potrebni igračima da učitaju mapu servera.
• Prilagođena vozila — .zip fajlovi modova vozila koji dodaju nove automobile ili menjaju postojeće.
• Drugi klijentski modovi — Bilo koji BeamNG.drive mod koji mora biti prisutan na klijentu.

Resursi servera (Lua dodaci)

Direktorijum Resources/Server/ sadrži Lua dodatke na strani servera. Oni se izvršavaju samo na serveru i ne šalju se igračima. Svaki dodatak se nalazi u svom poddirektorijumu sa main.lua fajlom:

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

Dodaci na strani servera mogu:

• Reagovati na događaje igrača (pridruživanje, napuštanje, čet poruke, pojavljivanje vozila).
• Implementirati prilagođene komande pokrenute putem četa (npr. /tp, /give).
• Upravljati dozvolama i ograničenjima vozila.
• Dodati ekonomske sisteme, teleportaciju ili druge prilagođene funkcije igranja.
• Beležiti aktivnost igrača i sprovoditi pravila.

---

Dodavanje prilagođenih mapa

Da biste pokrenuli prilagođenu (nestandardnu) mapu na vašem BeamMP serveru:

1. Preuzmite mod mape kao .zip fajl iz izvora BeamNG.drive modova (npr. repozitorijum BeamNG.drive modova).
2. Zaustavite vaš server u GPanel-u.
3. Otpremite .zip fajl u Resources/Client/ putem kartice Files ili SFTP. Nemojte raspakovati zip.
4. Ažurirajte startup promenljivu MAP (ili Map u ServerConfig.toml) na ispravnu putanju mape za prilagođenu mapu. Ova putanja je obično u formatu /levels/map_name/info.json — proverite dokumentaciju moda za tačnu putanju.
5. Pokrenite server.

---

Upravljanje vozilima

Upravljanje vozilima na BeamMP serverima se kontroliše kroz podešavanje MaxCars i opcionalno kroz Lua dodatke na strani servera.

Podešavanje MaxCars

Podešavanje MaxCars u ServerConfig.toml (ili startup promenljiva MAX_CARS) kontroliše koliko vozila svaki igrač može da pojavi istovremeno:

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

Prilagođeni modovi vozila

Da biste dodali prilagođena vozila na vaš server:

1. Preuzmite mod vozila kao .zip fajl.
2. Postavite ga u Resources/Client/.
3. Ponovo pokrenite server. Igrači će automatski preuzeti mod vozila prilikom povezivanja.

Ograničavanje vozila putem dodataka

Za detaljniju kontrolu (npr. zabranjivanje određenih vozila, ograničavanje tipova vozila), biće vam potreban Lua dodatak na strani servera. Ovi dodaci mogu presresti događaje pojavljivanja vozila i dozvoliti ih ili odbiti na osnovu prilagođenih pravila. Proverite BeamMP forume za dodatke za upravljanje vozilima.

---

Instaliranje i upravljanje dodacima

Lua dodaci na strani servera proširuju funkcionalnost vašeg servera. Evo kako da ih instalirate i njima upravljate:

Instaliranje dodatka

1. Preuzmite fajlove dodatka (obično folder koji sadrži main.lua i možda druge fajlove).
2. Zaustavite vaš server.
3. Otpremite folder dodatka u Resources/Server/ putem kartice Files ili SFTP.
4. Uverite se da je struktura foldera ispravna: Resources/Server/PluginName/main.lua.
5. Pokrenite server. Konzola će prikazivati poruke kako se dodaci učitavaju.

Uklanjanje dodatka

1. Zaustavite vaš server.
2. Obrišite folder dodatka iz Resources/Server/.
3. Pokrenite server.

---

Rešavanje problema

Greške ključa za autentifikaciju

• Proverite da li je ključ ispravno nalepljen u startup promenljivu AUTH_KEY — bez dodatnih razmaka ili preloma reda.
• Uverite se da ključ nije opozvan ili istekao na BeamMP Keymaster.
• Svaki ključ se može koristiti samo na jednom serveru u isto vreme. Ako koristite isti ključ negde drugde, neće raditi.
• Konzola će prikazati greške autentifikacije pri pokretanju ako je ključ nevažeći.

Igrači ne mogu da se povežu

• Potvrdite da je server potpuno pokrenut i prikazan kao onlajn u GPanel-u.
• Proverite da li igrač koristi BeamMP launcher, a ne standardni BeamNG.drive launcher.
• Ako je server podešen na Private = true, igrači moraju koristiti direktno povezivanje sa ispravnim IP-jem i portom. Pogledajte Kako pronaći IP i port vašeg servera.
• Uverite se da je verzija BeamMP launcher-a igrača kompatibilna sa verzijom servera. Zastareli launcher-i mogu da ne uspeju da se povežu.
• Ako je server pun (dostignut MaxPlayers), dodatni igrači ne mogu da se pridruže dok neko ne ode.

Problemi sa sinhronizacijom modova

• Ako igrači zapnu pri preuzimanju ili dobijaju greške o nedostajućim modovima, proverite da li su .zip fajlovi modova u Resources/Client/ oštećeni.
• Ponovo preuzmite i ponovo otpremite fajl moda ako je .zip oštećen.
• Veoma veliki fajlovi modova mogu izazvati istek vremena za igrače sa sporim vezama. Razmotrite uklanjanje nepotrebnih velikih modova.
• Uverite se da .zip fajlovi modova nisu ugnežđeni (tj. .zip unutar foldera unutar drugog .zip-a).

Problemi sa performansama sa mnogo igrača/vozila

• Smanjite MaxCars na 1 po igraču.
• Smanjite MaxPlayers ako server doživljava konstantno kašnjenje.
• Pređite na jednostavniju mapu (Grid Map ili Industrial) za bolje performanse sa velikim brojem igrača.
• Uklonite nepotrebne klijentske modove iz Resources/Client/ da smanjite vreme preuzimanja i korišćenje memorije.
• Proverite grafikone korišćenja resursa u GPanel-u — ako su CPU ili RAM konstantno na granici, razmotrite nadogradnju vašeg plana servera. Otvorite tiket za podršku da razgovarate o opcijama.

Server se ne pojavljuje u pregledaču

• Uverite se da je Private podešen na false u vašoj konfiguraciji.
• Proverite da li je ključ za autentifikaciju važeći i da nije u upotrebi na drugom serveru.
• Sačekajte 1–2 minuta nakon pokretanja da se server registruje kod BeamMP backend-a.
• Proverite konzolu za bilo kakve greške u vezi sa povezivanjem na master server.

---

Povezani članci

• Vodič za podešavanje BeamMP servera — Inicijalno podešavanje, ključ za autentifikaciju, konfiguracija i uputstva za povezivanje
• Kako pronaći IP i port vašeg servera
• Kako otpremiti fajlove putem SFTP
• Vodič za pokretanje servera — Opšti vodič za pokretanje bilo kog game servera na Legion Hosting

---

Potrebna vam je dodatna pomoć?

Ako imate probleme koji nisu pokriveni u ovom vodiču, naš tim za podršku je dostupan da pomogne. Otvorite tiket na legionhosting.net/submitticket.php sa detaljima o vašem serveru, opisom problema i bilo kojim relevantnim porukama o grešci iz GPanel konzole.