¶ Avant de commencer
Créer un serveur BeamMP est facile et gratuit
Les serveurs sont une partie importante au fonctionnement de BeamMP. Sans ces derniers, les clients ne pourraient pas communiquer entre eux.
Un serveur BeamMP consiste en un fichier .exe, un fichier de configuration (ce dernier contient le port, le nombre de joueurs maximum etc...), un fichier log et un dossier ressources.
¶ Redirection des ports
Si vous voulez que des joueurs d'internet puissent rejoindre votre serveur, vous devrez opérer une redirection de ports. Ce processus peut faire peur aux premiers abords mais il est relativement simple si bien effectué. Nous vous invitons à suivre un tutoriel adapté à votre opérateur internet et à votre box. Voici un exemple avec l'opérateur Orange.
Le port que vous redirigez devra être le même que celui indiqué dans le fichier Server.cfg du serveur. Le serveur utilise les protocoles TCP et UDP.
Notez que pour l'instant le serveur supporte uniquement le protocole IPv4.
¶ Obtenir une clé d'authentification
Dans un premier temps, rendez-vous sur le Keymaster, cliquez sur "Keys" dans le menu à gauche puis sur "here". Remplissez le champ Server Name et Server IP. Notez que ces deux champs sont uniquemement pour reconnaître vos serveurs, si vous ne souhaitez pas indiquer d'adresse IP mettez 0.0.0.0. Par défaut vous aurez un nombre limité de clés. Une clé peut être utilisée pour un seul serveur. Cette limitation a été posée afin d'éviter les abus potentiels sur la création de multiple serveurs.
Une fois que vous avez crée votre clé, copiez celle-ci et rentrez la dans le champ AuthKey du fichier de configuration du serveur. Cette dernière devrait être gardée privée, elle sera indiquée par le champ "--------------" tout au long de ce tutoriel.
¶ Installation
¶ Windows
¶ Avant de commencer
Vérifiez que vous avez bien redirigés les ports de votre routeur avant de commencer ! Cette étape est cruciale pour le bon fonctionnement du serveur.
Pour commencer, téléchargez le fichier du serveur sur beammp.com puis décompressez le fichier .zip téléchargé dans un dossier. Double cliquez sur le fichier BeamMP-Server.exe pour l'ouvrir. Le serveur va générer les fichiers nécessaires à son bon fonctionnement, une fois que le fichier Server.cfg est apparu dans le dossier du serveur vous pouvez arrêter ce dernier.
¶ Gérer le serveur
Une fois le serveur configuré (voir Comment utiliser le fichier de configuration plus bas) ouvez BeamMP-Server.exe pour le démarrer.
Pour arrêter le serveur vous pouvez simplement utilier la croix en haut à droite de la fenêtre.
¶ Linux
¶ Build (recommandé)
Le serveur peut être build sur Linux. Cependant les builds ne sont pas fournies, vous devrez le faire vous même. BeamMP est officiellement supporté sur Debian 9 et 10, un tutoriel peut être trouvé ici.
¶ En utilisant Wine (non recommandé, uniquement sur vous ne pouvez pas build le serveur)
Si vous voulez utiliser Wine, le processus est globalement le même, seulement vous devrez installer Wine avant.
¶ Installation de Wine
Dans un premier, mettez à jour tous les paquets de votre distribution Linux à l'aide des commandes suivantes:
$ sudo apt update
$ sudo apt upgrade
Le serveur fonctionne uniquement avec la version dev de Wine, pour l'installer servez vous de la commande suivante:
$ sudo apt install wine
Une fois ces étapes terminées vous pouvez installer le serveur.
¶ Installation du serveur
Une fois que Wine est installé, téléchargez le fichier .zip du serveur puis décompressez le dans un dossier de votre choix.
Enfin, pour lancer le serveur, utilisez:
$ wine BeamMP-Server.exe
Pour quitter le serveur utilisez CTRL + C
Si vous avez une erreur de Wine ntlm_auth, vous devrez installer le paquet winbind.
¶ Comment utiliser le fichier de configuration
Le fichier de configuration (Server.cfg) peut être ouvert avec n'importe quel editeur de texte tel que notepad ou notepad++.
- Note: Le fichier de configuration utilise un format
- Clé = "valeur"
- N'utilisez pas de caractères spéciaux tel que # ou ".
Une fois dans le fichier de configuration, vous devrez modifier une multitude de lignes.
La première est le nom du serveur (Name), c'est celui qui sera affiché dans la liste des serveurs en jeu.
Ensuite, vous devrez générer une clé d'authentification (AuthKey), les étapes sont expliqué à Obtenir une clé d'authentification plus haut.
Voici un tableau de tous les paramètres:
| Nom | Description | Valeur par défaut |
|---|---|---|
| Debug | Permet d'afficher les lignes de débogage dans la console | false |
| Private | Empêche le serveur de s'afficher dans la liste des serveurs en jeu | true |
| Port | Le port du serveur, laissez pas défaut sauf si vous avez plusieurs serveur sur une même IP | 30814 |
| Cars | Combien de véhicules un seul joueur peut avoir au maximum | 1 |
| MaxPlayers | La limite des joueurs sur le serveur | 10 |
| Map | La map que le serveur utilisera | /levels/gridmap/info.json |
| Name | Le nom du serveur dans la liste des serveurs en jeu | BeamMP New Server |
| Desc | La description du serveur dans la liste des serveurs en jeu | BeamMP Default Description |
| use | Le dossier à utiliser pour les mods | Resources |
| AuthKey | La clé d'authentification du serveur (requis) | aucune |
¶ Comment ajouter des mods sur votre serveur
- Les véhicules et les maps s'installent de la même façon. Cependant l'utilisation d'une map nécessite une étape suplémentaire. Pour installer un mod, glissez simplement le .zip de ce dernier dans le dossier Ressources\Client.
- Si vous ne souhaitez pas utiliser une map moddé, il n'y a aucune étape supplémentaire, les mods devraient être téléchargés et installés automatiquement.
Utiliser une map custom:
- Dans un premier temps, mettez le fichier .zip de votre map dans le dossier /Ressources/Client
- Ensuite, ouvrez le fichier .zip de votre map, puis rendez vous dans le dossier levels. Vous devriez voir un dossier avec le nom de votre map.
- Copiez le nom de ce dossier puis dans le fichier Server.cfg à la ligne Map (/levels/gridmap/info.json) remplacez gridmap par le nom du dossier.
- Exemple: le dossier s'appelle ma_map_custom vous devrez mettre /levels/ma_map_custom/info.json à la ligne Map du fichier de configuration du serveur.
C'est tout ! Votre map custom devrait fonctionner.
¶ Liste des maps par défaut
Voici une liste de toutes les maps par défaut du jeu
- /levels/gridmap/info.json
- /levels/automation_test_track/info.json
- /levels/east_coast_usa/info.json
- /levels/hirochi_raceway/info.json
- /levels/italy/info.json
- /levels/jungle_rock_island/info.json
- /levels/industrial/info.json
- /levels/small_island/info.json
- /levels/smallgrid/info.json
- /levels/utah/info.json
- /levels/west_coast_usa/info.json
- /levels/driver_training/info.json
- /levels/derby/info.json
¶ Mettre de la couleur dans le nom de votre serveur
Il vous suffit d'ajouter ces caractères dans le nom de votre serveur.
Exemple: ^2Ce texte sera vert ^net celui ci vert et souligné. Pour finir, ^rce texte sera normal.
| ^n - souligné |
| ^0 - noir |
| ^1 - bleu |
| ^2 - vert |
| ^3 - bleu clair |
| ^4 - rouge |
| ^5 - rose |
| ^6 - orange |
| ^7 - gris |
| ^8 - gris foncé |
| ^9 - violet clair |
| ^a - vert clair |
| ^b - cyan |
| ^c - orange foncé |
| ^d - rose clair |
| ^e - jaune |
| ^f - blanc |
| ^l - gras |
| ^r - par défaut |
| ^m - barré |
| ^o - italique |