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.
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 :
- VPS NVMe - Pour un serveur entre amis ou un serveur de test
- VPS Performance - Ressources dédiées, pour un serveur public
- Serveurs dédiés Eco - Pour une communauté active ou de nombreux mods
- Serveurs dédiés Performance - Performance maximale
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
sudo apt update && sudo apt upgrade -yInstallation 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 :
sudo apt install -y liblua5.3-0 curl tar unzip nano cronCré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é :
sudo adduser --disabled-password --gecos "" beammpPorts 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
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reloadAvec iptables
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.v4La 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.
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.confCré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é.
- Rendez-vous sur le Keymaster de BeamMP et connectez-vous avec Discord.
- Ouvrez la section Keys.
- Cliquez sur le bouton vert +.
- Saisissez un nom de serveur, puis cliquez sur Create.
- Copiez la clé obtenue.
Installation du serveur
Connectez-vous avec l'utilisateur beammp et créez le dossier du serveur :
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-serverTé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 :
. /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-ServerLancez le serveur une première fois pour générer sa configuration :
./BeamMP-ServerConfiguration du serveur
Ouvrez le fichier de configuration :
nano ~/beammp-server/ServerConfig.tomlModifiez au minimum ces valeurs dans la section [General], sans toucher aux autres lignes. L'ordre des lignes dans votre fichier peut être différent :
[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 = falseProtégez ensuite ce fichier, qui contient votre clé, puis quittez la session de l'utilisateur beammp :
chmod 600 ~/beammp-server/ServerConfig.toml
exitParamè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
sudo nano /etc/systemd/system/beammp.socket[Unit]
Description=BeamMP Server console
PartOf=beammp.service
[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=trueCréer le fichier de service
sudo nano /etc/systemd/system/beammp.service[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.targetActiver et démarrer le service
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.serviceCommandes de gestion
# 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 -fVérifier le fonctionnement
Le serveur est prêt lorsque les logs affichent ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY :
sudo journalctl -u beammp.service -n 30 --no-pagerVérifiez qu'il écoute bien en TCP et en UDP :
sudo ss -tulpn | grep 30814Vous 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
- Lancez le launcher BeamMP, qui démarre BeamNG.drive.
- Ouvrez le menu multijoueur de BeamMP.
- Utilisez Direct Connect, puis saisissez
IP_DU_SERVEURet le port30814.
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 :
scp mon_mod.zip VOTRE_USER@IP_DU_SERVEUR:/tmp/Sur le serveur, installez-le puis redémarrez BeamMP :
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.serviceUtiliser une carte moddée
Le fichier .zip de la carte contient un dossier levels/<nom_de_la_carte>. Retrouvez ce nom :
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 :
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 :
Resources/
├── Client/ Mods envoyés aux joueurs (.zip)
└── Server/
└── Bienvenue/ Un dossier par plugin
└── main.luaTous 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
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Bienvenue
nano ~/beammp-server/Resources/Server/Bienvenue/main.luafunction 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 :
mkdir -p ~/beammp-server/Resources/Server/ListeBlanche
nano ~/beammp-server/Resources/Server/ListeBlanche/main.lualocal 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 :
exit
sudo systemctl restart beammp.serviceLe 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 :
sudo nano /usr/local/bin/beammp-cmd#!/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 catsudo chmod 755 /usr/local/bin/beammp-cmdVous pouvez ensuite lancer, par exemple :
sudo beammp-cmd list
sudo beammp-cmd say Redémarrage dans 5 minutesCommandes 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 :
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
exitRemplacez ensuite l'exécutable, puis redémarrez :
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.serviceSi 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
sudo nano /home/beammp/backup.sh#!/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"sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.shPlanifier la sauvegarde
sudo crontab -u beammp -eAjoutez :
# Sauvegarde tous les jours à 5 h
0 5 * * * /home/beammp/backup.shEn cas de problème
Le serveur ne démarre pas
Consultez les logs :
sudo journalctl -u beammp.service -n 100 --no-pagerLe 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 :
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.tomlErreur 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!ouBackend REFUSED the auth keydans 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
.zipse trouve dansResources/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.