BeamMP-server opzetten: AuthKey, mods, poort en spelers

Voor een BeamMP-server haal je een AuthKey op in de BeamMP Keymaster, vul je die met naam, poort en kaart in ServerConfig.toml in, zet je mods als zip in Resources/Client en start je de server. Spelers verbinden via de serverlijst of met Direct Connect op IP en poort (standaard 30814). De server zelf is licht: de pc's van je spelers bepalen hoeveel auto's er kunnen rijden.

BeamMP is de multiplayer-mod voor BeamNG.drive

BeamMP voegt multiplayer toe aan de rijsimulator BeamNG.drive. Elke speler installeert de BeamMP Launcher en heeft een eigen, actuele en legale kopie van het spel nodig. Daarnaast draait BeamMP-Server, een apart open-sourceprogramma voor Windows en Linux waarlangs alle spelers met elkaar praten; de nieuwste versie is nu v3.9.3, uit mei 2026. Na de eerste start ziet de servermap er zo uit:

Stap 1: haal een AuthKey op in de Keymaster

Elke server heeft een AuthKey nodig, ook een privéserver. Is het veld leeg, dan meldt de server No AuthKey specified en sluit hij na tien seconden af.

1. Log in op de BeamMP Keymaster (keymaster.beammp.com) met je Discord-account.
2. Klik links op Keys en rechtsboven op de groene +.
3. Vul een naam in; dat is alleen de naam van de key, niet die in de serverlijst.
4. Kopieer de key: 36 tekens in de vorm xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Behandel de key als een wachtwoord. Je hebt een beperkt aantal keys, en één key werkt op één draaiende server tegelijk.

Stap 2: ServerConfig.toml, de velden die ertoe doen

Dit zijn de standaardwaarden van de huidige versie, met alleen naam, beschrijving en key ingevuld:

[General]
Name = "Vrijdagavond Drift"
Description = "Freeroam en drift met vrienden"
AuthKey = "jouw-key-van-36-tekens"
Port = 30814
Private = true
MaxPlayers = 8
MaxCars = 1
Map = "/levels/gridmap_v2/info.json"
Tags = "Freeroam"
AllowGuests = true
LogChat = true
ResourceFolder = "Resources"

• Port: standaard 30814, over TCP én UDP. Elke poort tussen 1024 en 65535 mag, zolang geen ander programma hem gebruikt.
• Private: true houdt je server uit de openbare lijst, false zet hem erin.
• MaxPlayers en MaxCars: maximaal aantal spelers, en auto's per speler. Spawnt iemand er meer, dan verwijdert de server die direct.
• Map: het pad naar de kaart, altijd /levels/<naam>/info.json.
• AllowGuests: of gasten (spelers die niet inloggen) mogen joinen.

Gehoste server bij MC-Node? Dan vul je naam, beschrijving, AuthKey, Private, MaxPlayers, MaxCars en Map in bij het tabblad Startup van het gamepaneel. Het paneel zet die waarden bij elke start in ServerConfig.toml; wat je in die regels met de hand wijzigt, is na een herstart weer weg. Ook de poort komt uit het paneel en is niet per se 30814. Standaard staat Private daar op false (openbaar) en Max Players op 6. Tags en AllowGuests pas je gewoon aan via Files. De eerste start staat in de kennisbank: Hoe start ik een BeamMP-server?

Stap 3: mods en kaarten gaan als zip in Resources/Client

Alles in Resources/Client stuurt de server automatisch naar spelers die joinen. Hij laadt alleen bestanden die op .zip eindigen, dus pak niets uit.

• Voertuigmod: zip erin zetten en herstarten.
• Standaardkaart: niets installeren, alleen Map aanpassen, bijvoorbeeld naar /levels/west_coast_usa/info.json of /levels/italy/info.json.
• Kaartmod: zip in Resources/Client, open hem zonder uit te pakken en kijk in de map levels. Heet de submap daar mijndriftmap, dan wordt het /levels/mijndriftmap/info.json.

Laadt de kaart niet, open hem dan in singleplayer, druk op ~ en typ print(getMissionFilename()) voor het exacte pad. Grote zips upload je makkelijker via SFTP dan via de browser.

Stap 4: server-plugins in Lua staan in Resources/Server

Wat in Resources/Server staat, draait alleen op de server. Elke plugin krijgt een eigen submap; alle .lua-bestanden daarin laadt de server bij het starten, in alfabetische volgorde. De taal is Lua 5.3. Een minimaal voorbeeld, Resources/Server/Welkom/main.lua:

function Welkom(player_id)
    MP.SendChatMessage(player_id, "Welkom! Niet crashen in de pits.")
end
MP.RegisterEvent("onPlayerJoining", "Welkom")

onPlayerJoining vuurt zodra een speler alle mods heeft geladen; met -1 als speler-ID stuur je een bericht aan iedereen. Wijzig je een .lua-bestand direct in de pluginmap, dan laadt de server het vanzelf opnieuw.

Stap 5: privé of openbaar, en hoe spelers je vinden

Met Private = true sta je niet in de lijst, maar kan iedereen met je IP-adres en poort verbinden via het tabblad Direct Connect. Een serverwachtwoord kent de huidige config niet; wil je echt dicht, dan kan een Lua-plugin via onPlayerAuth alleen bekende namen toelaten.

