FR

Serveurs de jeux

Comment créer son serveur BeamMP

Guide complet pour créer un serveur BeamMP (multijoueur de BeamNG.drive) sur un VPS ou serveur dédié Linux : AuthKey, carte, mods, plugins Lua, service systemd et pare-feu.

13 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

BeamMP est le mod multijoueur communautaire de BeamNG.drive. Ce guide vous explique comment installer son serveur sur votre VPS ou serveur dédié Linux, le faire tourner avec un utilisateur dédié et un service systemd, puis choisir la carte et ajouter des mods et des plugins Lua.

Commander un serveur

BeamMP est léger : ce sont surtout le nombre de joueurs, de véhicules et de mods qui déterminent les ressources nécessaires. HostMyServers propose plusieurs offres adaptées :

Prérequis

  • Accès SSH root ou utilisateur avec sudo
  • Système Linux 64 bits x86_64 : Debian 12/13 ou Ubuntu 22.04/24.04
  • Pare-feu actif : nftables (recommandé), iptables ou ufw (n'utilisez qu'un seul outil de pare-feu à la fois)
  • Une adresse IPv4 publique : le serveur BeamMP ne prend pas encore en charge l'IPv6 pour les joueurs
  • Un compte Discord, pour créer votre AuthKey sur le Keymaster de BeamMP
  • Port 30814 accessible en TCP et en UDP

Chaque joueur doit posséder BeamNG.drive et installer le launcher BeamMP.

Configuration requise

BeamMP publie les valeurs minimales suivantes, hors consommation du système d'exploitation. La colonne de droite est un point de départ conseillé, à ajuster selon votre usage.

Composant Minimum officiel Point de départ conseillé
RAM 50 Mio disponibles 2 Go
CPU Plus de 1 GHz, de préférence multicœur 2 cœurs
Stockage 10 Mio, plus les mods et plugins 10 Go SSD, davantage avec de nombreux mods
Réseau 5 à 10 Mbit/s en envoi 100 Mbit/s
Carte graphique Aucune Aucune

Mise à jour du système

Terminal
sudo apt update && sudo apt upgrade -y

Installation des dépendances

BeamMP demande la bibliothèque Lua 5.3 (liblua5.3-0). Les autres paquets servent au téléchargement, aux mods et aux sauvegardes :

Terminal
sudo apt install -y liblua5.3-0 curl tar unzip nano cron

Création d'un utilisateur dédié

BeamMP déconseille de lancer le serveur en root ou avec votre compte personnel. Créez un utilisateur dédié :

Terminal
sudo adduser --disabled-password --gecos "" beammp

Ports utilisés

Port Protocole Utilisation
30814 TCP Connexion des joueurs, téléchargement des mods
30814 UDP Données de jeu en temps réel

BeamMP n'a ni RCON ni interface web : vous n'avez aucun port d'administration à ouvrir. La console reste accessible uniquement depuis le serveur (voir Administration).

Configuration du pare-feu

Avec UFW

Terminal
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reload

Avec iptables

Terminal
sudo iptables -A INPUT -p tcp --dport 30814 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30814 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

La sauvegarde des règles au redémarrage nécessite le paquet iptables-persistent.

Avec nftables

Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.

Terminal
sudo nft add rule inet filter input tcp dport 30814 accept
sudo nft add rule inet filter input udp dport 30814 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Création de l'AuthKey

L'AuthKey identifie votre serveur auprès de BeamMP. Le serveur refuse de démarrer sans elle, même s'il reste privé.

  1. Rendez-vous sur le Keymaster de BeamMP et connectez-vous avec Discord.
  2. Ouvrez la section Keys.
  3. Cliquez sur le bouton vert +.
  4. Saisissez un nom de serveur, puis cliquez sur Create.
  5. Copiez la clé obtenue.

Installation du serveur

Connectez-vous avec l'utilisateur beammp et créez le dossier du serveur :

Terminal
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-server

Téléchargez la dernière version pour votre système. La première ligne détecte votre distribution, pour obtenir par exemple debian.12 ou ubuntu.24.04 :

Terminal
. /etc/os-release
curl -fL -o BeamMP-Server "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server

Lancez le serveur une première fois pour générer sa configuration :

Terminal
./BeamMP-Server

Configuration du serveur

Ouvrez le fichier de configuration :

Terminal
nano ~/beammp-server/ServerConfig.toml

Modifiez au minimum ces valeurs dans la section [General], sans toucher aux autres lignes. L'ordre des lignes dans votre fichier peut être différent :

Configuration
[General]
AuthKey = "COLLEZ_VOTRE_CLE_ICI"
Name = "Mon serveur BeamMP"
Description = "Bienvenue sur mon serveur"
Tags = "Freeroam,Lang:French"
Map = "/levels/west_coast_usa/info.json"
MaxPlayers = 8
MaxCars = 2
Private = true
AllowGuests = false

