Deze gids behandelt beheerdersinstellingen, server-side resources, aangepaste maps, voertuigbeheer en probleemoplossing voor je BeamMP server op Legion Hosting. Zie voor de eerste serverinstallatie, authenticatiesleutels en basisconfiguratie de BeamMP Server Setup Guide.

---

Beheerdersinstellingen

BeamMP heeft geen traditioneel beheerderslogin- of wachtwoordsysteem. In plaats daarvan worden beheerderscommando's uitgevoerd via de serverconsole of via server-side Lua-plugins die speleridentificaties controleren.

Consolecommando's

De serverconsole in GPanel biedt directe toegang tot ingebouwde servercommando's. Typ commando's rechtstreeks in het console-invoerveld:

---

Resources mapstructuur

BeamMP gebruikt een Resources-map om server-side content te organiseren. Deze map bevat twee submappen met verschillende doeleinden:

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

Client Resources

Bestanden geplaatst in Resources/Client/ worden automatisch gedownload door spelers wanneer ze verbinden. Dit wordt gebruikt voor:

• Aangepaste maps — Map-mod .zip-bestanden die spelers nodig hebben om de servermap te laden.
• Aangepaste voertuigen — Voertuig-mod .zip-bestanden die nieuwe auto's toevoegen of bestaande wijzigen.
• Andere client-mods — Elke BeamNG.drive-mod die aanwezig moet zijn op de client.

Server Resources (Lua-plugins)

De Resources/Server/-map bevat server-side Lua-plugins. Deze draaien alleen op de server en worden niet naar spelers gestuurd. Elke plugin bevindt zich in een eigen submap met een main.lua-bestand:

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

Server-side plugins kunnen:

• Reageren op spelergebeurtenissen (verbinden, verlaten, chatberichten, voertuig-spawns).
• Aangepaste commando's implementeren die via chat worden geactiveerd (bijv. /tp, /give).
• Voertuigrechten en -limieten beheren.
• Economiesystemen, teleportatie of andere aangepaste gameplay-functies toevoegen.
• Spelersactiviteit loggen en regels handhaven.

---

Aangepaste maps toevoegen

Om een aangepaste (niet-standaard) map op je BeamMP server te draaien:

1. Download de map-mod als een .zip-bestand van een BeamNG.drive-modbron (bijv. de BeamNG.drive mod-repository).
2. Stop je server in GPanel.
3. Upload het .zip-bestand naar Resources/Client/ via het Files-tabblad of SFTP. Pak het zipbestand niet uit.
4. Werk de MAP opstartvariabele bij (of Map in ServerConfig.toml) naar het juiste mappad voor de aangepaste map. Dit pad heeft doorgaans het formaat /levels/map_name/info.json — raadpleeg de documentatie van de mod voor het exacte pad.
5. Start de server.

---

Voertuigbeheer

Voertuigbeheer op BeamMP servers wordt geregeld via de MaxCars-instelling en optioneel via server-side Lua-plugins.

MaxCars-instelling

De MaxCars-instelling in ServerConfig.toml (of de MAX_CARS opstartvariabele) bepaalt hoeveel voertuigen elke speler tegelijk kan spawnen:

• 1 — Elke speler kan één voertuig tegelijk hebben (aanbevolen voor grotere servers).
• 2–3 — Hiermee kunnen spelers een paar voertuigen hebben, handig voor kleinere servers of auto-bijeenkomsten.
• Hogere waarden verhogen de serverbelasting evenredig.

Aangepaste voertuig-mods

Om aangepaste voertuigen aan je server toe te voegen:

1. Download de voertuig-mod als een .zip-bestand.
2. Plaats het in Resources/Client/.
3. Herstart de server. Spelers downloaden de voertuig-mod automatisch bij het verbinden.

Voertuigen beperken via plugins

Voor meer gedetailleerde controle (bijv. specifieke voertuigen verbieden, voertuigtypes beperken), heb je een server-side Lua-plugin nodig. Deze plugins kunnen voertuig-spawn-gebeurtenissen onderscheppen en op basis van aangepaste regels toestaan of weigeren. Bekijk de BeamMP forums voor voertuigbeheer-plugins.

