Comment installer une carte moddée sur son serveur BeamMP ?

Contexte

Vous gérez un serveur BeamMP chez Winheberg et vous voulez sortir de la map par défaut pour proposer à vos joueurs un terrain plus original ? Que ce soit pour rouler sur Bajarama, Roane County, Garfield Heights, ou n'importe quelle autre map de la communauté, l'installation se fait en quelques minutes via votre panel gaming.

Ce guide vous explique pas à pas comment ajouter une carte moddée à votre serveur BeamMP, comment identifier correctement son nom interne (l'erreur la plus fréquente), et que faire si la map ne se charge pas.

Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants.

Un serveur BeamMP actif sur votre panel gaming Winheberg
Le fichier .zip de la carte que vous voulez installer
Une source fiable pour télécharger la map (BeamNG.drive Repository officiel, forums BeamMP, etc.)

Téléchargez vos cartes uniquement depuis des sources de confiance. Comme pour les mods en général, des fichiers .zip peuvent contenir du code malveillant ou des fichiers vérolés. Privilégiez le repository officiel BeamNG ou des créateurs reconnus de la communauté.

1. Téléverser la carte sur votre serveur

Le fichier de carte doit être placé dans un dossier précis pour être détecté par BeamMP.

Connectez-vous à votre panel gaming Winheberg
Sélectionnez votre serveur BeamMP
Dans le menu latéral, cliquez sur Files
Naviguez jusqu'au dossier Resources, puis Client
Glissez-déposez votre fichier .zip dans ce dossier (ne le décompressez pas, BeamMP lit directement les archives)

Le chemin complet doit ressembler à ceci.

/home/container/Resources/Client/votre-map.zip

Le panel impose une limite de 100 Mo par upload via l'interface web. La plupart des cartes BeamMP dépassent largement cette limite. Si votre .zip fait plus de 100 Mo, vous devrez passer par une connexion SFTP pour téléverser votre map. Vos identifiants SFTP sont disponibles dans la section Settings de votre serveur (host, port, username), et le mot de passe est identique à celui de votre compte panel. Utilisez un client comme FileZilla ou WinSCP pour vous connecter et déposer votre fichier directement dans Resources/Client.

Le dossier Client est spécifique aux ressources envoyées automatiquement aux joueurs lors de leur connexion. Ne confondez pas avec le dossier Server qui contient les scripts côté serveur.

2. Identifier le nom interne de la carte

C'est l'étape la plus importante, et celle qui pose le plus de problèmes aux débutants. Le nom du fichier .zip n'est pas le nom de la carte dont a besoin BeamMP. Vous devez trouver le nom interne utilisé par le moteur du jeu.

Méthode 1, depuis le site de téléchargement

La plupart des sites qui distribuent des cartes BeamNG indiquent le nom interne de la map dans la description, souvent sous la forme levels/nom_interne/info.json. C'est cette information qu'il vous faut.

Méthode 2, inspecter le contenu du .zip

Si l'info n'est pas disponible sur le site, ouvrez le fichier .zip avec un logiciel d'archive (sans le décompresser). Vous y trouverez une structure de dossiers ressemblant à ceci.

levels/
  └── nom_de_la_map/
        ├── info.json
        ├── main.terrain.json
        └── ...

Le nom du dossier sous levels/ est exactement le nom interne dont vous avez besoin.

Exemples concrets

Voici quelques exemples pour vous aider à visualiser.

Carte	Nom interne	Chemin complet
Map par défaut	`gridmap_v2`	`levels/gridmap_v2/info.json`
Bajarama	`bajarama`	`levels/bajarama/info.json`
Roane County	`roane_county`	`levels/roane_county/info.json`

3. Configurer le chemin de la carte dans le panel

Une fois le nom interne identifié, il faut indiquer à BeamMP qu'il doit charger cette carte au démarrage.

Dans le menu latéral du panel, cliquez sur Startup
Repérez le champ Map
Remplacez la valeur actuelle par le chemin complet de votre carte, au format levels/nom_interne/info.json

Par exemple, pour la carte Bajarama.

levels/bajarama/info.json

Sauvegardez les modifications

Le format attendu est toujours levels/NOM/info.json. Pas de barre oblique au début, pas de chemin absolu, pas d'extension .zip. Si vous mettez autre chose, le serveur ne trouvera pas la map et reviendra sur la map par défaut (ou refusera de démarrer).

4. Redémarrer votre serveur

Pour que les changements soient pris en compte, vous devez redémarrer votre serveur BeamMP.

Retournez sur la page principale de votre serveur dans le panel
Cliquez sur Restart (ou Stop puis Start si nécessaire)
Surveillez la console pour vous assurer que le serveur démarre correctement avec la nouvelle map

Si la map se charge sans erreur dans les logs, vous pouvez vous connecter au serveur depuis votre client BeamMP pour la tester en jeu.

En cas de problème

Voici les erreurs les plus fréquentes lors de l'installation d'une carte moddée.

❌ Le serveur démarre mais charge la map par défaut

Le chemin que vous avez indiqué dans le champ Map est incorrect. Vérifiez les points suivants.

Le nom interne de la map est bien orthographié (sensible à la casse, pas d'espace)
Le format est exactement levels/NOM/info.json, sans barre oblique au début
Le fichier .zip est bien dans Resources/Client et pas ailleurs

❌ Erreur de chargement de la map dans la console

Si vous voyez une erreur du type "Could not find level" ou "Map not found" dans la console, le serveur n'arrive pas à lire le fichier. Vérifiez les points suivants.

Le fichier .zip n'est pas corrompu (essayez de l'ouvrir avec un logiciel d'archive)
Le .zip contient bien un dossier levels/ à sa racine
Vous n'avez pas décompressé le .zip par erreur (BeamMP a besoin de l'archive intacte)

❌ La map fonctionne en solo mais pas sur le serveur

Certaines cartes sont conçues uniquement pour le mode solo de BeamNG.drive et ne sont pas adaptées au multijoueur (objets non synchronisés, scripts incompatibles, etc.). Vérifiez sur la page de la map si elle est explicitement compatible BeamMP.

❌ Mes joueurs ne peuvent pas se connecter après l'ajout

Le fichier .zip est peut-être trop volumineux pour être téléchargé rapidement par vos joueurs. Vérifiez les points suivants.

La taille du fichier est raisonnable (au-delà de 500 Mo, certains joueurs peuvent avoir des timeouts)
Vos joueurs disposent d'une connexion suffisamment stable pour télécharger la map au premier lancement
Le serveur n'est pas surchargé en bande passante au moment des connexions

Bonnes pratiques

Quelques recommandations pour gérer vos cartes moddées sereinement.

Sauvegardez votre serveur avant chaque changement de map, surtout si vous avez beaucoup de mods qui dépendent de la map actuelle
Testez la map en solo dans BeamNG.drive avant de la déployer sur votre serveur pour vérifier qu'elle se charge sans erreur
Prévenez vos joueurs d'un changement de map, surtout si la nouvelle carte est lourde à télécharger
Limitez le nombre de maps actives, un serveur BeamMP charge une seule map à la fois, mais avoir plusieurs .zip dans Resources/Client augmente la taille du téléchargement initial pour les joueurs
Privilégiez les maps optimisées multijoueur pour éviter les lags et désynchronisations

Besoin d'aide ?

Si votre carte ne se charge pas malgré ces étapes, ou si vous rencontrez une erreur dans la console que vous ne savez pas interpréter, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client, renseignez le champ Produit lié avec le serveur concerné, et joignez les logs de démarrage du serveur ainsi que le nom exact de la map que vous essayez d'installer.

Votre serveur BeamMP est prêt à accueillir vos joueurs sur une nouvelle map, bonne route 🛣️