Tämä opas käsittelee järjestelmänvalvojan määrityksen, palvelinpuolen resurssit, mukautetut kartat, ajoneuvojen hallinnan ja vianmäärityksen Legion Hostingin BeamMP-palvelimellesi. Palvelimen alustavasta määrityksestä, todennusavaimista ja perusasetuksista lue BeamMP-palvelimen asennusopas.

---

Järjestelmänvalvojan määritys

BeamMP:llä ei ole perinteistä järjestelmänvalvojan kirjautumis- tai salasanajärjestelmää. Sen sijaan järjestelmänvalvojan komennot suoritetaan palvelimen konsolin kautta tai palvelinpuolen Lua-laajennusten avulla, jotka tarkistavat pelaajien tunnisteet.

Konsolikomennot

GPanelin palvelinkonsoli tarjoaa suoran pääsyn sisäänrakennettuihin palvelinkomentoihin. Kirjoita komennot suoraan konsolin syöttökenttään:

---

Resources-kansion rakenne

BeamMP käyttää Resources-kansiota palvelinpuolen sisällön organisointiin. Tämä kansio sisältää kaksi alihakemistoa, joilla on selkeät tarkoitukset:

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

Asiakaspuolen resurssit

Kansioon Resources/Client/ sijoitetut tiedostot ladataan automaattisesti pelaajille, kun he yhdistävät. Tätä käytetään:

• Mukautetut kartat — Kartta-modi-zip-tiedostot, joita pelaajat tarvitsevat palvelimen kartan lataamiseen.
• Mukautetut ajoneuvot — Ajoneuvomodi-zip-tiedostot, jotka lisäävät uusia autoja tai muokkaavat olemassa olevia.
• Muut asiakasmodit — Mikä tahansa BeamNG.drive-modi, jonka on oltava asiakkaan puolella.

Palvelinpuolen resurssit (Lua-laajennukset)

Hakemisto Resources/Server/ sisältää palvelinpuolen Lua-laajennukset. Nämä toimivat vain palvelimella, eikä niitä lähetetä pelaajille. Jokainen laajennus on omassa alikansiossaan, jossa on main.lua-tiedosto:

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

Palvelinpuolen laajennukset voivat:

• Reagoida pelaajatapahtumiin (liittyminen, poistuminen, chat-viestit, ajoneuvojen luonti).
• Toteuttaa mukautettuja komentoja, joita käynnistetään chatissa (esim. /tp, /give).
• Hallita ajoneuvojen käyttöoikeuksia ja rajoituksia.
• Lisätä talousjärjestelmiä, teleporttausta tai muita mukautettuja peliominaisuuksia.
• Kirjata pelaajan toimintaa ja valvoa sääntöjä.

---

Mukautettujen karttojen lisääminen

Suorittaaksesi mukautetun (ei-oletuksen) kartan BeamMP-palvelimellasi:

1. Lataa kartta-modi .zip-tiedostona BeamNG.drive-modilähteestä (esim. BeamNG.drive-modien arkisto).
2. Pysäytä palvelimesi GPanelissa.
3. Lataa .zip-tiedosto kansioon Resources/Client/ Files-välilehden tai SFTP:n kautta. Älä pura zip-tiedostoa.
4. Päivitä MAP-käynnistysmuuttuja (tai Map tiedostossa ServerConfig.toml) vastaamaan mukautetun kartan oikeaa karttapolkua. Tämä polku on tyypillisesti muodossa /levels/map_name/info.json — tarkista oikea polku modin dokumentaatiosta.
5. Käynnistä palvelin.

---

Ajoneuvojen hallinta

Ajoneuvojen hallintaa BeamMP-palvelimilla ohjataan MaxCars-asetuksen kautta ja valinnaisesti palvelinpuolen Lua-laajennusten avulla.

MaxCars-asetus

MaxCars-asetus tiedostossa ServerConfig.toml (tai MAX_CARS-käynnistysmuuttuja) ohjaa, kuinka monta ajoneuvoa kukin pelaaja voi luoda samanaikaisesti:

• 1 — Kullakin pelaajalla voi olla yksi ajoneuvo kerrallaan (suositellaan suuremmille palvelimille).
• 2–3 — Sallii pelaajille muutaman ajoneuvon, hyödyllistä pienemmille palvelimille tai automeeteille.
• Korkeammat arvot lisäävät palvelimen kuormaa suhteellisesti.

Mukautetut ajoneuvomodit

Lisätäksesi mukautettuja ajoneuvoja palvelimellesi:

1. Lataa ajoneuvomodi .zip-tiedostona.
2. Sijoita se kansioon Resources/Client/.
3. Käynnistä palvelin uudelleen. Pelaajat lataavat ajoneuvomodin automaattisesti yhdistäessään.

Ajoneuvojen rajoittaminen laajennusten avulla

Tarkempaa hallintaa varten (esim. tiettyjen ajoneuvojen bannaaminen, ajoneuvotyyppien rajoittaminen) tarvitset palvelinpuolen Lua-laajennuksen. Nämä laajennukset voivat siepata ajoneuvon luontitapahtumat ja sallia tai estää ne mukautettujen sääntöjen perusteella. Tarkista BeamMP-foorumeilta ajoneuvojen hallintaan tarkoitettuja laajennuksia.