---

Plugins installeren en beheren

Server-side Lua-plugins breiden de functionaliteit van je server uit. Hier lees je hoe je ze installeert en beheert:

Een plugin installeren

1. Download de pluginbestanden (doorgaans een map met main.lua en mogelijk andere bestanden).
2. Stop je server.
3. Upload de pluginmap naar Resources/Server/ via het Files-tabblad of SFTP.
4. Controleer of de mapstructuur correct is: Resources/Server/PluginName/main.lua.
5. Start de server. De console toont berichten wanneer plugins worden geladen.

Een plugin verwijderen

1. Stop je server.
2. Verwijder de pluginmap uit Resources/Server/.
3. Start de server.

---

Probleemoplossing

Authenticatiesleutelfouten

• Controleer of de sleutel correct is geplakt in de AUTH_KEY opstartvariabele — geen extra spaties of regelonderbrekingen.
• Controleer of de sleutel niet is ingetrokken of verlopen op de BeamMP Keymaster.
• Elke sleutel kan slechts op één server tegelijk worden gebruikt. Als je dezelfde sleutel elders gebruikt, zal deze mislukken.
• De console toont authenticatiefouten bij het opstarten als de sleutel ongeldig is.

Spelers kunnen niet verbinden

• Bevestig dat de server volledig is opgestart en als online wordt weergegeven in GPanel.
• Controleer of de speler de BeamMP-launcher gebruikt, niet de standaard BeamNG.drive-launcher.
• Als de server is ingesteld op Private = true, moeten spelers direct connect gebruiken met het juiste IP-adres en de juiste poort. Zie How to Find Your Server IP and Port.
• Controleer of de BeamMP-launcherversie van de speler compatibel is met de serverversie. Verouderde launchers kunnen mogelijk niet verbinden.
• Als de server vol is (MaxPlayers bereikt), kunnen extra spelers niet toetreden totdat iemand vertrekt.

Mod-synchronisatieproblemen

• Als spelers vastlopen bij het downloaden of fouten krijgen over ontbrekende mods, controleer dan of de mod .zip-bestanden in Resources/Client/ niet beschadigd zijn.
• Download en upload het modbestand opnieuw als het .zip-bestand beschadigd is.
• Zeer grote modbestanden kunnen time-outs veroorzaken voor spelers met een langzame verbinding. Overweeg onnodige grote mods te verwijderen.
• Zorg ervoor dat mod .zip-bestanden niet genest zijn (d.w.z. een .zip in een map in een andere .zip).

Prestatieproblemen met veel spelers/voertuigen

• Verlaag MaxCars naar 1 per speler.
• Verlaag MaxPlayers als de server consistent lag ervaart.
• Schakel over naar een eenvoudigere map (Grid Map of Industrial) voor betere prestaties bij hoge spelersaantallen.
• Verwijder onnodige client-mods uit Resources/Client/ om downloadtijden en geheugengebruik te verminderen.
• Controleer de resourcegebruikgrafieken van GPanel — als CPU of RAM constant aan de limiet zit, overweeg dan een upgrade van je serverplan. Open een supportticket om de opties te bespreken.

Server verschijnt niet in de browser

• Controleer of Private is ingesteld op false in je configuratie.
• Controleer of de authenticatiesleutel geldig is en niet in gebruik is door een andere server.
• Wacht 1–2 minuten na het opstarten totdat de server zich heeft geregistreerd bij de BeamMP-backend.
• Controleer de console op fouten gerelateerd aan de master server-verbinding.

---

Gerelateerde artikelen

• BeamMP Server Setup Guide — Eerste installatie, authenticatiesleutel, configuratie en verbindingsinstructies
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Server Startup Guide — Algemene gids voor het starten van een gameserver op Legion Hosting

---

Meer hulp nodig?

Als je problemen ondervindt die niet in deze gids worden behandeld, staat ons ondersteuningsteam klaar om te helpen. Open een ticket op legionhosting.net/submitticket.php met je servergegevens, een beschrijving van het probleem en eventuele relevante foutmeldingen uit de GPanel console.