Denne veiledningen dekker adminoppsett, serverside-ressurser, egendefinerte kart, kjøretøyadministrasjon og feilsøking for BeamMP-serveren din hos Legion Hosting. For førstegangs serveroppsett, autentiseringsnøkler og grunnleggende konfigurasjon, se BeamMP serveroppsettveiledning.

---

Adminoppsett

BeamMP har ikke et tradisjonelt admin-innloggings- eller passordsystem. I stedet kjøres adminkommandoer gjennom serverkonsollen eller via serverside Lua-plugins som kontrollerer spilleridentifikatorer.

Konsollkommandoer

Serverkonsollen i GPanel gir direkte tilgang til innebygde serverkommandoer. Skriv kommandoene direkte inn i konsollens inndatafelt:

---

Mappestruktur for ressurser

BeamMP bruker en Resources-mappe for å organisere serverside-innhold. Denne mappen inneholder to undermapper med ulike formål:

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

Klientressurser

Filer som plasseres i Resources/Client/ lastes automatisk ned av spillere når de kobler til. Dette brukes til:

• Egendefinerte kart — Kart-mod .zip-filer som spillere trenger for å laste serverens kart.
• Egendefinerte kjøretøy — Kjøretøy-mod .zip-filer som legger til nye biler eller endrer eksisterende.
• Andre klient-mods — Enhver BeamNG.drive-mod som må være til stede på klienten.

Serverressurser (Lua-plugins)

Resources/Server/-mappen inneholder serverside Lua-plugins. Disse kjører kun på serveren og sendes ikke til spillere. Hver plugin ligger i sin egen undermappe med en main.lua-fil:

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

Serverside-plugins kan:

• Reagere på spillerhendelser (bli med, forlate, chatmeldinger, kjøretøy-spawns).
• Implementere egendefinerte kommandoer utløst via chat (f.eks. /tp, /give).
• Administrere kjøretøytillatelser og -grenser.
• Legge til økonomisystemer, teleportering eller andre egendefinerte spillfunksjoner.
• Logge spilleraktivitet og håndheve regler.

---

Legge til egendefinerte kart

For å kjøre et egendefinert (ikke-standard) kart på BeamMP-serveren din:

1. Last ned kart-moden som en .zip-fil fra en BeamNG.drive mod-kilde (f.eks. BeamNG.drive mod-repositoriet).
2. Stopp serveren din i GPanel.
3. Last opp .zip-filen til Resources/Client/ via Files-fanen eller SFTP. Ikke pakk ut zip-filen.
4. Oppdater MAP-oppstartsvariabelen (eller Map i ServerConfig.toml) til riktig kartbane for det egendefinerte kartet. Denne banen er vanligvis i formatet /levels/map_name/info.json — sjekk modens dokumentasjon for den nøyaktige banen.
5. Start serveren.

---

Kjøretøyadministrasjon

Kjøretøyadministrasjon på BeamMP-servere styres gjennom MaxCars-innstillingen og eventuelt gjennom serverside Lua-plugins.

MaxCars-innstilling

MaxCars-innstillingen i ServerConfig.toml (eller MAX_CARS-oppstartsvariabelen) styrer hvor mange kjøretøy hver spiller kan spawne samtidig:

• 1 — Hver spiller kan ha ett kjøretøy om gangen (anbefalt for større servere).
• 2–3 — Lar spillere ha et par kjøretøy, nyttig for mindre servere eller biltreff.
• Høyere verdier øker serverbelastningen proporsjonalt.

Egendefinerte kjøretøy-mods

For å legge til egendefinerte kjøretøy på serveren din:

1. Last ned kjøretøy-moden som en .zip-fil.
2. Plasser den i Resources/Client/.
3. Start serveren på nytt. Spillere vil automatisk laste ned kjøretøy-moden ved tilkobling.

Begrense kjøretøy via plugins

For mer detaljert kontroll (f.eks. å utestenge bestemte kjøretøy, begrense kjøretøytyper) trenger du en serverside Lua-plugin. Disse pluginene kan fange opp kjøretøy-spawn-hendelser og tillate eller avvise dem basert på egendefinerte regler. Sjekk BeamMP-forumene for kjøretøyadministrasjons-plugins.

---

