// BeamMP

Créer un serveur BeamMP : AuthKey, mods, port et joueurs

23 septembre 2026 · 7 min de lecture

Pour créer un serveur BeamMP, vous récupérez une AuthKey dans le BeamMP Keymaster, vous la renseignez avec le nom, le port et la carte dans ServerConfig.toml, vous placez les mods en zip dans Resources/Client et vous démarrez le serveur. Les joueurs se connectent via la liste des serveurs ou en Direct Connect avec l'IP et le port (30814 par défaut). Le serveur lui-même est léger : ce sont les PC de vos joueurs qui déterminent combien de voitures peuvent rouler.

BeamMP, le mod multijoueur de BeamNG.drive

BeamMP ajoute le multijoueur au simulateur de conduite BeamNG.drive. Chaque joueur installe le BeamMP Launcher et a besoin de sa propre copie du jeu, à jour et légale. À côté tourne BeamMP-Server, un programme open source distinct pour Windows et Linux, par lequel tous les joueurs communiquent ; la dernière version est actuellement la v3.9.3, sortie en mai 2026. Après le premier démarrage, le dossier du serveur ressemble à ceci :

Arborescence d'un serveur BeamMP : BeamMP-Server, ServerConfig.toml, Server.log et le dossier Resources avec Client pour les mods et Server pour les plugins Lua — Un serveur BeamMP après le premier démarrage : les mods dans Resources/Client, les plugins dans Resources/Server.

Étape 1 : récupérer une AuthKey dans le Keymaster

Chaque serveur a besoin d'une AuthKey, même un serveur privé. Si le champ est vide, le serveur affiche No AuthKey specified et s'arrête au bout de dix secondes.

Connectez-vous au BeamMP Keymaster (keymaster.beammp.com) avec votre compte Discord.
Cliquez à gauche sur Keys, puis en haut à droite sur le + vert.
Saisissez un nom ; c'est uniquement le nom de la clé, pas celui qui apparaît dans la liste des serveurs.
Copiez la clé : 36 caractères au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Traitez la clé comme un mot de passe. Vous disposez d'un nombre limité de clés, et une clé ne fonctionne que sur un seul serveur en marche à la fois.

Étape 2 : ServerConfig.toml, les champs qui comptent

Voici les valeurs par défaut de la version actuelle, avec seulement le nom, la description et la clé renseignés :

[General]
Name = "Drift du vendredi soir"
Description = "Freeroam et drift entre amis"
AuthKey = "votre-cle-de-36-caracteres"
Port = 30814
Private = true
MaxPlayers = 8
MaxCars = 1
Map = "/levels/gridmap_v2/info.json"
Tags = "Freeroam"
AllowGuests = true
LogChat = true
ResourceFolder = "Resources"

Port : 30814 par défaut, en TCP et en UDP. Tout port entre 1024 et 65535 convient, tant qu'aucun autre programme ne l'utilise.
Private : true garde votre serveur hors de la liste publique, false l'y fait apparaître.
MaxPlayers et MaxCars : nombre maximal de joueurs, et de voitures par joueur. Si quelqu'un en fait apparaître davantage, le serveur les supprime aussitôt.
Map : le chemin vers la carte, toujours /levels/<nom>/info.json.
AllowGuests : autorise ou non les invités (joueurs qui ne se connectent pas à un compte) à rejoindre.

Serveur hébergé chez MC-Node ? Vous renseignez alors le nom, la description, l'AuthKey, Private, MaxPlayers, MaxCars et Map dans l'onglet Startup du panel de jeu. Le panel écrit ces valeurs dans ServerConfig.toml à chaque démarrage ; ce que vous modifiez à la main sur ces lignes disparaît au redémarrage suivant. Le port vient lui aussi du panel et n'est pas forcément 30814. Par défaut, Private y est réglé sur false (public) et Max Players sur 6. Tags et AllowGuests se modifient normalement via Files. Le premier démarrage est expliqué dans la base de connaissances : Comment démarrer un serveur BeamMP ?

