Ce guide couvre tout ce dont vous avez besoin pour faire fonctionner votre serveur BeamMP sur Legion Hosting, du premier démarrage et de la configuration de la clé d'authentification à la configuration de ServerConfig.toml et à la connexion des joueurs. Pour les commandes admin, les cartes personnalisées et la gestion des ressources, consultez BeamMP Admin and Resource Setup.
Qu'est-ce que BeamMP ?
BeamMP est un mod multijoueur pour BeamNG.drive qui permet aux joueurs de conduire, faire la course et s'écraser ensemble sur les mêmes cartes. L'application BeamMP-Server fonctionne comme un serveur dédié autonome. Les joueurs se connectent via le lanceur BeamMP, qui remplace le lanceur standard BeamNG.drive pour les sessions multijoueur.
Premier démarrage
Lorsque vous recevez votre serveur BeamMP pour la première fois, suivez ces étapes pour le mettre en ligne :
- Connectez-vous à GPanel et sélectionnez votre serveur BeamMP.
- Avant de démarrer, vous devez obtenir une clé d'authentification (voir ci-dessous). Sans elle, le serveur ne pourra pas s'authentifier auprès des services BeamMP.
- Accédez à l'onglet Startup et collez votre clé d'authentification dans la variable
AUTHKEY. - Ajustez éventuellement d'autres variables de démarrage telles que le nom du serveur et le nombre maximum de joueurs.
- Allez dans l'onglet Console et cliquez sur Start.
- Le serveur téléchargera automatiquement les fichiers BeamMP-Server lors du premier démarrage. Cela peut prendre quelques minutes.
- Une fois que la console affiche
[INFO] Server started!ou un message similaire, votre serveur est en ligne et apparaîtra dans le navigateur de serveurs BeamMP.
Clé d'authentification (BeamMP Keymaster)
Chaque serveur BeamMP nécessite une clé d'authentification qui le relie aux services backend BeamMP. Cette clé est gratuite et liée à votre compte BeamMP/Discord.
Comment obtenir votre clé
- Rendez-vous sur beammp.com/k/keys (le BeamMP Keymaster).
- Connectez-vous avec votre compte Discord. Si vous n'avez pas de compte BeamMP, vous serez invité à en créer un.
- Cliquez sur Create a key (ou + / New Key selon l'interface actuelle).
- Entrez un nom pour votre serveur (c'est juste un libellé pour votre référence) et l'adresse IP de votre serveur.
- Copiez la chaîne de clé générée.
Ajouter la clé à votre serveur
- Dans GPanel, allez dans l'onglet Startup.
- Collez votre clé dans la variable
AUTHKEY. - Redémarrez le serveur pour que le changement prenne effet.
Variables de démarrage GPanel
BeamMP expose plusieurs options de configuration en tant que variables de démarrage dans GPanel. Accédez à l'onglet Startup pour les afficher et les modifier. Les changements nécessitent un redémarrage du serveur pour prendre effet.
| Variable | Par défaut | Description |
|---|---|---|
AUTHKEY |
vide | Votre clé d'authentification BeamMP du Keymaster. Requise pour le fonctionnement du serveur. |
NAME |
BeamMP Server |
Le nom affiché dans le navigateur de serveurs BeamMP. |
MAX_PLAYERS |
10 |
Nombre maximum de joueurs simultanés. Des valeurs plus élevées nécessitent plus de CPU et de RAM. |
MAP |
/levels/gridmap_v2/info.json |
La carte à charger. Utilise le format de chemin de carte BeamNG.drive. Consultez la section Sélection de carte pour les cartes disponibles. |
PORT |
30814 |
Le port du serveur. Celui-ci est préconfiguré par GPanel — ne le modifiez pas sauf instruction du support. |
MAX_CARS |
1 |
Nombre maximum de véhicules par joueur. Plus de véhicules par joueur augmente significativement la bande passante et l'utilisation CPU. |
PRIVATE |
false |
Si true, le serveur n'apparaîtra pas dans le navigateur de serveurs public. Les joueurs doivent se connecter via connexion directe. |
ServerConfig.toml
Au-delà des variables de démarrage, la configuration complète du serveur se trouve dans ServerConfig.toml dans le répertoire racine du serveur. Vous pouvez modifier ce fichier via l'onglet Files dans GPanel ou par SFTP. Les variables de démarrage dans GPanel remplacent les valeurs de ce fichier à chaque démarrage.
Options de configuration principales
[General]
AuthKey = "your-key-here"
Name = "My BeamMP Server"
Description = "A fun racing and freeroam server"
MaxPlayers = 10
Port = 30814
Map = "/levels/gridmap_v2/info.json"
Private = false
MaxCars = 1
ResourceFolder = "Resources"
LogChat = true| Paramètre | Description |
|---|---|
AuthKey |
Votre clé d'authentification BeamMP Keymaster. |
Name |
Nom du serveur affiché dans le navigateur de serveurs. Supporte certains codes de formatage. |
Description |
Une courte description affichée sous le nom du serveur dans le navigateur. |
MaxPlayers |
Limite de joueurs. Valeurs typiques : 8–20 pour un gameplay fluide. |
Map |
Le chemin de la carte à charger. Doit être un chemin de niveau BeamNG.drive valide. |
Private |
Défini sur true pour masquer le serveur du navigateur. |
MaxCars |
Véhicules autorisés par joueur. 1 est recommandé pour les serveurs plus grands. |
ResourceFolder |
Chemin vers le répertoire Resources contenant les mods et plugins côté serveur. |
LogChat |
Si true, les messages de chat des joueurs sont enregistrés dans la console. |
Sélection de carte
BeamMP utilise les mêmes cartes que BeamNG.drive. La carte est spécifiée comme chemin de niveau dans le paramètre Map. Voici les cartes par défaut les plus couramment utilisées :
| Nom de la carte | Chemin de la carte | Description |
|---|---|---|
| Grid Map v2 | /levels/gridmap_v2/info.json |
Une zone de test plate et ouverte. Idéale pour les constructions libres et les tests de véhicules. |
| West Coast USA | /levels/west_coast_usa/info.json |
Une grande carte détaillée avec des autoroutes, une ville et un terrain varié. Très populaire pour le freeroam. |
| East Coast USA | /levels/east_coast_usa/info.json |
Collines ondulantes, forêts et une petite ville. Idéale pour le tout-terrain et la balade. |
| Italy | /levels/italy/info.json |
Une campagne italienne pittoresque avec des routes étroites et une ville côtière. |
| Utah | /levels/utah/info.json |
Terrain désertique avec de longues autoroutes et des pistes tout-terrain. |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
Une île tropicale avec des routes sinueuses et une végétation dense. |
| Industrial | /levels/industrial/info.json |
Une zone industrielle compacte avec des rampes, des sauts et des parcours d'obstacles. |
| Small Island USA | /levels/small_island/info.json |
Une petite île avec des routes étroites. Idéale pour un nombre réduit de joueurs. |
| Driver Training | /levels/driver_training/info.json |
Un circuit de type autocross conçu pour l'entraînement à la conduite de véhicules. |
Resources/Client et en utilisant le chemin de carte approprié. Consultez BeamMP Admin and Resource Setup pour plus de détails sur l'ajout de contenu personnalisé.
Nombre maximum de joueurs et performance
BeamNG.drive est un jeu gourmand en physique. Chaque joueur et véhicule ajoute une charge significative au serveur et aux clients connectés. Gardez ces recommandations à l'esprit :
- MaxPlayers : 8–20 joueurs est typique pour une expérience fluide. Les serveurs plus grands (20+) sont possibles mais nécessitent plus de ressources et une configuration soigneuse.
- MaxCars : Le maintenir à
1par joueur est fortement recommandé pour les serveurs de plus de 10 joueurs. Chaque véhicule supplémentaire multiplie les données physiques qui doivent être synchronisées. - Le choix de la carte compte : Les cartes plus grandes et plus détaillées (West Coast USA, Italy) utilisent plus de mémoire que les cartes plus simples (Grid Map, Industrial).
- Bande passante réseau : BeamMP envoie des données physiques détaillées pour chaque véhicule. Un nombre élevé de joueurs avec plusieurs véhicules par joueur peut saturer rapidement la bande passante.
MaxCars à 1 et de diminuer MaxPlayers. C'est le moyen le plus efficace pour améliorer les performances du serveur.
Comment se connecter
Les joueurs se connectent aux serveurs BeamMP via le lanceur BeamMP, et non le lanceur standard BeamNG.drive.
Via le navigateur de serveurs
- Téléchargez et installez le lanceur BeamMP depuis beammp.com.
- Lancez le lanceur BeamMP. Il démarrera BeamNG.drive avec le mod multijoueur BeamMP chargé.
- Depuis le menu principal, sélectionnez Multiplayer.
- Parcourez la liste des serveurs ou utilisez la barre de recherche pour trouver votre serveur par nom.
- Cliquez sur votre serveur et sélectionnez Connect.
Via la connexion directe
- Dans le menu multijoueur BeamMP, cliquez sur Direct Connect.
- Entrez l'adresse IP et le port de votre serveur au format
IP:PORT(par ex.,192.168.1.1:30814). - Cliquez sur Connect.
PRIVATE est défini sur false et que votre clé d'authentification est valide. Il peut falloir une minute ou deux après le démarrage pour que le serveur apparaisse dans le navigateur. S'il n'apparaît toujours pas, vérifiez la console pour les erreurs d'authentification. Notez que votre port est attribué aléatoirement sauf si vous avez une IP privée -- vérifiez GPanel pour le port correct.
Gestion des sauvegardes
BeamNG.drive est un jeu basé sur des sessions. Il n'y a pas d'état de monde persistant ni de fichier de sauvegarde pour le serveur. Lorsque les joueurs se déconnectent ou que le serveur redémarre, toutes les positions et états des véhicules sont réinitialisés. Chaque session recommence à zéro.
- Il n'y a pas de sauvegardes de monde à sauvegarder ou gérer.
- La configuration du serveur (
ServerConfig.toml) et les ressources persistent entre les redémarrages. - Les configurations de véhicules des joueurs sont stockées côté client, pas sur le serveur.
Articles connexes
- BeamMP Admin and Resource Setup — Commandes admin, cartes personnalisées, plugins et gestion des ressources
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide — Guide général pour démarrer tout serveur de jeu sur Legion Hosting
Besoin d'aide supplémentaire ?
Si vous rencontrez des problèmes non couverts dans ce guide, notre équipe de support est disponible pour vous aider. Ouvrez un ticket à legionhosting.net/submitticket.php avec les détails de votre serveur et une description du problème.