Installere og administrere plugins

Serverside Lua-plugins utvider serverens funksjonalitet. Slik installerer og administrerer du dem:

Installere en plugin

1. Last ned plugin-filene (vanligvis en mappe som inneholder main.lua og muligens andre filer).
2. Stopp serveren din.
3. Last opp plugin-mappen til Resources/Server/ via Files-fanen eller SFTP.
4. Sørg for at mappestrukturen er korrekt: Resources/Server/PluginName/main.lua.
5. Start serveren. Konsollen vil vise meldinger etter hvert som plugins lastes.

Fjerne en plugin

1. Stopp serveren din.
2. Slett plugin-mappen fra Resources/Server/.
3. Start serveren.

---

Feilsøking

Feil med autentiseringsnøkkel

• Kontroller at nøkkelen er riktig limt inn i AUTH_KEY-oppstartsvariabelen — ingen ekstra mellomrom eller linjeskift.
• Sørg for at nøkkelen ikke har blitt tilbakekalt eller utløpt på BeamMP Keymaster.
• Hver nøkkel kan bare brukes på én server om gangen. Hvis du bruker samme nøkkel andre steder, vil den feile.
• Konsollen vil vise autentiseringsfeil ved oppstart hvis nøkkelen er ugyldig.

Spillere kan ikke koble til

• Bekreft at serveren er fullstendig startet og vises som online i GPanel.
• Sjekk at spilleren bruker BeamMP-launcheren, ikke den vanlige BeamNG.drive-launcheren.
• Hvis serveren er satt til Private = true, må spillere bruke direktetilkobling med riktig IP og port. Se Hvordan finne server-IP og port.
• Sørg for at spillerens BeamMP-launcher-versjon er kompatibel med serverversjonen. Utdaterte launchere kan mislykkes i å koble til.
• Hvis serveren er full (MaxPlayers nådd), kan ikke flere spillere bli med før noen forlater.

Problemer med mod-synkronisering

• Hvis spillere sitter fast under nedlasting eller mottar feil om manglende mods, kontroller at mod .zip-filene i Resources/Client/ ikke er ødelagte.
• Last ned og last opp mod-filen på nytt hvis .zip-en er skadet.
• Svært store mod-filer kan forårsake tidsavbrudd for spillere på trege tilkoblinger. Vurder å fjerne unødvendige store mods.
• Sørg for at mod .zip-filer ikke er nestet (dvs. en .zip inne i en mappe inne i en annen .zip).

Ytelsesproblemer med mange spillere/kjøretøy

• Reduser MaxCars til 1 per spiller.
• Senk MaxPlayers hvis serveren opplever vedvarende lag.
• Bytt til et enklere kart (Grid Map eller Industrial) for bedre ytelse med høyt spillerantall.
• Fjern unødvendige klient-mods fra Resources/Client/ for å redusere nedlastingstider og minnebruk.
• Sjekk GPanels grafer for ressursbruk — hvis CPU eller RAM konsekvent er på grensen, vurder å oppgradere serverplanen din. Åpne en støttehenvendelse for å diskutere alternativer.

Serveren vises ikke i nettleseren

• Sørg for at Private er satt til false i konfigurasjonen din.
• Kontroller at autentiseringsnøkkelen er gyldig og ikke i bruk av en annen server.
• Vent 1–2 minutter etter oppstart for at serveren skal registrere seg hos BeamMP-backenden.
• Sjekk konsollen for eventuelle feil relatert til tilkoblingen til masterserveren.

---

Relaterte artikler

• BeamMP serveroppsettveiledning — Førstegangsoppsett, autentiseringsnøkkel, konfigurasjon og tilkoblingsinstruksjoner
• Hvordan finne server-IP og port
• Hvordan laste opp filer via SFTP
• Veiledning for serveroppstart — Generell veiledning for å starte en hvilken som helst spillserver hos Legion Hosting

---

Trenger du mer hjelp?

Hvis du opplever problemer som ikke dekkes i denne veiledningen, er støtteteamet vårt tilgjengelig for å hjelpe. Åpne en henvendelse på legionhosting.net/submitticket.php med serverdetaljene dine, en beskrivelse av problemet og eventuelle relevante feilmeldinger fra GPanel-konsollen.