Met Private = false meldt de server zich aan bij de lijst en zie je Authenticated! in de console. Spelers zoeken je op naam; vinden ze je niet, dan moeten ze hun filters uitzetten en de kaart op "Any" zetten. Opvallen doe je met opmaakcodes in de naam, zoals ^l voor vet en ^4 voor rood, en met tags als Drift of Racing. Taaltags zijn er onder meer voor Engels en Duits; Nederlands staat er niet tussen.

Veelvoorkomende fouten en wat ze betekenen

• No AuthKey specified: het veld is leeg en de server stopt. Vul de key in (bij MC-Node via Startup).
• AuthKey specified is the wrong length: waarschuwing: de key heeft geen 36 tekens, meestal door een kopieerfout.
• Backend REFUSED the auth key: bij een openbare server weigert de BeamMP-backend de key, met de reden erachter. Draait dezelfde key al op een andere server? Maak anders een nieuwe aan.
• Spelers krijgen 10060 of 10061 in de launcher: thuis is dat port forwarding, de firewall of CGNAT; bij een gehoste server meestal een verkeerd IP-adres of een verkeerde poort.
• Melding "done" of "start" bij het joinen na nieuwe mods: waarschijnlijk een kapotte of incompatibele mod. Haal mods één voor één weg.
• Problemen bij één speler: lokale mods storen die van de server. Laat die speler alles behalve multiplayerbeammp uitzetten.

Hoeveel spelers en auto's? De pc's van je spelers bepalen het

BeamMP noemt als minimum voor de server 50 MiB geheugen, een processor boven 1 GHz en 5 tot 10 Mb/s upload. Het zware werk zit bij de spelers: hun pc rekent ook de auto's van anderen door. Volgens de BeamMP-FAQ is het spel met veel mensen vooral CPU-gebonden, met als vuistregel één auto per CPU-thread. Reken dus MaxPlayers × MaxCars: 8 spelers met elk 2 auto's zijn 16 auto's, volgens die vuistregel te veel voor een processor met 8 threads. Begin met 1 auto per speler; de optie "Use simplified vehicles when available" helpt spelers met een oudere pc.

Aan de serverkant is het kleinste pakket dus bijna altijd genoeg. Een BeamMP-server bij MC-Node begint met Amateur (2 GB RAM, 20 GB NVMe) voor € 3,00 per maand; de reeks loopt door tot Chief (16 GB) voor € 24,00. Groter neem je voor opslag als je veel kaartmods verzamelt, niet omdat BeamMP meer geheugen vraagt. Wat wel telt, zijn upload en ping: nieuwe spelers downloaden alle mods, en de posities van alle auto's gaan continu heen en weer. Kies de locatie het dichtst bij je groep: Hengelo, Frankfurt, Warschau of Beauharnois (Canada). DDoS-bescherming zit erbij en je zegt maandelijks op. Meer over vertraging lees je in Ping, tickrate en serverlocatie.

Wanneer je géén gehuurde server nodig hebt

Speel je af en toe met twee of drie vrienden, draai BeamMP-Server dan gewoon zelf: op Windows is het één BeamMP-Server.exe, voor Linux zijn er builds voor Debian en Ubuntu. Dat kost niets, met deze nadelen:

• Je zet poort 30814 via TCP én UDP door in je router en firewall. Achter CGNAT of op 4G/5G lukt dat niet.
• De server werkt alleen over IPv4.
• Zelf verbind je via Direct Connect op 127.0.0.1, niet via de serverlijst.
• Je vrienden krijgen je thuis-IP-adres, en elke mod-download gaat over jouw upload.
• Staat je pc uit, dan is de server weg.

Een gehuurde server loont zodra je groep groeit, je een openbare server wilt die altijd aan staat, of je je thuisverbinding niet wilt openzetten.

Veelgestelde vragen

Welke poort gebruikt een BeamMP-server?

Standaard poort 30814, via TCP en UDP. In ServerConfig.toml kun je elke vrije poort tussen 1024 en 65535 kiezen. Bij een gehoste server bepaalt het paneel de poort.

Heb ik een AuthKey nodig voor een privé BeamMP-server?

Ja. Zonder AuthKey start de server niet: hij meldt 'No AuthKey specified' en sluit af. De key haal je op in de BeamMP Keymaster met je Discord-account, en één key werkt op één draaiende server tegelijk.

Hoe voeg ik een custom map toe aan mijn BeamMP-server?

Zet de zip van de kaart zonder uitpakken in Resources/Client. Kijk in de zip in de map levels hoe de kaartmap heet en zet Map op /levels/<naam>/info.json. Spelers downloaden de kaart automatisch als ze joinen.

Hoeveel spelers kan een BeamMP-server aan?

De server zelf heeft weinig nodig; de grens ligt bij de pc's van de spelers, die alle auto's doorrekenen. BeamMP hanteert als vuistregel één auto per CPU-thread. BeamMP zet MaxPlayers standaard op 8 en MaxCars op 1.

Verder lezen

• Wat is een DDoS aanval en hoe kan je je server beschermen?
• VPS of gameserver: wat heb je echt nodig?