Étape 3 : mods et cartes vont en zip dans Resources/Client

Tout ce qui se trouve dans Resources/Client est envoyé automatiquement par le serveur aux joueurs qui rejoignent. Il ne charge que les fichiers qui se terminent par .zip : ne décompressez donc rien.

Mod de véhicule : déposez le zip et redémarrez.
Carte standard : rien à installer, modifiez seulement Map, par exemple en /levels/west_coast_usa/info.json ou /levels/italy/info.json.
Mod de carte : zip dans Resources/Client, ouvrez-le sans le décompresser et regardez dans le dossier levels. Si le sous-dossier s'y appelle madriftmap, cela donne /levels/madriftmap/info.json.

Si la carte ne se charge pas, ouvrez-la en solo, appuyez sur ~ et tapez print(getMissionFilename()) pour obtenir le chemin exact. Les gros zips s'envoient plus facilement via SFTP que par le navigateur.

Étape 4 : les plugins serveur en Lua vont dans Resources/Server

Ce qui se trouve dans Resources/Server ne tourne que sur le serveur. Chaque plugin a son propre sous-dossier ; le serveur charge au démarrage tous les fichiers .lua qu'il contient, par ordre alphabétique. Le langage est Lua 5.3. Un exemple minimal, Resources/Server/Bienvenue/main.lua :

function Bienvenue(player_id)
    MP.SendChatMessage(player_id, "Bienvenue ! Pas de crash dans les stands.")
end
MP.RegisterEvent("onPlayerJoining", "Bienvenue")

onPlayerJoining se déclenche dès qu'un joueur a chargé tous les mods ; avec -1 comme ID de joueur, vous envoyez un message à tout le monde. Si vous modifiez un fichier .lua directement dans le dossier du plugin, le serveur le recharge de lui-même.

Étape 5 : privé ou public, et comment les joueurs vous trouvent

Avec Private = true, vous n'apparaissez pas dans la liste, mais n'importe qui connaissant votre adresse IP et votre port peut se connecter via l'onglet Direct Connect. La config actuelle ne prévoit pas de mot de passe serveur ; pour vraiment fermer l'accès, un plugin Lua peut n'admettre que des noms connus via onPlayerAuth.

Avec Private = false, le serveur s'inscrit dans la liste et vous voyez Authenticated! dans la console. Les joueurs vous cherchent par nom ; s'ils ne vous trouvent pas, ils doivent désactiver leurs filtres et régler la carte sur « Any ». Pour vous démarquer, utilisez des codes de mise en forme dans le nom, comme ^l pour le gras et ^4 pour le rouge, et des tags comme Drift ou Racing. Il existe des tags de langue, entre autres pour l'anglais et l'allemand ; vérifiez si le français en fait partie.

Erreurs courantes et leur signification

No AuthKey specified : le champ est vide et le serveur s'arrête. Renseignez la clé (chez MC-Node via Startup).
AuthKey specified is the wrong length : avertissement : la clé ne fait pas 36 caractères, généralement à cause d'une erreur de copie.
Backend REFUSED the auth key : pour un serveur public, le backend BeamMP refuse la clé et en donne la raison. La même clé tourne peut-être déjà sur un autre serveur ; sinon, créez-en une nouvelle.
Les joueurs obtiennent 10060 ou 10061 dans le launcher : à domicile, c'est la redirection de port, le pare-feu ou le CGNAT ; sur un serveur hébergé, généralement une mauvaise adresse IP ou un mauvais port.
Message « done » ou « start » en rejoignant après l'ajout de mods : probablement un mod cassé ou incompatible. Retirez les mods un par un.
Problèmes chez un seul joueur : ses mods locaux gênent ceux du serveur. Demandez-lui de tout désactiver sauf multiplayerbeammp.

Combien de joueurs et de voitures ? Les PC de vos joueurs décident

