Ce guide couvre la configuration admin, les ressources côté serveur, les cartes personnalisées, la gestion des véhicules et le dépannage de votre serveur BeamMP sur Legion Hosting. Pour la configuration initiale du serveur, les clés d'authentification et la configuration de base, consultez BeamMP Server Setup Guide.
Configuration admin
BeamMP ne dispose pas d'un système traditionnel de connexion admin ou de mot de passe. Les commandes admin sont exécutées via la console du serveur ou via des plugins Lua côté serveur qui vérifient les identifiants des joueurs.
Commandes de la console
La console du serveur dans GPanel fournit un accès direct aux commandes intégrées du serveur. Tapez les commandes directement dans le champ de saisie de la console :
| Commande | Description |
|---|---|
kick <player_id> <reason> |
Expulse un joueur du serveur avec un message de raison optionnel. |
ban <player_name> |
Bannit un joueur du serveur. Les joueurs bannis ne peuvent pas se reconnecter. |
unban <player_name> |
Supprime le bannissement d'un joueur, lui permettant de se reconnecter. |
list |
Affiche tous les joueurs actuellement connectés avec leurs identifiants. |
say <message> |
Envoie un message de chat à l'ensemble du serveur depuis la console. |
status |
Affiche les informations sur l'état du serveur, y compris le nombre de joueurs et le temps de fonctionnement. |
help |
Liste toutes les commandes de console disponibles. |
list pour voir les joueurs connectés et leurs identifiants. Ces identifiants sont nécessaires pour des commandes comme kick.
Structure du dossier Resources
BeamMP utilise un dossier Resources pour organiser le contenu côté serveur. Ce dossier contient deux sous-répertoires avec des objectifs distincts :
Resources/
Client/ <-- Mods côté client (cartes, véhicules) synchronisés avec les joueurs
Server/ <-- Plugins Lua côté serveur (non envoyés aux joueurs)Ressources client
Les fichiers placés dans Resources/Client/ sont automatiquement téléchargés par les joueurs lorsqu'ils se connectent. Cela est utilisé pour :
- Cartes personnalisées — Fichiers .zip de mods de cartes dont les joueurs ont besoin pour charger la carte du serveur.
- Véhicules personnalisés — Fichiers .zip de mods de véhicules qui ajoutent de nouvelles voitures ou modifient celles existantes.
- Autres mods client — Tout mod BeamNG.drive qui doit être présent sur le client.
Resources/Client/ est téléchargé par chaque joueur qui rejoint le serveur. Des fichiers volumineux ou de nombreux mods augmenteront considérablement les temps de connexion. Gardez vos ressources client légères pour la meilleure expérience joueur.
Ressources serveur (plugins Lua)
Le répertoire Resources/Server/ contient les plugins Lua côté serveur. Ceux-ci s'exécutent uniquement sur le serveur et ne sont pas envoyés aux joueurs. Chaque plugin se trouve dans son propre sous-dossier avec un fichier main.lua :
Resources/
Server/
MyPlugin/
main.lua <-- Point d'entrée du plugin
AnotherPlugin/
main.luaLes plugins côté serveur peuvent :
- Répondre aux événements des joueurs (connexion, déconnexion, messages de chat, apparitions de véhicules).
- Implémenter des commandes personnalisées déclenchées via le chat (par ex.,
/tp,/give). - Gérer les permissions et les limites de véhicules.
- Ajouter des systèmes d'économie, de téléportation ou d'autres fonctionnalités de gameplay personnalisées.
- Enregistrer l'activité des joueurs et appliquer des règles.
Ajouter des cartes personnalisées
Pour exécuter une carte personnalisée (non par défaut) sur votre serveur BeamMP :
- Téléchargez le mod de carte sous forme de fichier
.zipdepuis une source de mods BeamNG.drive (par ex., le dépôt de mods BeamNG.drive). - Arrêtez votre serveur dans GPanel.
- Uploadez le fichier
.zipdansResources/Client/via l'onglet Files ou SFTP. N'extrayez pas le zip. - Mettez à jour la variable de démarrage
MAP(ouMapdansServerConfig.toml) avec le chemin correct de la carte personnalisée. Ce chemin est généralement au format/levels/map_name/info.json— consultez la documentation du mod pour le chemin exact. - Démarrez le serveur.
Map ne correspond pas au chemin réel à l'intérieur du fichier .zip du mod, le serveur ne parviendra pas à charger la carte. Consultez la documentation du mod ou inspectez la structure du .zip pour trouver le chemin /levels/ correct.
Resources/Client/ que le joueur ne possède pas déjà. Les joueurs n'ont pas besoin d'installer manuellement les mods de cartes.
Gestion des véhicules
La gestion des véhicules sur les serveurs BeamMP est contrôlée via le paramètre MaxCars et éventuellement via des plugins Lua côté serveur.
Paramètre MaxCars
Le paramètre MaxCars dans ServerConfig.toml (ou la variable de démarrage MAX_CARS) contrôle le nombre de véhicules que chaque joueur peut faire apparaître simultanément :
1— Chaque joueur peut avoir un véhicule à la fois (recommandé pour les serveurs plus grands).2–3— Permet aux joueurs d'avoir quelques véhicules, utile pour les petits serveurs ou les rassemblements de voitures.- Des valeurs plus élevées augmentent proportionnellement la charge du serveur.
Mods de véhicules personnalisés
Pour ajouter des véhicules personnalisés à votre serveur :
- Téléchargez le mod de véhicule sous forme de fichier
.zip. - Placez-le dans
Resources/Client/. - Redémarrez le serveur. Les joueurs téléchargeront automatiquement le mod de véhicule à la connexion.
Restreindre les véhicules via des plugins
Pour un contrôle plus granulaire (par ex., interdire des véhicules spécifiques, limiter les types de véhicules), vous aurez besoin d'un plugin Lua côté serveur. Ces plugins peuvent intercepter les événements d'apparition de véhicules et les autoriser ou les refuser selon des règles personnalisées. Consultez les forums BeamMP pour les plugins de gestion de véhicules.
Installation et gestion des plugins
Les plugins Lua côté serveur étendent les fonctionnalités de votre serveur. Voici comment les installer et les gérer :
Installer un plugin
- Téléchargez les fichiers du plugin (généralement un dossier contenant
main.luaet éventuellement d'autres fichiers). - Arrêtez votre serveur.
- Uploadez le dossier du plugin dans
Resources/Server/via l'onglet Files ou SFTP. - Assurez-vous que la structure des dossiers est correcte :
Resources/Server/PluginName/main.lua. - Démarrez le serveur. La console affichera des messages au chargement des plugins.
Supprimer un plugin
- Arrêtez votre serveur.
- Supprimez le dossier du plugin de
Resources/Server/. - Démarrez le serveur.
Dépannage
Erreurs de clé d'authentification
- Vérifiez que la clé est correctement collée dans la variable de démarrage
AUTH_KEY— sans espaces ni sauts de ligne supplémentaires. - Assurez-vous que la clé n'a pas été révoquée ou expirée sur le BeamMP Keymaster.
- Chaque clé ne peut être utilisée que sur un seul serveur à la fois. Si vous utilisez la même clé ailleurs, cela échouera.
- La console affichera les erreurs d'authentification au démarrage si la clé est invalide.
Les joueurs ne peuvent pas se connecter
- Confirmez que le serveur est entièrement démarré et s'affiche comme en ligne dans GPanel.
- Vérifiez que le joueur utilise le lanceur BeamMP, et non le lanceur standard BeamNG.drive.
- Si le serveur est défini sur
Private = true, les joueurs doivent utiliser la connexion directe avec l'IP et le port corrects. Consultez How to Find Your Server IP and Port. - Assurez-vous que la version du lanceur BeamMP du joueur est compatible avec la version du serveur. Les lanceurs obsolètes peuvent échouer à se connecter.
- Si le serveur est plein (
MaxPlayersatteint), les joueurs supplémentaires ne peuvent pas rejoindre tant que quelqu'un ne part pas.
Problèmes de synchronisation des mods
- Si les joueurs restent bloqués au téléchargement ou reçoivent des erreurs concernant des mods manquants, vérifiez que les fichiers .zip des mods dans
Resources/Client/ne sont pas corrompus. - Re-téléchargez et re-uploadez le fichier du mod si le .zip est endommagé.
- Les fichiers de mods très volumineux peuvent provoquer des délais d'attente pour les joueurs ayant des connexions lentes. Envisagez de supprimer les mods volumineux inutiles.
- Assurez-vous que les fichiers .zip des mods ne sont pas imbriqués (c'est-à-dire un .zip dans un dossier dans un autre .zip).
Problèmes de performance avec beaucoup de joueurs/véhicules
- Réduisez
MaxCarsà1par joueur. - Diminuez
MaxPlayerssi le serveur subit un lag constant. - Passez à une carte plus simple (Grid Map ou Industrial) pour de meilleures performances avec un nombre élevé de joueurs.
- Supprimez les mods client inutiles de
Resources/Client/pour réduire les temps de téléchargement et l'utilisation de la mémoire. - Vérifiez les graphiques d'utilisation des ressources de GPanel — si le CPU ou la RAM est constamment à la limite, envisagez de mettre à niveau votre plan serveur. Ouvrez un ticket de support pour discuter des options.
Le serveur n'apparaît pas dans le navigateur
- Assurez-vous que
Privateest défini surfalsedans votre configuration. - Vérifiez que la clé d'authentification est valide et n'est pas utilisée par un autre serveur.
- Attendez 1–2 minutes après le démarrage pour que le serveur s'enregistre auprès du backend BeamMP.
- Vérifiez la console pour toute erreur liée à la connexion au serveur maître.
Articles connexes
- BeamMP Server Setup Guide — Configuration initiale, clé d'authentification, configuration et instructions de connexion
- 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, une description du problème et tout message d'erreur pertinent de la console GPanel.
