Den här guiden behandlar administratörsinställningar, serverbaserade resurser, anpassade kartor, fordonshantering och felsökning för din BeamMP-server hos Legion Hosting. För den första serverkonfigurationen, autentiseringsnycklar och grundläggande konfiguration, se Installationsguide för BeamMP-server.

---

Administratörsinställningar

BeamMP har inget traditionellt system för administratörsinloggning eller lösenord. I stället körs administratörskommandon via serverkonsolen eller via serverbaserade Lua-plugins som kontrollerar spelaridentifierare.

Konsolkommandon

Serverkonsolen i GPanel ger direkt tillgång till inbyggda serverkommandon. Skriv kommandon direkt i konsolens inmatningsfält:

---

Resurmappens struktur

BeamMP använder en Resources-mapp för att organisera serverbaserat innehåll. Den här mappen innehåller två underkataloger med olika syften:

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

Klientresurser

Filer som placeras i Resources/Client/ laddas automatiskt ned av spelare när de ansluter. Detta används för:

• Anpassade kartor — .zip-filer för kartmoddar som spelare behöver för att ladda serverns karta.
• Anpassade fordon — .zip-filer för fordonsmoddar som lägger till nya bilar eller modifierar befintliga.
• Övriga klientmoddar — Alla BeamNG.drive-moddar som behöver finnas på klienten.

Serverresurser (Lua-plugins)

Katalogen Resources/Server/ innehåller serverbaserade Lua-plugins. Dessa körs endast på servern och skickas inte till spelare. Varje plugin ligger i sin egen undermapp med en main.lua-fil:

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

Serverbaserade plugins kan:

• Reagera på spelarhändelser (anslutning, frånkoppling, chattmeddelanden, fordonsspawn).
• Implementera anpassade kommandon som utlöses via chatt (t.ex. /tp, /give).
• Hantera fordonsbehörigheter och -gränser.
• Lägga till ekonomisystem, teleportering eller andra anpassade spelfunktioner.
• Logga spelaraktivitet och upprätthålla regler.

---

Lägga till anpassade kartor

Så här kör du en anpassad (icke-standard) karta på din BeamMP-server:

1. Ladda ned kartmodden som en .zip-fil från en BeamNG.drive-moddkälla (t.ex. BeamNG.drives moddrepository).
2. Stoppa din server i GPanel.
3. Ladda upp .zip-filen till Resources/Client/ via fliken Files eller SFTP. Packa inte upp zip-filen.
4. Uppdatera startvariabeln MAP (eller Map i ServerConfig.toml) till rätt kartsökväg för den anpassade kartan. Den här sökvägen har vanligtvis formatet /levels/map_name/info.json — läs moddens dokumentation för den exakta sökvägen.
5. Starta servern.

---

Fordonshantering

Fordonshantering på BeamMP-servrar styrs via inställningen MaxCars och eventuellt via serverbaserade Lua-plugins.

Inställningen MaxCars

Inställningen MaxCars i ServerConfig.toml (eller startvariabeln MAX_CARS) styr hur många fordon varje spelare kan spawna samtidigt:

• 1 — Varje spelare kan ha ett fordon åt gången (rekommenderas för större servrar).
• 2–3 — Tillåter spelare att ha ett par fordon, användbart för mindre servrar eller bilträffar.
• Högre värden ökar serverbelastningen proportionellt.

Anpassade fordonsmoddar

Så här lägger du till anpassade fordon på din server:

1. Ladda ned fordonsmodden som en .zip-fil.
2. Placera den i Resources/Client/.
3. Starta om servern. Spelare laddar automatiskt ned fordonsmodden vid anslutning.

Begränsa fordon via plugins

För mer detaljerad kontroll (t.ex. att bannlysa specifika fordon eller begränsa fordonstyper) behöver du en serverbaserad Lua-plugin. Dessa plugins kan fånga upp fordonsspawn-händelser och tillåta eller neka dem baserat på anpassade regler. Kontrollera BeamMP-forumet för fordonshanteringsplugins.

