mirror of
https://github.com/BeamMP/Docs.git
synced 2026-02-16 02:20:44 +00:00
Merge pull request #245 from BeamMP/gitlocalize-34821
Updated fr_FR translations by 3vfi-dev
This commit is contained in:
Protogen187
GitHub
283
docs/fr/server/create-a-server.md
Normal file
283
docs/fr/server/create-a-server.md
Normal file
@@ -0,0 +1,283 @@
|
||||
# Installation du serveur
|
||||
|
||||
## **Création d'un serveur**
|
||||
|
||||
Notions de base sur la configuration de l'application serveur
|
||||
|
||||
---
|
||||
|
||||
### **Aperçu**
|
||||
|
||||
**La création d'un serveur est gratuite, l'héberger avec un VPS est plus facile et plus sûr.**
|
||||
|
||||
Les serveurs font partie intégrante de BeamMP ; les joueurs sont connectés les uns aux autres par l'intermédiaire du serveur. Ils fonctionnent nativement sous Windows et Linux
|
||||
|
||||
Vous pouvez créer des serveurs privés, auxquels seules les personnes que vous invitez peuvent accéder, ou des serveurs publics, qui apparaîtront dans notre liste officielle de serveurs.
|
||||
|
||||
Mettre en place un serveur se fait en quelques étapes ! Si vous rencontrez des problèmes, n'hésitez pas à nous contacter sur notre [forum](https://forum.beammp.com) ou sur notre [serveur Discord](https://discord.gg/beammp) dans le canal `#support` . Consultez également la section [Maintenance du serveur](server-maintenance.md) pour plus d'informations.
|
||||
|
||||
Veuillez vous assurer de lire la[LICENCE](https://raw.githubusercontent.com/BeamMP/BeamMP-Server/master/LICENSE) du serveur avant utilisation.
|
||||
|
||||
Remarque : *Le serveur ne prend en charge que l'IPv4. Si vous ne savez pas lequel vous utilisez, regardez l'adresse IP affichée sur [*whatsmyip.org*](https://www.whatsmyip.org/) : si elle contient* des deux points `_:_` *, il s'agit **d'IPv6** . Dans ce cas, vérifiez si vous utilisez également une adresse IPv4. Vous pouvez contacter votre FAI pour le savoir, ou demander à un proche (s'il est doué en informatique, il le saura peut-être !). La prise en charge d'IPv6 est prévue.*
|
||||
|
||||
## Configuration du serveur
|
||||
|
||||
La configuration comprend les étapes suivantes, vous devez toutes les suivre.
|
||||
|
||||
### **1. Redirection de port**
|
||||
|
||||
!!! info
|
||||
|
||||
```
|
||||
Si vous êtes sur un VPS (Virtual Private Server), un Rootserver, ou si vous prévoyez d'héberger ce serveur localement (avec des joueurs dans la même maison que vous), vous pouvez sauter cette étape.
|
||||
Cette étape est nécessaire si vous voulez que quelqu'un **en dehors** de votre foyer rejoigne votre serveur hébergé localement (en dehors de votre réseau local).
|
||||
|
||||
! !! danger ":material-scale-balance: AVERTISSEMENT :"
|
||||
|
||||
**Le transfert de port est un risque**.
|
||||
|
||||
En transférant des ports, vous comprenez les risques liés à l'ouverture au public des ports de votre réseau domestique et vous annulez donc le droit de tenir BeamMP pour responsable de **tous** les dommages qui pourraient survenir à vous ou à votre foyer.
|
||||
|
||||
Nous ne sommes pas responsables du contenu des services ou sites web externes.
|
||||
|
||||
Il est donc recommandé d'héberger un serveur avec l'un de nos services partenaires !
|
||||
|
||||
*Veuillez consulter [ce guide sur la façon de rediriger un port](port-forwarding.md)*.
|
||||
```
|
||||
|
||||
#### Services d'hébergement partenaires (payants) :
|
||||
|
||||
- [Horizon Hosting](https://hrzn.link/beammp)
|
||||
- [RackGenius](https://rackgeni.us/beammp-plans)
|
||||
- [Connect Hosting](https://connecthosting.net/beammp)
|
||||
- [Assetto Hosting](https://assettohosting.com/en/games/beamng)
|
||||
- [Zap Hosting](https://zap-hosting.com/en/beammp-server-hosting/)
|
||||
- [HostHavoc](https://hosthavoc.com/)
|
||||
- [PedalHost](https://pedal.host/)
|
||||
- [Vyper Hosting](https://vyperhosting.com/r/beammp)
|
||||
- [BisectHosting](https://www.bisecthosting.com/beammp-server-hosting)
|
||||
- [Four Seasons Hosting](https://fourseasonshosting.com)
|
||||
- [Vertuo Hosting](https://vertuohosting.com)
|
||||
- [Winheberg](https://winheberg.fr/offres/gaming/beammp?lang=en)
|
||||
|
||||
#### 1.1 Pare-feu
|
||||
|
||||
Selon votre configuration, vous devrez peut-être autoriser BeamMP-Server à traverser votre pare-feu. C'est le cas sous Windows (la désactivation du pare-feu est généralement **inefficace** ) et sur de nombreux serveurs Linux préinstallés.
|
||||
|
||||
Vous devez autoriser le serveur BeamMP à traverser le pare-feu, **pour les connexions entrantes et sortantes** , ainsi que **pour les protocoles TCP et UDP** . Si votre pare-feu vous demande un port, il devra être identique à celui utilisé à l'étape « 1. Redirection de port » (généralement 30814).
|
||||
|
||||
Si vous rencontrez des problèmes, n'hésitez pas à les poser également sur notre [forum](https://forum.beammp.com) ou sur notre [serveur Discord](https://discord.gg/beammp) dans le canal `#support` .
|
||||
|
||||
### **2. Obtaining an Authentication Key**
|
||||
|
||||
La clé d'authentification, souvent appelée « AuthKey », est nécessaire pour rendre un serveur **public** accessible à la liste des serveurs. Il est toutefois recommandé d'ajouter également la clé d'authentification aux serveurs privés. Le nombre de clés est limité. Une clé peut être utilisée sur un serveur à la fois ; vous ne pouvez donc pas démarrer deux serveurs simultanément avec la même clé. Vous pouvez obtenir davantage de clés en soutenant le projet. Consultez [cet article](https://docs.beammp.com/support/player-faq/) pour plus d'informations.
|
||||
|
||||
!!! warning
|
||||
|
||||
```
|
||||
NE PARTAGEZ JAMAIS CETTE CLÉ ET NE LA MONTREZ À PERSONNE. TRAITEZ CECI COMME UN MOT DE PASSE.
|
||||
```
|
||||
|
||||
Vous aurez besoin d'un compte [Discord](https://discord.com) pour cette étape. Ceci est indispensable pour éviter le spam.
|
||||
|
||||
#### 2.1. Accès à la page des clés
|
||||
|
||||
Connectez-vous à [Keymaster](https://beammp.com/keymaster) via Discord. Depuis la page d'accueil de Keymaster, cliquez sur « Clés » à gauche de l'écran :
|
||||
|
||||
<figure markdown="">  </figure>
|
||||
|
||||
#### 2.2. Création d'une clé
|
||||
|
||||
Pour créer votre clé, cliquez sur le bouton vert "+" en haut à droite.
|
||||
|
||||
<figure markdown="">  </figure>
|
||||
|
||||
#### 2.3. Remplir les informations clés
|
||||
|
||||
Ensuite, remplissez le champ Nom du serveur (il s'agit uniquement du nom de la clé, et non du nom réel du serveur dans la liste), puis cliquez sur « Créer ». Exemple :
|
||||
|
||||
<figure class="image image_resized" style="width:44.84%;" markdown="">  </figure>
|
||||
|
||||
Cela devrait, au final, ressembler à ceci :
|
||||
|
||||
<figure markdown="">  </figure>
|
||||
|
||||
#### 2.4. Copie de la clé
|
||||
|
||||
Copiez maintenant le texte dans le champ « Clé », dans cet exemple : `3173a2e-6az0-4542-a3p0-ddqq5ff95558` et conservez-le pour l'étape suivante. Pour ce faire, cliquez sur le presse-papiers à droite de la clé :
|
||||
|
||||
<figure markdown="">  </figure>
|
||||
|
||||
### **3. Installation**
|
||||
|
||||
Le serveur BeamMP est disponible pour Windows et Linux. Les deux sections suivantes sont consacrées à Windows et Linux.
|
||||
|
||||
#### 3.a. Installation sous Windows
|
||||
|
||||
Pour l’installation de Linux, voir l’étape suivante.
|
||||
|
||||
Assurez-vous d'avoir redirigé vos ports avant d'héberger un serveur chez vous ! Sans redirection de port, vous ne pourrez pas héberger de serveur public !
|
||||
|
||||
1. Assurez-vous d’avoir installé le [redistribuables de Visual C++](https://aka.ms/vs/17/release/vc_redist.x64.exe) afin d’exécuter le serveur.
|
||||
2. Téléchargez l'exécutable du serveur depuis [beammp.com](https://www.beammp.com/) . Vous devriez obtenir un fichier exécutable, nommé par exemple `BeamMP-Server.exe` .
|
||||
3. Une fois téléchargé, créez un dossier et placez-y le `BeamMP-Server.exe` . C'est là que votre serveur sera hébergé.
|
||||
4. Démarrez le serveur en double-cliquant dessus. Tous les fichiers nécessaires seront alors générés. Une fois le texte affiché, vous pourrez le fermer et passer à l'étape suivante. Vous devriez voir un fichier `ServerConfig.toml` à côté de votre `BeamMP-Server.exe` .
|
||||
5. (facultatif) Pour un accès rapide à l'avenir, vous pouvez facilement créer un raccourci sur le bureau vers `BeamMP-Server.exe` en utilisant **[Clic droit]** > **Envoyer vers** > **Bureau (créer un raccourci).**
|
||||
|
||||
Passez maintenant à l’étape [4. Configuration](#4-configuration) .
|
||||
|
||||
#### 3.b. Installation sous Linux
|
||||
|
||||
##### Utilisation de notre build (recommandé)
|
||||
|
||||
Cette étape fonctionne sur toutes les distributions pour lesquelles nous fournissons des binaires [ici](https://github.com/BeamMP/BeamMP-Server/releases/latest) . Si vous utilisez une distribution ou une architecture différente, reportez-vous à l'étape « Création à partir des sources » ci-dessous.
|
||||
|
||||
1. Assurez-vous que les dépendances répertoriées [ici](https://github.com/BeamMP/BeamMP-Server#runtime-dependencies) sont installées.
|
||||
2. Accédez à [beammp.com](https://beammp.com/) et cliquez sur le bouton « Télécharger le serveur », vous serez redirigé vers la page de publication Github du serveur.
|
||||
3. Téléchargez la version adaptée à votre distribution. Par souci de simplicité, elle s'appellera désormais `BeamMP-Server-xxx` , où `xxx` désigne la version de la distribution que vous utilisez.
|
||||
4. Une fois téléchargé, vous devriez voir un fichier nommé `BeamMP-Server-xxx` , parmi d'autres que vous pouvez ignorer pour l'instant. Créez un dossier et placez-y `BeamMP-Server-xxx` . C'est là que votre serveur sera hébergé.
|
||||
5. Ouvrez un terminal, accédez au dossier où se trouve `BeamMP-Server-xxx` et exécutez `chmod +x BeamMP-Server-xxx` . Cela vous permet de vous assurer que vous disposez des autorisations nécessaires pour l'exécuter.
|
||||
6. Démarrez le serveur une fois en l'exécutant avec `./BeamMP-Server-xxx` . Cela générera tous les fichiers nécessaires. Une fois le texte affiché, vous pourrez le fermer et passer à l'étape suivante. Vous devriez voir un fichier `ServerConfig.toml` à côté de votre `BeamMP-Server-xxx` .
|
||||
7. (facultatif) Il est fortement recommandé de configurer un utilisateur nommé `beammpserver` (ou similaire), car nous déconseillons d'exécuter le serveur en tant que root, sudo ou avec votre compte utilisateur personnel. Assurez-vous ensuite de démarrer le serveur uniquement avec cet utilisateur.
|
||||
|
||||
Passez maintenant à l'étape « 4. Configuration ».
|
||||
|
||||
##### Construire à partir de la source
|
||||
|
||||
D'autres distributions, outre celles disposant déjà d'un binaire [,](https://github.com/BeamMP/BeamMP-Server/releases/latest) sont susceptibles de fonctionner, mais ne sont pas officiellement prises en charge. Si vous souhaitez le compiler vous-même, vous pouvez le faire en téléchargeant le code source sur notre [GitHub](https://github.com/BeamMP/BeamMP-Server) . Un tutoriel est disponible [ici](https://github.com/BeamMP/BeamMP-Server#build-instructions) .
|
||||
|
||||
À la fin, assurez-vous d’exécuter votre serveur une fois avec `./BeamMP-Server` , puis passez à l’étape suivante.
|
||||
|
||||
### **4. Configuration**
|
||||
|
||||
Après avoir exécuté le serveur une fois, il devrait avoir créé des fichiers et probablement généré une ou deux erreurs. Ceci est dû au fait que nous n'avons pas encore terminé. Votre dossier devrait contenir les fichiers suivants :
|
||||
|
||||
<figure markdown="">  </figure>
|
||||
|
||||
Ils s'appellent « ServerConfig.toml », « Server.log » et « BeamMP-Server.exe » ! (Selon vos paramètres, les extensions [.toml] [.log] [.exe] pourraient ne pas s'afficher.)
|
||||
|
||||
Ouvrez le fichier `ServerConfig.toml` avec un éditeur de texte tel que `Notepad` . Pour ce faire, cliquez sur [Clic droit] → « Ouvrir avec… », puis sélectionnez un éditeur de texte.
|
||||
|
||||
Vous devriez voir quelque chose comme ceci :
|
||||
|
||||
```TOML
|
||||
[General]
|
||||
AuthKey = ''
|
||||
Debug = false
|
||||
Description = 'BeamMP Default Description'
|
||||
Map = '/levels/gridmap_v2/info.json'
|
||||
MaxCars = 1
|
||||
MaxPlayers = 10
|
||||
Name = 'BeamMP Server'
|
||||
Port = 30814
|
||||
Private = false
|
||||
ResourceFolder = 'Resources'
|
||||
```
|
||||
|
||||
Il s'agit de votre fichier de configuration. Il utilise un format appelé TOML. Consultez la section [« Maintenance du serveur »](server-maintenance.md) pour plus d'informations sur ce fichier.
|
||||
|
||||
Pour l'instant, seul le champ `AuthKey` nous intéresse. Collez entre les guillemets `''` que vous avez copié à la première étape.
|
||||
|
||||
Pour notre exemple de clé, cela devrait alors ressembler à ceci :
|
||||
|
||||
```TOML
|
||||
AuthKey = '3173a2e-6az0-4542-a3p0-ddqq5ff95558'
|
||||
```
|
||||
|
||||
Donnez également un nom à votre serveur dans le champ `Name` . Vous pouvez le personnaliser avec des couleurs et d'autres options. Consultez [la section « Personnalisation du nom »](server-maintenance.md#customize-the-look-of-your-server-name) de la page de maintenance du serveur.
|
||||
|
||||
Si vous avez choisi un **port** différent de **30814** , assurez-vous de le remplacer ici sous `Port` .
|
||||
|
||||
!!! info
|
||||
|
||||
```
|
||||
Votre serveur n'apparaîtra **PAS** dans la liste des serveurs tant que le champ `Private = true` à comme option "True. _Si_ vous souhaitez qu'il apparaisse dans la liste, définissez-le sur **`Private = false`**.
|
||||
```
|
||||
|
||||
### **5. Validation**
|
||||
|
||||
Redémarrez votre serveur et vérifiez s'il affiche d'autres messages `[ERROR]` ou `[WARN]` . Le serveur devrait rester ouvert. Les étapes suivantes (6.) vous expliqueront comment rejoindre le serveur.
|
||||
|
||||
---
|
||||
|
||||
#### 5.1 Comment ajouter des mods à votre serveur
|
||||
|
||||
L'installation des mods de véhicules et de cartes est différente, mais ils doivent tous deux être placés dans le dossier `Resources/Client` de votre serveur. Il vous suffit de glisser le mod souhaité dans ce dossier.
|
||||
|
||||
!!! warning
|
||||
|
||||
```
|
||||
Si vous recevez un message « terminé » ou « démarrer » lorsque vous essayez de rejoindre votre serveur après avoir ajouté des mods, vous avez probablement ajouté un mod incompatible ou cassé à votre serveur.
|
||||
Des incompatibilités de mods peuvent également survenir entre deux ou plusieurs mods. Si vous avez installé des mods clients, consultez ce guide pour savoir comment les supprimer de votre jeu.
|
||||
```
|
||||
|
||||
#### 5.2 Mods généraux
|
||||
|
||||
Si vous souhaitez uniquement ajouter des véhicules moddés, placez simplement le fichier zip du mod dans le dossier `Resources/Client` . Il sera automatiquement téléchargé par toute personne rejoignant votre serveur.
|
||||
|
||||
#### 5.3 Cartes
|
||||
|
||||
Toutes les cartes par défaut (hors mods) sont prêtes à l'emploi et ne nécessitent aucune installation. Il suffit de modifier le paramètre `Map` du fichier `ServerConfig.toml` pour choisir l'une de [ces options](server-maintenance.md#all-vanilla-maps-names) . Pour les autres cartes moddées, procédez comme suit :
|
||||
|
||||
1. Placez le fichier `.zip` de votre carte dans le dossier ( `Resources/Client` ) de votre serveur.
|
||||
2. Ensuite, consultez le fichier zip de la carte (sans l'extraire) et ouvrez le dossier `levels` . Ce dossier devrait contenir un autre dossier portant le nom de la carte, par exemple « myawesomedriftmap2021 ». Assurez-vous de copier ou de mémoriser ce nom *tel qu'il figure dans le dossier.*
|
||||
3. Ouvrez votre `ServerConfig.toml` . Dans les paramètres `Map` , vous devriez voir `/levels/MAPNAME/info.json` , où `MAPNAME` est probablement quelque chose comme `gridmap_v2` . Vous devez maintenant remplacer ce `MAPNAME` par le nom du dossier de l'étape précédente ; dans cet exemple, il s'agissait de `myawesomedriftmap2021` . Le résultat devrait ressembler à ceci (pour cet exemple) et ***contenir*** `/info.json` .
|
||||
|
||||
```TOML
|
||||
Map = '/levels/myawesomedriftmap2021/info.json'
|
||||
```
|
||||
|
||||
Désormais, lorsque quelqu'un rejoint votre serveur, il devrait télécharger la carte automatiquement et fonctionner comme prévu.
|
||||
|
||||
**Si cela ne fonctionne pas** , installez la carte sur votre disque BeamNG.drive solo, lancez-le et accédez à la carte. Ensuite, ouvrez la console en appuyant sur la touche `~` ( *tilde* ) (si vous utilisez un clavier non américain, consultez l'action «** Basculer la console système »** dans le menu **Options > Contrôles > Liaisons** , sous la section **« Débogage général »** ), puis exécutez `print(getMissionFilename())` . Le nom à utiliser devrait alors s'afficher.
|
||||
|
||||
Et voilà ! Votre carte modifiée devrait maintenant être disponible pour rejoindre la partie !
|
||||
|
||||
### **6. Comment rejoindre votre serveur**
|
||||
|
||||
Comment vous et d'autres joueurs pouvez rejoindre votre serveur.
|
||||
|
||||
#### 6.a. Rejoindre votre propre serveur (privé et public)
|
||||
|
||||
Si votre serveur est hébergé sur le même PC que celui sur lequel le jeu tourne, vous devez vous connecter directement à votre serveur. Pour cela, cliquez sur l' **onglet « Connexion directe »** à gauche de la liste des serveurs. Laissez les informations par défaut (127.0.0.1 et le port correspondant), puis cliquez sur « Se connecter ».
|
||||
|
||||
Si votre serveur est hébergé sur un autre PC de votre réseau local, vous devez trouver l'IP locale de cette machine et vous connecter directement à l'aide de cette IP locale.
|
||||
|
||||
Si votre serveur est hébergé à l'extérieur de votre maison (par exemple VPS), vous devez trouver l' [IP publique](https://whatismyipaddress.com/) de cette machine et vous connecter directement de cette façon.
|
||||
|
||||
#### 6.b. Autres personnes rejoignant votre serveur privé
|
||||
|
||||
Vous devez communiquer l'adresse IP publique de votre serveur aux autres utilisateurs. Attention toutefois à ne pas la partager avec des inconnus ! Pour rejoindre votre serveur privé, les joueurs doivent accéder à l' **onglet Connexion directe** de BeamMP, puis saisir leur adresse IP et leur port.
|
||||
|
||||
#### 6.c. Other people joining your public server
|
||||
|
||||
Pour rejoindre votre serveur public, il suffit d'accéder à la liste des serveurs, de saisir son nom et de cliquer sur « Se connecter ». En cas de doute, le nom de votre serveur sera celui que vous avez saisi dans le fichier `ServerConfig.toml` . Si vous ne le trouvez pas, assurez-vous que les filtres de recherche sont désactivés et que la carte est définie sur « Tout ». Vous pouvez également consulter le site web [de Keymaster](https://beammp.com/keymaster) pour connaître l'adresse IP du serveur.
|
||||
|
||||
Si vous ou vos amis rencontrez une erreur « Échec de la connexion ! », recherchez des codes tels que 10060, 10061 ou 10030 dans la fenêtre de lancement. Cela signifie que vous utilisez une IPv4 CGNAT ou que vous avez effectué une erreur lors de l'étape** 1 de redirection de port** ou **de la section 1.1 du pare-feu.** Pour vérifier si vous utilisez une IPv4 CGNAT, recherchez l'adresse IP WAN sur l'interface de votre routeur. Comparez-la à votre [IP publique](https://www.whatsmyip.org/) . Si elles sont identiques, vous n'utilisez pas d'IPv6. La prise en charge d'IPv6 **n'est pas** encore implémentée.
|
||||
|
||||
### **7. Comment vérifier la connectivité de votre serveur BeamMP**
|
||||
|
||||
Saisissez l'IPv4 publique et le port des serveurs ci-dessous, puis cliquez sur « CheckBeamMP ».
|
||||
|
||||
<form action="https://check.beammp.com/api/v2/beammp" method="get" target="_blank">
|
||||
<label for="ip">IP adress:</label>
|
||||
<input type="text" id="ip" name="ip"><br>
|
||||
<label for="port">Port:</label>
|
||||
<input type="text" id="port" name="port"><br>
|
||||
<input type="submit" value="CheckBeamMP">
|
||||
</form>
|
||||
|
||||
!!! warning "Je souhaite utiliser un VPN tel que RadminVPN, Hamachi ou similaire."
|
||||
|
||||
```
|
||||
BeamMP ne prend pas en charge ces VPN, car ils posent souvent problème. L'un de ces problèmes est le non-transfert du trafic UDP. Pour résoudre ce problème, consultez la section 1.
|
||||
|
||||
!!! question "Mais pourquoi cela a-t-il fonctionné dans le passé ?"
|
||||
|
||||
Cela est dû au fait que les développeurs de ces applications mettent à jour leurs logiciels et mettent en œuvre des modifications sur lesquelles BeamMP n'a aucun contrôle.
|
||||
Il appartient aux développeurs de ces applications de fournir un support pour des cas d'utilisation spécifiques comme un serveur BeamMP.
|
||||
```
|
||||
|
||||
## Vous rencontrez toujours des problèmes ?
|
||||
|
||||
Ouvrez un fil de discussion sur le [forum](https://forum.beammp.com) ou demandez de l'aide sur notre [serveur Discord](https://discord.gg/beammp) dans le canal `#support` .
|
||||
20
docs/fr/server/error-codes.md
Normal file
20
docs/fr/server/error-codes.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# Codes d'erreur
|
||||
|
||||
Cette page contient tous les codes d'erreur que le serveur peut afficher.
|
||||
|
||||
---
|
||||
|
||||
Code | Description | Solution possible
|
||||
--- | --- | ---
|
||||
10022 | Il y a un problème avec la liaison au port | Vérifiez si le port du serveur est déjà utilisé par un autre service, si c'est le cas, utilisez-en un autre.
|
||||
10048 | Adresse déjà utilisée | Un autre serveur ou programme BeamMP est en cours d'exécution sur ce port, utilisez-en un autre.
|
||||
10051 | Réseau inaccessible | Mauvaise redirection de port ou problèmes similaires, vérifiez que tout est correctement configuré.
|
||||
10052 | Réinitialisation du réseau | Cela se produit si le réseau perd la connexion pendant l'établissement d'une connexion. Réessayez la connexion.
|
||||
10053 | Connexion interrompue | En raison d'un délai d'attente ou d'une erreur réseau, réessayez la connexion.
|
||||
10054 | Connexion réinitialisée par un homologue | Un client s'est déconnecté de votre serveur.
|
||||
10060 | La connexion a expiré | Il y a un problème avec votre redirection de port, veuillez vous référer aux [étapes de ce guide](create-a-server.md#1-port-forwarding) .
|
||||
10061 | Connexion rejetée | Il y a un problème avec votre redirection de port, veuillez vous référer aux [étapes de ce guide](create-a-server.md#1-port-forwarding) .
|
||||
10064 | Hôte en panne | Erreur peu probable, mais cela signifie que l'hôte est en panne parce qu'il est arrêté ou que les ports ont été fermés.
|
||||
10065 | Hôte non joignable | Pas d'Internet ou mauvaise redirection de port, veuillez vous référer aux [étapes de ce guide](create-a-server.md#1-port-forwarding) .
|
||||
|
||||
!!! note Pour tout autre code ne figurant pas dans cette liste, vous pouvez vous référer à [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2) si vous savez un peu comment fonctionnent les réseaux / sockets.
|
||||
87
docs/fr/server/manual.md
Normal file
87
docs/fr/server/manual.md
Normal file
@@ -0,0 +1,87 @@
|
||||
# Serveur Manuel
|
||||
|
||||
# Environnement
|
||||
|
||||
Le serveur est affecté par l'état de divers paramètres externes :
|
||||
|
||||
- Le dossier « Ressources »
|
||||
- L'ENV (environnement de processus)
|
||||
- Les arguments de la ligne de commande
|
||||
- Le fichier ServerConfig.toml
|
||||
- Le répertoire de travail
|
||||
|
||||
## Dossier de ressources
|
||||
|
||||
Le dossier « ressources » est créé au démarrage du serveur, avec les sous-répertoires « Client » et « Serveur ». Le sous-répertoire « Serveur » accepte des dossiers contenant chacun au moins un fichier `.lua` . Chacun de ces dossiers est appelé « Plugin ». Les fichiers `.lua` contenus dans le répertoire principal d'un plugin sont rechargés à chaud en cas de modification. Le sous-répertoire « Client » accepte *uniquement* les fichiers `.zip` , chargés au démarrage du serveur et supposés inchangés pendant l'exécution.
|
||||
|
||||
## ENV
|
||||
|
||||
### Paramètres Général
|
||||
|
||||
Depuis la version 3.2.0 du serveur, le serveur BeamMP accepte les variables d'environnement, qui **remplacent** les paramètres du fichier ServerConfig.toml. Toutes les variables ServerConfig de la catégorie/section « Général » sont en PascalCase ; elles sont en majuscules et préfixées par `BEAMMP_` . Par exemple, le paramètre `MaxPlayers` converti en majuscules est `MAX_PLAYERS` (notez le `_` au début d'un nouveau mot) et préfixé par `BEAMMP_MAX_PLAYERS` . Ce format est utilisé pour tous les paramètres « Général ». Les variables d'environnement suivantes existent :
|
||||
|
||||
- `BEAMMP_DEBUG`
|
||||
- `BEAMMP_PRIVATE`
|
||||
- `BEAMMP_PORT`
|
||||
- `BEAMMP_MAX_CARS`
|
||||
- `BEAMMP_MAX_PLAYERS`
|
||||
- `BEAMMP_MAP`
|
||||
- `BEAMMP_NAME`
|
||||
- `BEAMMP_DESCRIPTION`
|
||||
- `BEAMMP_TAGS`
|
||||
- `BEAMMP_RESOURCE_FOLDER`
|
||||
- `BEAMMP_AUTH_KEY`
|
||||
- `BEAMMP_LOG_CHAT`
|
||||
|
||||
Toutes les variables d'environnement correspondant à des paramètres de configuration (chaînes ou nombres) doivent être des chaînes, par exemple `BEAMMP_NAME="Cool Server"` , `BEAMMP_NAME=Server1` , `BEAMMP_PORT=12345` . Les variables d'environnement correspondant à des paramètres de configuration booléens (true/false, on/off) doivent être soit `true` , soit `1` (les deux signifiant ON), ou toute autre valeur (signifiant OFF).
|
||||
|
||||
### Paramètres du fournisseur
|
||||
|
||||
Ces variables d'environnement permettent aux fournisseurs d'hébergement (et aux autres utilisateurs disposant d'un plus grand nombre de serveurs), ici appelés « fournisseurs », d'écraser certains paramètres spécifiques au fournisseur.
|
||||
|
||||
#### `BEAMMP_PROVIDER_PORT_ENV` (depuis la version 3.3.0)
|
||||
|
||||
Lorsqu'elle est définie sur une chaîne non vide, la variable `BEAMMP_PORT` est remplacée par une autre, afin de pouvoir la lire depuis un environnement existant. Par exemple, Pterodactyl peut exposer `SERVER_PORT` comme environnement. Pour l'utiliser avec BeamMP-Server, il faudrait utiliser `BEAMMP_PORT=${SERVER_PORT}` , ce qui est un peu absurde.
|
||||
|
||||
Au lieu de cela, vous pouvez désormais utiliser `BEAMMP_PROVIDER_PORT_ENV="SERVER_PORT"` , ce qui conduit BeamMP-Server à lire le port à partir de la variable `SERVER_PORT` ENV.
|
||||
|
||||
#### `BEAMMP_PROVIDER_DISABLE_CONFIG` (depuis la version 3.3.0)
|
||||
|
||||
Si la valeur est `1` ou `true` , le `ServerConfig.toml` **n'est pas généré** et **n'est pas lu** s'il existe. La `BEAMMP_AUTH_KEY` doit être définie pour que le serveur fonctionne.
|
||||
|
||||
#### `BEAMMP_PROVIDER_UPDATE_MESSAGE` (depuis la version 3.2.2)
|
||||
|
||||
Si la chaîne est non vide, elle remplace l'intégralité du message de mise à jour, qui est par défaut « NOUVELLE VERSION ! Veuillez mettre à jour vers la nouvelle… », etc. Le message de mise à jour que vous fournissez doit **obligatoirement** contenir `{}` , que le serveur remplacera par le nouveau numéro de version. Par exemple, votre message de mise à jour pourrait ressembler à ceci :
|
||||
|
||||
```sh
|
||||
BEAMMP_PROVIDER_UPDATE_MESSAGE="Une nouvelle version du serveur BeamMP est disponible : {} ! Veuillez suivre le guide de mise à jour ici : https://example.com/update-"
|
||||
```
|
||||
|
||||
Ce qui entraînerait un message de mise à jour comme
|
||||
|
||||
```
|
||||
Une nouvelle version du serveur BeamMP est disponible : v5.0.2 ! Veuillez suivre le guide de mise à jour ici : https://example.com/update-guide
|
||||
```
|
||||
|
||||
Veuillez veiller à bien faire comprendre aux utilisateurs qu'ils doivent effectuer la mise à jour et à leur expliquer comment procéder.
|
||||
|
||||
## Arguments de ligne de commande
|
||||
|
||||
Exécutez le serveur BeamMP avec l'argument `--help` pour en savoir plus. Par exemple : `./BeamMP-Server --help` .
|
||||
|
||||
## ServerConfig.toml
|
||||
|
||||
Ce fichier est généré au premier démarrage. Les commentaires contenus dans le fichier constituent le moyen le plus récent de comprendre la fonction de chaque paramètre.
|
||||
|
||||
## Répertoire de travail
|
||||
|
||||
Le répertoire de travail du serveur, et non l'emplacement de l'exécutable du serveur, est le facteur déterminant sur l'endroit où le ServerConfig.toml, les fichiers journaux du serveur et le dossier Ressources sont générés.
|
||||
|
||||
# Limites
|
||||
|
||||
Les limitations suivantes sont appliquées dans le backend BeamMP, ce qui affecte les serveurs :
|
||||
|
||||
- Le nom est limité à 250 caractères
|
||||
- La description est limitée à 1000 caractères
|
||||
- La carte est limitée à 100 caractères
|
||||
- Les tags sont limités à 100 caractères
|
||||
237
docs/fr/server/server-maintenance.md
Normal file
237
docs/fr/server/server-maintenance.md
Normal file
@@ -0,0 +1,237 @@
|
||||
# Maintenance du serveur
|
||||
|
||||
Guides et astuces sur la façon de configurer et de prendre soin d'un serveur BeamMP.
|
||||
|
||||
## Comment installer
|
||||
|
||||
Pour les instructions d'installation, veuillez consulter [l'installation du serveur](create-a-server.md) .
|
||||
|
||||
## Le fichier ServerConfig
|
||||
|
||||
La configuration du serveur, qui est un fichier appelé `ServerConfig.toml` , utilise le [format TOML](https://toml.io/en/) .
|
||||
|
||||
*REMARQUE* : L' *ancien* fichier de configuration du serveur s'appelait `Server.cfg` , mais il n'est plus utilisé et le serveur vous avertira s'il est toujours présent. Veuillez également noter que les deux formats de configuration ne sont **pas** compatibles.
|
||||
|
||||
La configuration comporte une section par défaut, appelée `[General]` , qui contient les valeurs suivantes :
|
||||
|
||||
Key | Type de valeur | Description
|
||||
--- | --- | ---
|
||||
AuthKey | Format AuthKey `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` où tous les x sont des caractères alphanumériques (chiffres et lettres) | Utilisé pour identifier votre serveur auprès du backend. Vous devriez en avoir obtenu un en suivant les instructions d'installation.
|
||||
Debug | true /false | Si cette option est activée (true), davantage de messages seront affichés dans le journal et des informations supplémentaires seront fournies. Activez-la en cas de problème. L'activation de cette option augmentera considérablement la taille du fichier journal.
|
||||
Private | true/false | Si cette option est activée (true), votre serveur n'apparaîtra pas dans la liste des serveurs. Toute personne disposant de l'adresse IP et du port corrects pourra se connecter.
|
||||
Description | Tout « texte » | Affiché comme description du serveur dans la liste des serveurs (si le serveur est public). Vous pouvez utiliser des caractères spéciaux pour le formater avec des couleurs et des styles.
|
||||
Name | Tout « texte » | Affiché comme nom/titre de votre serveur dans la liste des serveurs. Vous pouvez utiliser des caractères spéciaux pour le formater avec des couleurs et des styles.
|
||||
Map | Un emplacement de carte valide, tel que `/levels/gridmap_v2/info.json` | La carte que votre serveur hébergera. Elle doit être installée soit par défaut (liste ci-dessous), soit en tant que mod de serveur.
|
||||
MaxCars | Tout nombre ≥ 1 | Nombre maximal de voitures par joueur. Toute voiture supplémentaire qu'un joueur tentera de faire apparaître sera supprimée instantanément.
|
||||
Port | 1024-65535 | Le port réseau sur lequel le serveur sera accessible. Pour qu'un joueur puisse se connecter directement à votre serveur, il aura besoin de votre adresse IP et de ce port.
|
||||
|
||||
D'autres sections peuvent et doivent être utilisées par les plugins du serveur (API Lua à venir), comme ceci : `[MyMod]` .
|
||||
|
||||
Vous **devez** définir la clé d'authentification. Elle est vide par défaut et doit être renseignée avec la clé d'authentification obtenue lors de l'installation précédente. Ne la partagez avec personne et floutez-la complètement sur les captures d'écran.
|
||||
|
||||
### Tous les noms de cartes vanilla
|
||||
|
||||
Voici toutes les cartes en stock :
|
||||
|
||||
- /levels/gridmap_v2/info.json
|
||||
- /levels/johnson_valley/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
|
||||
|
||||
### Personnalisez l'apparence du nom de votre serveur
|
||||
|
||||
Utilisez ces symboles spéciaux avant votre texte et ils appliqueront un effet à ce texte dans la liste des serveurs :
|
||||
|
||||
Valeur | Description
|
||||
:-: | ---
|
||||
`^r` | Réinitialiser
|
||||
`^p` | Nouvelle ligne (descriptions uniquement)
|
||||
`^n` | Souligner
|
||||
`^l` | Gras
|
||||
`^m` | Barré
|
||||
`^o` | Italique
|
||||
`^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` | Light blue
|
||||
`^c` | Orange foncé
|
||||
`^d` | Rose clair
|
||||
`^e` | Jaune
|
||||
`^f` | Blanc
|
||||
|
||||
### Personnalisez les tags de votre serveur
|
||||
|
||||
Les tags peuvent être utilisées pour permettre aux utilisateurs de rechercher un type de serveur spécifique. Votre fichier serverConfig.toml sera généré avec la balise freeroam `Tags = "Freeroam"` .
|
||||
|
||||
Vous pouvez ajouter plusieurs tags séparées par une virgule `Tags = "Events,Offroad,lang:english"` , elles ne sont pas sensibles à la casse.
|
||||
|
||||
Vous pouvez choisir parmi la liste suivante :
|
||||
|
||||
- Âge/Contenu :
|
||||
|
||||
- `Mature/18+`
|
||||
|
||||
- Types de jeu :
|
||||
|
||||
- `Freeroam`
|
||||
- `Roleplay`
|
||||
- `Economy`
|
||||
- `Traffic`
|
||||
|
||||
- Catégories de courses :
|
||||
|
||||
- `Racing`
|
||||
- `Racing:NASCAR`
|
||||
- `Racing:Track`
|
||||
- `Racing:Drag`
|
||||
- `Racing:Rally`
|
||||
- `Touge`
|
||||
|
||||
- Tout-terrain et défis :
|
||||
|
||||
- `Offroad`
|
||||
- `Crawling`
|
||||
- `Dakar`
|
||||
- `Challenge`
|
||||
|
||||
- Événements de destruction :
|
||||
|
||||
- `Derby`
|
||||
- `Arena`
|
||||
|
||||
- Conditions météorologiques et horaires :
|
||||
|
||||
- `Snow/Ice`
|
||||
- `Rain`
|
||||
- `Night`
|
||||
- `Weather`
|
||||
|
||||
- Modes de jeu :
|
||||
|
||||
- `Gamemode`
|
||||
- `Gamemode:Racing`
|
||||
- `Gamemode:Rally`
|
||||
- `Gamemode:Drag`
|
||||
- `Gamemode:Derby`
|
||||
- `Gamemode:Infection`
|
||||
- `Gamemode:Cops-Robbers`
|
||||
- `Gamemode:Delivery`
|
||||
- `Gamemode:Sumo`
|
||||
|
||||
- Communauté et événements :
|
||||
|
||||
- `Scenarios`
|
||||
- `Events`
|
||||
- `Leaderboard`
|
||||
|
||||
- Mods:
|
||||
|
||||
- `Modded`
|
||||
- `Mod:BeamPaint`
|
||||
- `Mod:BeamJoy`
|
||||
- `Mod:CEI`
|
||||
|
||||
- Langues:
|
||||
|
||||
- `Lang:English`
|
||||
- `Lang:Russian`
|
||||
- `Lang:French`
|
||||
- `Lang:Spanish`
|
||||
- `Lang:Portuguese`
|
||||
- `Lang:German`
|
||||
- `Lang:Polish`
|
||||
- `Lang:Arabic`
|
||||
|
||||
- Autre:
|
||||
|
||||
- `Vanilla`
|
||||
- `Moderated`
|
||||
|
||||
Si une balise manque dans cette liste, vous pouvez soumettre une demande pour qu'elle soit ajoutée [ici](https://forum.beammp.com/t/introducing-server-tags/1320081)
|
||||
|
||||
## Le fichier Server.log
|
||||
|
||||
Ce fichier sera généré lors de l'exécution du serveur. Il reproduit les messages affichés dans la console lors de l'exécution du serveur. Vous devez joindre ce fichier à chaque fois que vous avez besoin d'aide auprès de notre équipe d'assistance. Il n'affichera jamais votre clé d'authentification ; vous pouvez donc généralement l'envoyer sans modification.
|
||||
|
||||
Le format est le suivant (le préfixe "$" signifie « variable », expliqué ci-dessous) :
|
||||
|
||||
```
|
||||
[$DATE $TIME] $CONTEXT [$LOG_LEVEL] $MESSAGE
|
||||
```
|
||||
|
||||
Où:
|
||||
|
||||
- `$DATE` est la date du message, par exemple 21/07/2021
|
||||
- `$TIME` est l'heure du message, par exemple 11:05:23
|
||||
- `$CONTEXT` (visible uniquement en mode débogage et principalement destiné aux développeurs) est le contexte du message, qui est soit :
|
||||
- `(Player ID) “Player Name”` , où l'ID du joueur est utile pour la modération
|
||||
- Un nom court tel que « Baguette »
|
||||
- `$LOG_LEVEL` est l'un des niveaux d'importance d'un message :
|
||||
- `DEBUG` : visible uniquement en mode débogage, généralement spammé et important uniquement pour les développeurs
|
||||
- `INFO` : Informations générales
|
||||
- `LUA` : Message d'un plugin Lua
|
||||
- `WARN` : Décrit quelque chose qui n'est pas censé se produire, généralement
|
||||
- `ERROR` : Quelque chose s'est très mal passé ou était très inattendu
|
||||
- `FATAL` : Un événement s'est produit qui a provoqué l'arrêt du serveur
|
||||
- `$MESSAGE` le message lui-même, généralement important à comprendre. Dans certains cas, il peut être cryptique, mais en règle générale, tant que le serveur est opérationnel et qu'il n'y a pas d'erreur, tout va bien.
|
||||
|
||||
## Mise à jour du serveur
|
||||
|
||||
### Pourquoi mettre à jour
|
||||
|
||||
À chaque nouvelle mise à jour, il est conseillé de mettre à jour votre serveur. Cela implique généralement des corrections de bugs, des améliorations de stabilité et de sécurité, en plus des nouvelles fonctionnalités générales.
|
||||
|
||||
Pour recevoir des nouvelles des mises à jour dès leur sortie, suivez le canal « mise à jour » du serveur Discord, recherchez-le sur les forums ou consultez/demandez la [page des versions de GitHub](https://github.com/BeamMP/BeamMP-Server/releases) .
|
||||
|
||||
### Comment mettre à jour
|
||||
|
||||
#### Si vous utilisez un fournisseur d'hébergement partenaire BeamMP
|
||||
|
||||
Si vous utilisez un hébergeur partenaire de BeamMP, les instructions ci-dessous ne fonctionneront probablement pas. Nous vous recommandons d'attendre plus d'informations de votre hébergeur ou de le contacter pour obtenir de l'aide.
|
||||
|
||||
#### Gérer le serveur vous-même
|
||||
|
||||
La mise à jour du serveur se fait en remplaçant l'ancien exécutable par le nouveau. Si vous ne savez pas comment procéder, vous trouverez ci-dessous des instructions détaillées pour Windows et Linux.
|
||||
|
||||
Si vous avez compilé à partir des sources, il vous suffit de reconstruire. Assurez-vous d'exécuter `git submodule update --init --recursive` avant de reconstruire.
|
||||
|
||||
#### On Windows
|
||||
|
||||
1. Assurez-vous d’avoir installé les fichiers [redistribuables de Visual C++](https://aka.ms/vs/17/release/vc_redist.x64.exe) afin d’exécuter le serveur.
|
||||
2. Accédez à [BeamMP.com](https://beammp.com/) et cliquez sur le bouton « Télécharger le serveur ».
|
||||
3. Une fois téléchargé, vous devriez voir un fichier nommé `BeamMP-Server.exe` . Nous l'appellerons « nouvel exécutable ».
|
||||
4. Accédez au dossier où se trouve votre exécutable `BeamMP-Server.exe` actuel (généralement le même dossier que votre fichier `ServerConfig.toml` ). Nous l'appellerons « ancien exécutable ».
|
||||
5. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
|
||||
|
||||
#### Sous Linux
|
||||
|
||||
1. Accédez à [BeamMP.com](https://beammp.com/) et cliquez sur le bouton « Télécharger le serveur », vous serez redirigé vers la page de publication Github du serveur.
|
||||
2. Téléchargez la version adaptée à votre distribution. Par souci de simplicité, elle s'appellera désormais `BeamMP-Server-xxx` , où `xxx` désigne la version de la distribution que vous utilisez.
|
||||
3. Une fois téléchargé, vous devriez voir un fichier nommé `BeamMP-Server-xxx` selon la version téléchargée. Nous l'appellerons le « nouvel exécutable ».
|
||||
4. Accédez au dossier où se trouve votre exécutable `BeamMP-Server-xxx` actuel (généralement le même dossier que votre `ServerConfig.toml` ). Nous l'appellerons « ancien exécutable ».
|
||||
5. Remplacez l'ancien exécutable par le nouvel exécutable (par exemple en copiant ou en déplaçant le nouvel exécutable dans le dossier).
|
||||
6. Ouvrez un terminal dans le dossier où vous venez de remplacer l'exécutable et exécutez `sudo chmod +x BeamMP-Server-xxx` . Cela permettra de vérifier que le serveur peut être exécuté.
|
||||
|
||||
### Mises à jour automatiques
|
||||
|
||||
Le serveur ne prend pas en charge les mises à jour automatiques ni les notifications de mise à jour (pour l'instant).
|
||||
|
||||
Vous pouvez toutefois demander à l'API GitHub la dernière version en comparant la version du serveur aux balises. Vous pouvez l'obtenir via une commande GET depuis `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags` .
|
||||
Reference in New Issue
Block a user