[{"data":1,"prerenderedAt":41},["ShallowReactive",2],{"doc-fr-ajouter-carte-moddee-beammp":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":27,"docGroup":38,"docGroupIcon":38,"link_en":39,"bodyHtml":40},"\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fajouter-carte-moddee-beammp","ajouter-carte-moddee-beammp","Comment installer une carte moddée sur son serveur BeamMP ?","Apprenez à installer une carte moddée sur votre serveur BeamMP depuis le panel gaming Winheberg. Upload dans Resources\u002FClient, configuration du chemin Map dans Startup, et résolution des erreurs courantes.","jeux","beammp","tabler:file-text","2026-07-24","Winheberg",20,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fajouter-carte-moddee-beammp.webp",[16,17,18,19,20,21,22,23,24,25,26],"BeamMP","Carte","Map","Mod","Installation","Resources","Client","Startup","Panel","Tutoriel","Gaming",[28,29,30,31,32,33,34,35,36,37],"installer carte BeamMP","map moddée BeamMP","mod map BeamMP","Resources Client BeamMP","levels info.json BeamMP","Bajarama BeamMP","Gridmap BeamMP","configuration map BeamMP","panel BeamMP map","ajouter carte BeamMP","","\u002Fen\u002Fdocs\u002Fbeammp\u002Fadd-modded-map-beammp","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Vous gérez un \u003Cstrong>serveur BeamMP\u003C\u002Fstrong> 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 \u003Cstrong>Bajarama\u003C\u002Fstrong>, \u003Cstrong>Roane County\u003C\u002Fstrong>, \u003Cstrong>Garfield Heights\u003C\u002Fstrong>, ou n'importe quelle autre map de la communauté, l'installation se fait en quelques minutes via votre panel gaming.\u003C\u002Fp>\n\u003Cp>Ce guide vous explique pas à pas comment \u003Cstrong>ajouter une carte moddée\u003C\u002Fstrong> à votre serveur BeamMP, comment \u003Cstrong>identifier correctement son nom interne\u003C\u002Fstrong> (l'erreur la plus fréquente), et que faire si la map ne se charge pas.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cp>Avant de commencer, assurez-vous d'avoir les éléments suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Un \u003Cstrong>serveur BeamMP\u003C\u002Fstrong> actif sur votre panel gaming Winheberg\u003C\u002Fli>\n\u003Cli>Le \u003Cstrong>fichier \u003Ccode>.zip\u003C\u002Fcode>\u003C\u002Fstrong> de la carte que vous voulez installer\u003C\u002Fli>\n\u003Cli>Une \u003Cstrong>source fiable\u003C\u002Fstrong> pour télécharger la map (BeamNG.drive Repository officiel, forums BeamMP, etc.)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Téléchargez vos cartes \u003Cstrong>uniquement depuis des sources de confiance\u003C\u002Fstrong>. Comme pour les mods en général, des fichiers \u003Ccode>.zip\u003C\u002Fcode> 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é.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Téléverser la carte sur votre serveur\u003C\u002Fh2>\n\u003Cp>Le fichier de carte doit être placé dans un dossier précis pour être détecté par BeamMP.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Connectez-vous à votre \u003Cstrong>panel gaming Winheberg\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Sélectionnez votre \u003Cstrong>serveur BeamMP\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Dans le menu latéral, cliquez sur \u003Cstrong>Files\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Naviguez jusqu'au dossier \u003Cstrong>\u003Ccode>Resources\u003C\u002Fcode>\u003C\u002Fstrong>, puis \u003Cstrong>\u003Ccode>Client\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Glissez-déposez\u003C\u002Fstrong> votre fichier \u003Ccode>.zip\u003C\u002Fcode> dans ce dossier (ne le décompressez pas, BeamMP lit directement les archives)\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Le chemin complet doit ressembler à ceci.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>\u002Fhome\u002Fcontainer\u002FResources\u002FClient\u002Fvotre-map.zip\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Le panel impose une \u003Cstrong>limite de 100 Mo par upload\u003C\u002Fstrong> via l'interface web. La plupart des cartes BeamMP dépassent largement cette limite. Si votre \u003Ccode>.zip\u003C\u002Fcode> fait plus de 100 Mo, vous devrez passer par une \u003Cstrong>connexion SFTP\u003C\u002Fstrong> pour téléverser votre map. Vos identifiants SFTP sont disponibles dans la section \u003Cstrong>Settings\u003C\u002Fstrong> de votre serveur (host, port, username), et le \u003Cstrong>mot de passe est identique à celui de votre compte panel\u003C\u002Fstrong>. Utilisez un client comme \u003Cstrong>FileZilla\u003C\u002Fstrong> ou \u003Cstrong>WinSCP\u003C\u002Fstrong> pour vous connecter et déposer votre fichier directement dans \u003Ccode>Resources\u002FClient\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Le dossier \u003Cstrong>\u003Ccode>Client\u003C\u002Fcode>\u003C\u002Fstrong> est spécifique aux ressources envoyées automatiquement aux joueurs lors de leur connexion. Ne confondez pas avec le dossier \u003Ccode>Server\u003C\u002Fcode> qui contient les scripts côté serveur.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Identifier le nom interne de la carte\u003C\u002Fh2>\n\u003Cp>C'est l'étape la plus importante, et celle qui pose le plus de problèmes aux débutants. \u003Cstrong>Le nom du fichier \u003Ccode>.zip\u003C\u002Fcode> n'est pas le nom de la carte\u003C\u002Fstrong> dont a besoin BeamMP. Vous devez trouver le \u003Cstrong>nom interne\u003C\u002Fstrong> utilisé par le moteur du jeu.\u003C\u002Fp>\n\u003Ch3>Méthode 1, depuis le site de téléchargement\u003C\u002Fh3>\n\u003Cp>La plupart des sites qui distribuent des cartes BeamNG indiquent le \u003Cstrong>nom interne\u003C\u002Fstrong> de la map dans la description, souvent sous la forme \u003Ccode>levels\u002Fnom_interne\u002Finfo.json\u003C\u002Fcode>. C'est cette information qu'il vous faut.\u003C\u002Fp>\n\u003Ch3>Méthode 2, inspecter le contenu du .zip\u003C\u002Fh3>\n\u003Cp>Si l'info n'est pas disponible sur le site, ouvrez le fichier \u003Ccode>.zip\u003C\u002Fcode> avec un logiciel d'archive (sans le décompresser). Vous y trouverez une structure de dossiers ressemblant à ceci.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>levels\u002F\n  └── nom_de_la_map\u002F\n        ├── info.json\n        ├── main.terrain.json\n        └── ...\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Le \u003Cstrong>nom du dossier\u003C\u002Fstrong> sous \u003Ccode>levels\u002F\u003C\u002Fcode> est exactement le nom interne dont vous avez besoin.\u003C\u002Fp>\n\u003Ch3>Exemples concrets\u003C\u002Fh3>\n\u003Cp>Voici quelques exemples pour vous aider à visualiser.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Carte\u003C\u002Fth>\n\u003Cth>Nom interne\u003C\u002Fth>\n\u003Cth>Chemin complet\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Map par défaut\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>gridmap_v2\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>levels\u002Fgridmap_v2\u002Finfo.json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Bajarama\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>bajarama\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>levels\u002Fbajarama\u002Finfo.json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Roane County\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roane_county\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>levels\u002Froane_county\u002Finfo.json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2>3. Configurer le chemin de la carte dans le panel\u003C\u002Fh2>\n\u003Cp>Une fois le nom interne identifié, il faut indiquer à BeamMP qu'il doit charger cette carte au démarrage.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Dans le menu latéral du panel, cliquez sur \u003Cstrong>Startup\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Repérez le champ \u003Cstrong>Map\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Remplacez la valeur actuelle par le \u003Cstrong>chemin complet\u003C\u002Fstrong> de votre carte, au format \u003Ccode>levels\u002Fnom_interne\u002Finfo.json\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Par exemple, pour la carte Bajarama.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>levels\u002Fbajarama\u002Finfo.json\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Col start=\"4\">\n\u003Cli>Sauvegardez les modifications\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Le format attendu est \u003Cstrong>toujours\u003C\u002Fstrong> \u003Ccode>levels\u002FNOM\u002Finfo.json\u003C\u002Fcode>. Pas de barre oblique au début, pas de chemin absolu, pas d'extension \u003Ccode>.zip\u003C\u002Fcode>. 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).\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Redémarrer votre serveur\u003C\u002Fh2>\n\u003Cp>Pour que les changements soient pris en compte, vous devez redémarrer votre serveur BeamMP.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Retournez sur la page principale de votre serveur dans le panel\u003C\u002Fli>\n\u003Cli>Cliquez sur \u003Cstrong>Restart\u003C\u002Fstrong> (ou Stop puis Start si nécessaire)\u003C\u002Fli>\n\u003Cli>Surveillez la \u003Cstrong>console\u003C\u002Fstrong> pour vous assurer que le serveur démarre correctement avec la nouvelle map\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Cp>Voici les erreurs les plus fréquentes lors de l'installation d'une carte moddée.\u003C\u002Fp>\n\u003Ch3>❌ Le serveur démarre mais charge la map par défaut\u003C\u002Fh3>\n\u003Cp>Le chemin que vous avez indiqué dans le champ \u003Cstrong>Map\u003C\u002Fstrong> est incorrect. Vérifiez les points suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Le \u003Cstrong>nom interne\u003C\u002Fstrong> de la map est bien orthographié (sensible à la casse, pas d'espace)\u003C\u002Fli>\n\u003Cli>Le format est exactement \u003Ccode>levels\u002FNOM\u002Finfo.json\u003C\u002Fcode>, sans barre oblique au début\u003C\u002Fli>\n\u003Cli>Le fichier \u003Ccode>.zip\u003C\u002Fcode> est bien dans \u003Ccode>Resources\u002FClient\u003C\u002Fcode> et pas ailleurs\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Erreur de chargement de la map dans la console\u003C\u002Fh3>\n\u003Cp>Si vous voyez une erreur du type \u003Cem>"Could not find level"\u003C\u002Fem> ou \u003Cem>"Map not found"\u003C\u002Fem> dans la console, le serveur n'arrive pas à lire le fichier. Vérifiez les points suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Le fichier \u003Ccode>.zip\u003C\u002Fcode> n'est \u003Cstrong>pas corrompu\u003C\u002Fstrong> (essayez de l'ouvrir avec un logiciel d'archive)\u003C\u002Fli>\n\u003Cli>Le \u003Ccode>.zip\u003C\u002Fcode> contient bien un dossier \u003Ccode>levels\u002F\u003C\u002Fcode> à sa racine\u003C\u002Fli>\n\u003Cli>Vous n'avez pas décompressé le \u003Ccode>.zip\u003C\u002Fcode> par erreur (BeamMP a besoin de l'archive intacte)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ La map fonctionne en solo mais pas sur le serveur\u003C\u002Fh3>\n\u003Cp>Certaines cartes sont conçues uniquement pour le \u003Cstrong>mode solo de BeamNG.drive\u003C\u002Fstrong> 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 \u003Cstrong>explicitement compatible BeamMP\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch3>❌ Mes joueurs ne peuvent pas se connecter après l'ajout\u003C\u002Fh3>\n\u003Cp>Le fichier \u003Ccode>.zip\u003C\u002Fcode> est peut-être trop volumineux pour être téléchargé rapidement par vos joueurs. Vérifiez les points suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>La \u003Cstrong>taille du fichier\u003C\u002Fstrong> est raisonnable (au-delà de 500 Mo, certains joueurs peuvent avoir des timeouts)\u003C\u002Fli>\n\u003Cli>Vos joueurs disposent d'une connexion suffisamment stable pour télécharger la map au premier lancement\u003C\u002Fli>\n\u003Cli>Le serveur n'est pas surchargé en bande passante au moment des connexions\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cp>Quelques recommandations pour gérer vos cartes moddées sereinement.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Sauvegardez votre serveur\u003C\u002Fstrong> avant chaque changement de map, surtout si vous avez beaucoup de mods qui dépendent de la map actuelle\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Testez la map en solo\u003C\u002Fstrong> dans BeamNG.drive avant de la déployer sur votre serveur pour vérifier qu'elle se charge sans erreur\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Prévenez vos joueurs\u003C\u002Fstrong> d'un changement de map, surtout si la nouvelle carte est lourde à télécharger\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Limitez le nombre de maps actives\u003C\u002Fstrong>, un serveur BeamMP charge \u003Cstrong>une seule map à la fois\u003C\u002Fstrong>, mais avoir plusieurs \u003Ccode>.zip\u003C\u002Fcode> dans \u003Ccode>Resources\u002FClient\u003C\u002Fcode> augmente la taille du téléchargement initial pour les joueurs\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Privilégiez les maps optimisées multijoueur\u003C\u002Fstrong> pour éviter les lags et désynchronisations\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>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 \u003Cstrong>Technique\u003C\u002Fstrong> depuis votre espace client, renseignez le champ \u003Cstrong>Produit lié\u003C\u002Fstrong> 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.\u003C\u002Fp>\n\u003Cp>Votre serveur BeamMP est prêt à accueillir vos joueurs sur une nouvelle map, bonne route 🛣️\u003C\u002Fp>\n",1788993135248]