---

Installera och hantera plugins

Serverbaserade Lua-plugins utökar din servers funktionalitet. Så här installerar och hanterar du dem:

Installera en plugin

1. Ladda ned pluginfilerna (vanligtvis en mapp som innehåller main.lua och eventuellt andra filer).
2. Stoppa din server.
3. Ladda upp pluginmappen till Resources/Server/ via fliken Files eller SFTP.
4. Se till att mappstrukturen är korrekt: Resources/Server/PluginName/main.lua.
5. Starta servern. Konsolen visar meddelanden allteftersom plugins laddas.

Ta bort en plugin

1. Stoppa din server.
2. Ta bort pluginmappen från Resources/Server/.
3. Starta servern.

---

Felsökning

Fel med autentiseringsnyckel

• Kontrollera att nyckeln är korrekt inklistrad i startvariabeln AUTH_KEY — inga extra mellanslag eller radbrytningar.
• Se till att nyckeln inte har återkallats eller löpt ut på BeamMP Keymaster.
• Varje nyckel kan endast användas på en server åt gången. Om du använder samma nyckel någon annanstans kommer den att misslyckas.
• Konsolen visar autentiseringsfel vid start om nyckeln är ogiltig.

Spelare kan inte ansluta

• Bekräfta att servern är helt startad och visas som online i GPanel.
• Kontrollera att spelaren använder BeamMP-launchern, inte den vanliga BeamNG.drive-launchern.
• Om servern är inställd på Private = true måste spelare använda direktanslutning med rätt IP och port. Se Hur du hittar din servers IP och port.
• Se till att spelarens BeamMP-launcher-version är kompatibel med serverversionen. Föråldrade launchers kan misslyckas med att ansluta.
• Om servern är full (MaxPlayers uppnått) kan ytterligare spelare inte ansluta förrän någon lämnar.

Problem med moddsynkronisering

• Om spelare fastnar vid nedladdning eller får fel om saknade moddar, kontrollera att modd-.zip-filerna i Resources/Client/ inte är skadade.
• Ladda ned och ladda upp moddfilen igen om .zip-filen är skadad.
• Mycket stora moddfiler kan orsaka timeouts för spelare med långsamma anslutningar. Överväg att ta bort onödiga stora moddar.
• Se till att modd-.zip-filer inte är nästlade (dvs. en .zip inuti en mapp inuti en annan .zip).

Prestandaproblem med många spelare/fordon

• Sänk MaxCars till 1 per spelare.
• Sänk MaxPlayers om servern upplever ihållande lagg.
• Byt till en enklare karta (Grid Map eller Industrial) för bättre prestanda med höga spelarantal.
• Ta bort onödiga klientmoddar från Resources/Client/ för att minska nedladdningstider och minnesanvändning.
• Kontrollera GPanels grafer för resursanvändning — om CPU eller RAM konstant ligger på gränsen, överväg att uppgradera ditt serverabonnemang. Öppna ett supportärende för att diskutera alternativ.

Servern visas inte i webbläsaren

• Se till att Private är inställt på false i din konfiguration.
• Kontrollera att autentiseringsnyckeln är giltig och inte används av en annan server.
• Vänta 1–2 minuter efter start för att servern ska registreras hos BeamMP-backenden.
• Kontrollera konsolen för eventuella fel relaterade till anslutningen till master-servern.

---

Relaterade artiklar

• Installationsguide för BeamMP-server — Första installationen, autentiseringsnyckel, konfiguration och anslutningsinstruktioner
• Hur du hittar din servers IP och port
• Hur du laddar upp filer via SFTP
• Guide för serverstart — Allmän guide för att starta vilken spelserver som helst hos Legion Hosting

---

Behöver du mer hjälp?

Om du upplever problem som inte täcks i den här guiden finns vårt supportteam tillgängligt för att hjälpa till. Öppna ett ärende på legionhosting.net/submitticket.php med dina serveruppgifter, en beskrivning av problemet och eventuella relevanta felmeddelanden från GPanel-konsolen.