---

Laajennusten asentaminen ja hallinta

Palvelinpuolen Lua-laajennukset laajentavat palvelimesi toimintoja. Näin asennat ja hallinnoit niitä:

Laajennuksen asentaminen

1. Lataa laajennuksen tiedostot (tyypillisesti kansio, joka sisältää main.lua-tiedoston ja mahdollisesti muita tiedostoja).
2. Pysäytä palvelimesi.
3. Lataa laajennuskansio kansioon Resources/Server/ Files-välilehden tai SFTP:n kautta.
4. Varmista, että kansiorakenne on oikea: Resources/Server/PluginName/main.lua.
5. Käynnistä palvelin. Konsoli näyttää viestejä laajennusten latautuessa.

Laajennuksen poistaminen

1. Pysäytä palvelimesi.
2. Poista laajennuksen kansio kansiosta Resources/Server/.
3. Käynnistä palvelin.

---

Vianmääritys

Todennusavainvirheet

• Tarkista, että avain on liitetty oikein AUTH_KEY-käynnistysmuuttujaan — ei ylimääräisiä välilyöntejä tai rivinvaihtoja.
• Varmista, ettei avainta ole peruutettu tai vanhentunut BeamMP Keymasterissa.
• Kutakin avainta voidaan käyttää vain yhdellä palvelimella kerrallaan. Jos käytät samaa avainta muualla, se epäonnistuu.
• Konsoli näyttää todennusvirheet käynnistyksen yhteydessä, jos avain on virheellinen.

Pelaajat eivät voi yhdistää

• Vahvista, että palvelin on käynnistynyt täysin ja näkyy verkossa GPanelissa.
• Tarkista, että pelaaja käyttää BeamMP-käynnistintä, ei tavallista BeamNG.drive-käynnistintä.
• Jos palvelin on asetettu tilaan Private = true, pelaajien on käytettävä suoraa yhdistämistä oikealla IP-osoitteella ja portilla. Katso Palvelimen IP-osoitteen ja portin etsiminen.
• Varmista, että pelaajan BeamMP-käynnistimen versio on yhteensopiva palvelimen version kanssa. Vanhentuneet käynnistimet voivat epäonnistua yhdistämisessä.
• Jos palvelin on täynnä (MaxPlayers saavutettu), lisäpelaajat eivät voi liittyä, ennen kuin joku poistuu.

Modien synkronointiongelmat

• Jos pelaajat jumiutuvat lataukseen tai saavat virheitä puuttuvista modeista, tarkista, etteivät kansion Resources/Client/ modi-.zip-tiedostot ole vioittuneet.
• Lataa modi-tiedosto uudelleen ja lataa se palvelimelle uudelleen, jos .zip on vaurioitunut.
• Erittäin suuret modi-tiedostot voivat aiheuttaa aikakatkaisuja pelaajille, joilla on hitaat yhteydet. Harkitse tarpeettomien suurten modien poistamista.
• Varmista, etteivät modi-.zip-tiedostot ole sisäkkäin (eli .zip toisen kansion sisällä toisen .zipin sisällä).

Suorituskykyongelmat monilla pelaajilla/ajoneuvoilla

• Vähennä MaxCars-arvoa arvoon 1 pelaajaa kohden.
• Pienennä MaxPlayers-arvoa, jos palvelimessa on jatkuvaa viivettä.
• Vaihda yksinkertaisempaan karttaan (Grid Map tai Industrial) parempaa suorituskykyä varten suurilla pelaajamäärillä.
• Poista tarpeettomat asiakasmodit kansiosta Resources/Client/ latausaikojen ja muistinkäytön vähentämiseksi.
• Tarkista GPanelin resurssien käyttökaaviot — jos CPU tai RAM on jatkuvasti rajalla, harkitse palvelinpaketin päivittämistä. Avaa tukipyyntö keskustellaksesi vaihtoehdoista.

Palvelin ei näy selaimessa

• Varmista, että Private on asetettu arvoon false konfiguraatiossasi.
• Tarkista, että todennusavain on kelvollinen eikä se ole toisen palvelimen käytössä.
• Odota 1–2 minuuttia käynnistyksen jälkeen, jotta palvelin rekisteröityy BeamMP-taustajärjestelmään.
• Tarkista konsolista mahdolliset virheet pääpalvelinyhteyden suhteen.

---

Aiheeseen liittyvät artikkelit

• BeamMP-palvelimen asennusopas — Alustava määritys, todennusavain, konfigurointi ja yhdistämisohjeet
• Palvelimen IP-osoitteen ja portin etsiminen
• Tiedostojen lataaminen SFTP:n kautta
• Palvelimen käynnistysopas — Yleinen opas minkä tahansa pelipalvelimen käynnistämiseen Legion Hostingilla

---

Tarvitsetko lisäapua?

Jos kohtaat ongelmia, joita tämä opas ei kata, tukitiimimme on käytettävissä auttamaan. Avaa tiketti osoitteessa legionhosting.net/submitticket.php ja anna palvelimesi tiedot, kuvaus ongelmasta sekä mahdolliset asiaankuuluvat virheilmoitukset GPanelin konsolista.