Protégez ensuite ce fichier, qui contient votre clé, puis quittez la session de l'utilisateur beammp :

Terminal
chmod 600 ~/beammp-server/ServerConfig.toml
exit

Paramètres principaux

Paramètre Valeur par défaut Description
AuthKey vide Clé créée sur le Keymaster (obligatoire)
Name BeamMP Server Nom affiché dans la liste des serveurs (250 caractères au maximum)
Description BeamMP Default Description Description du serveur (1000 caractères au maximum)
Tags Freeroam Tags de recherche séparés par des virgules (100 caractères au maximum)
Map /levels/gridmap_v2/info.json Carte hébergée
MaxPlayers 8 Nombre maximum de joueurs
MaxCars 1 Nombre maximum de véhicules par joueur
Port 30814 Port TCP et UDP du serveur
Private true true masque le serveur de la liste publique, false l'y publie
AllowGuests true Autorise les joueurs connectés sans compte BeamMP
LogChat true Enregistre le chat dans les journaux
Debug false Journaux détaillés, beaucoup plus volumineux
ResourceFolder Resources Dossier des mods et plugins

Si vous changez Port, adaptez aussi les règles du pare-feu.

Mise en forme du nom

Name et Description acceptent des codes de mise en forme, placés devant le texte : ^l gras, ^o italique, ^n souligné, ^r réinitialisation, ^4 rouge, ^2 vert, ^e jaune, ^f blanc. Par exemple : Name = "^l^4Mon serveur ^r^fBeamMP". La documentation de BeamMP donne la liste complète, ainsi que celle des tags reconnus.

Choisir la carte

Indiquez le chemin de la carte dans le paramètre Map. Les cartes fournies avec le jeu ne demandent aucune installation :

Carte Valeur de Map
Grid Map /levels/gridmap_v2/info.json
Small Grid /levels/smallgrid/info.json
West Coast USA /levels/west_coast_usa/info.json
East Coast USA /levels/east_coast_usa/info.json
Utah /levels/utah/info.json
Italy /levels/italy/info.json
Jungle Rock Island /levels/jungle_rock_island/info.json
Johnson Valley /levels/johnson_valley/info.json
Hirochi Raceway /levels/hirochi_raceway/info.json
Automation Test Track /levels/automation_test_track/info.json
Industrial /levels/industrial/info.json
Small Island /levels/small_island/info.json
Driver Training /levels/driver_training/info.json
Derby /levels/derby/info.json

Configuration en tant que service systemd

Le service ci-dessous démarre BeamMP automatiquement. Il est associé à un petit canal local (/run/beammp.stdin) qui permet d'envoyer des commandes à la console du serveur.

Créer le canal de la console

Terminal
sudo nano /etc/systemd/system/beammp.socket
Configuration
[Unit]
Description=BeamMP Server console
PartOf=beammp.service