BeamMP indique comme minimum pour le serveur 50 Mio de mémoire, un processeur de plus de 1 GHz et 5 à 10 Mbit/s en upload. Le gros du travail se fait chez les joueurs : leur PC calcule aussi les voitures des autres. Selon la FAQ de BeamMP, à plusieurs, le jeu dépend surtout du CPU, avec comme règle empirique une voiture par thread CPU. Calculez donc MaxPlayers × MaxCars : 8 joueurs avec 2 voitures chacun, cela fait 16 voitures, trop pour un processeur à 8 threads selon cette règle. Commencez avec 1 voiture par joueur ; l'option « Use simplified vehicles when available » aide les joueurs qui ont un PC plus ancien.

Côté serveur, la plus petite offre suffit donc presque toujours. Un serveur BeamMP chez MC-Node commence avec Amateur (2 Go de RAM, 20 Go NVMe) à 3,00 € par mois ; la gamme va jusqu'à Chief (16 Go) à 24,00 €. Vous prenez plus grand pour le stockage si vous collectionnez beaucoup de mods de cartes, pas parce que BeamMP demande plus de mémoire. Ce qui compte en revanche, ce sont l'upload et le ping : les nouveaux joueurs téléchargent tous les mods, et les positions de toutes les voitures font sans cesse l'aller-retour. Choisissez l'emplacement le plus proche de votre groupe : Hengelo, Francfort, Varsovie ou Beauharnois (Canada). La protection DDoS est incluse et la résiliation est mensuelle. Pour en savoir plus sur la latence, lisez Ping, tickrate et localisation du serveur.

Quand vous n'avez pas besoin d'un serveur loué

Si vous jouez de temps en temps avec deux ou trois amis, faites simplement tourner BeamMP-Server vous-même : sous Windows, c'est un seul BeamMP-Server.exe, et pour Linux il existe des builds pour Debian et Ubuntu. C'est gratuit, avec ces inconvénients :

Vous devez rediriger le port 30814 en TCP et en UDP dans votre box et votre pare-feu. Derrière un CGNAT ou en 4G/5G, c'est impossible.
Le serveur ne fonctionne qu'en IPv4.
Vous-même, vous vous connectez via Direct Connect sur 127.0.0.1, pas via la liste des serveurs.
Vos amis obtiennent l'adresse IP de votre domicile, et chaque téléchargement de mod passe par votre upload.
Si votre PC est éteint, le serveur disparaît.

Un serveur loué devient intéressant dès que votre groupe s'agrandit, que vous voulez un serveur public toujours allumé, ou que vous ne souhaitez pas ouvrir votre connexion domestique.

Questions fréquentes

Quel port utilise un serveur BeamMP ?

Par défaut le port 30814, en TCP et en UDP. Dans ServerConfig.toml, vous pouvez choisir n'importe quel port libre entre 1024 et 65535. Sur un serveur hébergé, c'est le panel qui fixe le port.

Faut-il une AuthKey pour un serveur BeamMP privé ?

Oui. Sans AuthKey, le serveur ne démarre pas : il affiche « No AuthKey specified » et s'arrête. Vous obtenez la clé dans le BeamMP Keymaster avec votre compte Discord, et une clé ne fonctionne que sur un seul serveur en marche à la fois.

Comment ajouter une carte personnalisée à mon serveur BeamMP ?

Placez le zip de la carte, sans le décompresser, dans Resources/Client. Regardez dans le dossier levels du zip comment s'appelle le dossier de la carte, puis réglez Map sur /levels/<nom>/info.json. Les joueurs téléchargent la carte automatiquement en rejoignant.

Combien de joueurs un serveur BeamMP peut-il accueillir ?

Le serveur lui-même demande peu ; la limite vient des PC des joueurs, qui calculent toutes les voitures. BeamMP applique comme règle empirique une voiture par thread CPU. Par défaut, BeamMP règle MaxPlayers sur 8 et MaxCars sur 1.