Comment ajouter des voitures moddées à son serveur BeamMP ?

Contexte

Vous gérez un serveur BeamMP chez Winheberg et vous voulez ajouter de nouvelles voitures à votre serveur pour que vos joueurs puissent rouler avec autre chose que les véhicules de base ? Que ce soit une supercar, un camion, une voiture de rallye, ou n'importe quel autre véhicule moddé de la communauté, l'installation se fait en moins de 5 minutes via votre panel gaming.

Bonne nouvelle, contrairement à l'installation d'une carte moddée, ajouter une voiture est encore plus simple. Pas de chemin à configurer dans Startup, juste un upload et un redémarrage du serveur.

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 voiture que vous voulez installer
Une source fiable pour télécharger le mod (BeamNG.drive Repository officiel, forums BeamMP, modders reconnus)

Téléchargez vos voitures moddées uniquement depuis des sources de confiance. 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 voiture sur votre serveur

Comme pour les cartes, le fichier de votre voiture doit être placé dans un dossier précis pour être détecté par BeamMP et envoyé aux joueurs.

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-voiture.zip

Le panel impose une limite de 100 Mo par upload via l'interface web. Si votre .zip dépasse cette limite, vous devrez passer par une connexion SFTP pour téléverser votre mod. 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. Vos joueurs téléchargeront donc le mod la première fois qu'ils rejoindront le serveur après votre ajout.

2. Redémarrer votre serveur

C'est tout ce qu'il y a à faire au niveau configuration. Contrairement aux cartes moddées, aucun chemin n'est à modifier dans Startup. BeamMP détecte automatiquement les voitures présentes dans Resources/Client et les rend disponibles aux joueurs.

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

Une fois le serveur redémarré, le mod est actif et sera envoyé automatiquement à vos joueurs à leur prochaine connexion.

3. Vérifier que la voiture est bien disponible

Pour tester que tout fonctionne correctement.

Connectez-vous au serveur depuis votre client BeamMP in-game
Au premier lancement, BeamMP va télécharger automatiquement le mod sur votre client (cela peut prendre quelques secondes à plusieurs minutes selon la taille)
Une fois le téléchargement terminé, ouvrez le menu véhicules dans BeamNG.drive
Votre nouvelle voiture devrait apparaître dans la liste, prête à être sélectionnée

Si vous ne voyez pas la voiture dans la liste, vérifiez d'abord que le téléchargement s'est bien terminé. Une icône de chargement ou un message d'erreur peut apparaître si quelque chose s'est mal passé côté client.

En cas de problème

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

❌ La voiture n'apparaît pas dans le menu in-game

Plusieurs causes possibles. Vérifiez les points suivants.

Le fichier .zip est bien dans Resources/Client et pas dans Server ou ailleurs
Le .zip n'a pas été décompressé par erreur
Vous avez bien redémarré le serveur après l'upload (un simple restart d'une ressource ne suffit pas)
Vos joueurs ont bien terminé le téléchargement du mod sur leur client BeamMP

❌ Le téléchargement du mod échoue côté joueur

Si vos joueurs voient une erreur de téléchargement quand ils se connectent.

Le fichier .zip est peut-être corrompu, essayez de le re-télécharger depuis sa source
Le mod est peut-être incompatible avec BeamMP (certains mods solo ne sont pas adaptés au multijoueur)
Le .zip est peut-être trop volumineux et provoque un timeout chez certains joueurs avec une connexion lente

❌ Le serveur crash après l'ajout du mod

Si votre serveur ne démarre plus ou crash juste après l'ajout, le mod est probablement défectueux ou incompatible avec la version de BeamMP que vous utilisez. Retirez le fichier .zip du dossier Resources/Client et redémarrez pour confirmer. Si le serveur redémarre correctement sans le mod, c'est bien lui le coupable.

❌ La voiture apparaît mais a des bugs graphiques ou physiques

Certains mods sont conçus uniquement pour le mode solo de BeamNG.drive et ne sont pas adaptés au multijoueur (textures manquantes, physique désynchronisée, etc.). Vérifiez sur la page du mod s'il est explicitement compatible BeamMP, ou essayez de le remplacer par une version multi-compatible.

Bonnes pratiques

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

Sauvegardez votre serveur avant d'ajouter plusieurs mods en même temps
Testez chaque mod individuellement avant d'en ajouter plusieurs en cascade. Si un problème survient, vous saurez immédiatement quel mod est responsable
Surveillez la taille totale de vos mods, plus vous en ajoutez, plus le téléchargement initial pour vos joueurs sera long
Privilégiez les mods optimisés multijoueur pour éviter les lags et désynchronisations
Mettez à jour vos mods régulièrement si les auteurs publient de nouvelles versions corrigeant des bugs

Vous pouvez ajouter plusieurs voitures en une seule fois en glissant tous les .zip ensemble dans Resources/Client. Un seul redémarrage suffit ensuite pour activer toutes les nouvelles voitures.

Besoin d'aide ?

Si vos voitures moddées ne se chargent pas correctement, ou si votre serveur rencontre un problème après l'ajout d'un mod, 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 du mod concerné.

Votre serveur BeamMP est prêt à offrir un garage bien plus varié à vos joueurs, bonne route 🚗