[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=true

Créer le fichier de service

Terminal
sudo nano /etc/systemd/system/beammp.service
Configuration
[Unit]
Description=BeamMP Server
Wants=network-online.target
After=network-online.target beammp.socket
Requires=beammp.socket

[Service]
Type=simple
User=beammp
Group=beammp
WorkingDirectory=/home/beammp/beammp-server
ExecStart=/home/beammp/beammp-server/BeamMP-Server
Sockets=beammp.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
Restart=on-failure
RestartSec=10
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

Activer et démarrer le service

Terminal
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.service

Commandes de gestion

Terminal
# Vérifier le statut
sudo systemctl status beammp.service

# Arrêter le serveur
sudo systemctl stop beammp.service

# Redémarrer le serveur
sudo systemctl restart beammp.service

# Voir les logs
sudo journalctl -u beammp.service -f

Vérifier le fonctionnement

Le serveur est prêt lorsque les logs affichent ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY :

Terminal
sudo journalctl -u beammp.service -n 30 --no-pager

Vérifiez qu'il écoute bien en TCP et en UDP :

Terminal
sudo ss -tulpn | grep 30814

Vous devez obtenir une ligne tcp et une ligne udp associées à BeamMP-Server. Avec Private = false, les logs doivent aussi afficher Authenticated!.

Connexion au serveur

  1. Lancez le launcher BeamMP, qui démarre BeamNG.drive.
  2. Ouvrez le menu multijoueur de BeamMP.
  3. Utilisez Direct Connect, puis saisissez IP_DU_SERVEUR et le port 30814.

Si le serveur est public (Private = false), les joueurs peuvent aussi le chercher par son nom dans la liste. Ils doivent alors désactiver les filtres et régler la carte sur Any.

Ajouter des mods

Les mods de véhicules et de cartes se placent, au format .zip, dans Resources/Client. Ne les décompressez pas. Les joueurs les téléchargent automatiquement en rejoignant le serveur.

Depuis votre ordinateur, envoyez le mod sur le serveur avec votre compte administrateur :

Terminal
scp mon_mod.zip VOTRE_USER@IP_DU_SERVEUR:/tmp/

Sur le serveur, installez-le puis redémarrez BeamMP :

Terminal
sudo install -o beammp -g beammp -m 644 /tmp/mon_mod.zip /home/beammp/beammp-server/Resources/Client/
sudo rm /tmp/mon_mod.zip
sudo systemctl restart beammp.service

Utiliser une carte moddée

Le fichier .zip de la carte contient un dossier levels/<nom_de_la_carte>. Retrouvez ce nom :

Terminal
unzip -l /home/beammp/beammp-server/Resources/Client/ma_carte.zip | grep 'levels/.*/info.json'

Si la ligne affichée contient levels/ma_carte/info.json, modifiez ServerConfig.toml :

Configuration
Map = "/levels/ma_carte/info.json"

Redémarrez ensuite le service. Si le fichier info.json est introuvable dans l'archive, chargez la carte en solo dans BeamNG.drive, ouvrez la console avec ~ et exécutez print(getMissionFilename()) pour obtenir le chemin exact.

Ajouter des plugins Lua

Les plugins s'exécutent sur le serveur. Chacun possède son propre dossier dans Resources/Server :

Texte
Resources/
├── Client/              Mods envoyés aux joueurs (.zip)
└── Server/
    └── Bienvenue/       Un dossier par plugin
        └── main.lua

Tous les fichiers .lua placés directement dans le dossier du plugin sont chargés au démarrage, par ordre alphabétique. Le serveur recharge automatiquement un plugin lorsque l'un de ces fichiers est modifié. Les sous-dossiers ne sont pas chargés automatiquement : utilisez require(). La référence des plugins détaille les événements et les fonctions disponibles.

Exemple : message de bienvenue

Terminal
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Bienvenue
nano ~/beammp-server/Resources/Server/Bienvenue/main.lua
lua
function onInit()
    print("Plugin Bienvenue chargé")
end

function surArriveeJoueur(player_id)
    MP.SendChatMessage(player_id, "Bienvenue sur le serveur !")
end

MP.RegisterEvent("onPlayerJoin", "surArriveeJoueur")

Exemple : liste blanche

Ce plugin n'accepte que les pseudos BeamMP de la liste et refuse les invités. Toujours avec l'utilisateur beammp :

Terminal
mkdir -p ~/beammp-server/Resources/Server/ListeBlanche
nano ~/beammp-server/Resources/Server/ListeBlanche/main.lua
lua
local joueursAutorises = {
    ["Pseudo1"] = true,
    ["Pseudo2"] = true,
}

function verifierJoueur(nom, role, invite, identifiants)
    if invite or not joueursAutorises[nom] then
        return "Ce serveur est réservé aux joueurs autorisés."
    end
end

MP.RegisterEvent("onPlayerAuth", "verifierJoueur")

Quittez ensuite la session de l'utilisateur beammp et redémarrez le serveur, car un nouveau plugin n'est pas détecté à chaud :

Terminal
exit
sudo systemctl restart beammp.service

Le message Plugin Bienvenue chargé doit apparaître dans les logs.

Administration

Envoyer des commandes à la console

Créez une petite commande pour écrire dans la console et afficher sa réponse :

Terminal
sudo nano /usr/local/bin/beammp-cmd
Terminal
#!/bin/bash
if [ ! -p /run/beammp.stdin ]; then
    echo "Le serveur BeamMP n'est pas démarré." >&2
    exit 1
fi
echo "$*" > /run/beammp.stdin
sleep 1
journalctl -u beammp.service -n 15 --no-pager -o cat
Terminal
sudo chmod 755 /usr/local/bin/beammp-cmd

Vous pouvez ensuite lancer, par exemple :

Terminal
sudo beammp-cmd list
sudo beammp-cmd say Redémarrage dans 5 minutes

Commandes disponibles

Commande Description
help Affiche l'aide
list Liste les joueurs connectés
status Affiche l'état du serveur
say <message> Envoie un message à tous les joueurs
kick <nom> [raison] Expulse un joueur
version Affiche la version du serveur
reloadmods Recharge les mods de Resources/Client
protectmod <fichier.zip> <true/false> Protège un mod payant ou privé : il n'est plus envoyé aux joueurs, qui doivent se le procurer eux-mêmes
settings help Affiche l'aide pour consulter ou modifier les réglages

Pour arrêter le serveur, utilisez sudo systemctl stop beammp.service.

Mise à jour du serveur

BeamMP ne se met pas à jour automatiquement. Les nouvelles versions sont annoncées sur la page des releases. Vérifiez votre version avec sudo beammp-cmd version.

Téléchargez la nouvelle version à côté de l'ancienne :

Terminal
sudo -iu beammp
cd ~/beammp-server
. /etc/os-release
curl -fL -o BeamMP-Server.new "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server.new
exit

Remplacez ensuite l'exécutable, puis redémarrez :

Terminal
sudo systemctl stop beammp.service
sudo -u beammp mv /home/beammp/beammp-server/BeamMP-Server.new /home/beammp/beammp-server/BeamMP-Server
sudo systemctl start beammp.service

Si vous changez de version de Debian ou d'Ubuntu, refaites cette procédure : l'exécutable dépend de la distribution.

Sauvegarde automatique

Il suffit de sauvegarder la configuration et le dossier Resources.

Script de sauvegarde

Terminal
sudo nano /home/beammp/backup.sh
Terminal
#!/bin/bash
umask 077
BACKUP_DIR="/home/beammp/backups"
SERVER_DIR="/home/beammp/beammp-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p "$BACKUP_DIR"

# Sauvegarde de la configuration, des mods et des plugins
tar -czf "$BACKUP_DIR/beammp_$DATE.tar.gz" -C "$SERVER_DIR" ServerConfig.toml Resources

# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "beammp_*.tar.gz" -mtime +7 -delete

echo "Sauvegarde terminée : beammp_$DATE.tar.gz"
Terminal
sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.sh

Planifier la sauvegarde

Terminal
sudo crontab -u beammp -e

Ajoutez :

Texte
# Sauvegarde tous les jours à 5 h
0 5 * * * /home/beammp/backup.sh

En cas de problème

Le serveur ne démarre pas

Consultez les logs :

Terminal
sudo journalctl -u beammp.service -n 100 --no-pager

Le fichier /home/beammp/beammp-server/Server.log contient les mêmes informations et ne contient pas votre AuthKey. Il est utile pour demander de l'aide à la communauté BeamMP.

Message Cause et solution
No AuthKey specified La clé est absente de ServerConfig.toml
AuthKey specified is the wrong length La clé est incomplète ou mal copiée
Backend REFUSED the auth key La clé est refusée par BeamMP : vérifiez-la sur le Keymaster, ou vérifiez qu'elle n'est pas déjà utilisée par un autre serveur
Error parsing config file value Erreur de syntaxe, souvent des guillemets manquants, ou fichier illisible : vérifiez que son propriétaire est beammp
bind() failed: Address already in use Un autre programme utilise déjà le port : identifiez-le avec sudo ss -tulpn | grep 30814

Si ServerConfig.toml n'appartient plus à beammp, corrigez ses droits :

Terminal
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.toml

Erreur GLIBC_ ou cannot execute binary file

L'exécutable ne correspond pas à votre système. Vérifiez votre version avec cat /etc/os-release, puis téléchargez de nouveau le fichier adapté. Les exécutables proposés dans ce guide visent les processeurs x86_64.

Les joueurs ne peuvent pas se connecter

Les codes d'erreur 10060, 10061 ou 10030 côté joueur indiquent le plus souvent que le serveur n'est pas joignable ou que l'adresse saisie est fausse.

  • Vérifiez que le service est actif : sudo systemctl status beammp.service
  • Vérifiez que le port écoute en TCP et en UDP : sudo ss -tulpn | grep 30814
  • Vérifiez les règles du pare-feu, pour les deux protocoles
  • Vérifiez que le joueur utilise bien l'adresse IPv4 du serveur
  • Les VPN du type Hamachi ou RadminVPN ne sont pas pris en charge

Le serveur n'apparaît pas dans la liste

  • Vérifiez que Private = false
  • Cherchez Authenticated! ou Backend REFUSED the auth key dans les logs
  • Dans le jeu, désactivez les filtres et réglez la carte sur Any

Connexion bloquée après l'ajout d'un mod

Un mod est probablement incompatible, endommagé ou en conflit avec un autre. Retirez les mods un par un de Resources/Client, en redémarrant le serveur à chaque fois, pour trouver le fautif.

La carte ne se charge pas

  • Vérifiez le chemin dans Map, qui doit se terminer par /info.json
  • Pour une carte moddée, vérifiez que son .zip se trouve dans Resources/Client

Le serveur BeamMP n'est pas démarré avec beammp-cmd

Le canal de la console n'existe que lorsque le service tourne. Démarrez-le avec sudo systemctl start beammp.service.

Une AuthKey a été exposée

Si votre clé a fuité, BeamMP indique d'ouvrir un ticket Account Support sur son Discord officiel.