BeamMP/Docs
1
0
Fork 0
mirror of https://github.com/BeamMP/Docs.git synced 2026-02-16 02:20:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'main' into gitlocalize-34818

Browse Source
This commit is contained in:
Protogen187
2025-09-10 08:04:31 +02:00
committed by GitHub
parent 39eeda7627 8c40bd10e8
commit 3d41635488
15 changed files with 1123 additions and 144 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/en/community/rules.md
View File

@@ -28,14 +28,19 @@ hide:
## Discord Rules
1. All Above Rules Apply Here :material-information-outline:{ title="All rules mentioned in this document apply to the voice chats." }
2. Follow Discord ToS & Guidelines :material-information-outline:{ title="Follow all rules outlined by Discord in their ToS and Guidelines" }
3. No NSFW Audio/Streams :material-information-outline:{ title="Players should not stream any content that violates BeamMP rules stated in Section 1 of this document." }
4. No Excessive Audio :material-information-outline:{ title="The excessive use of soundboards, playing music loudly or other uses of audio channels to intentionally agitate or target others is not allowed." }
5. No Join/Leave Spamming :material-information-outline:{ title="Most users will have sound effects enabled, do not join and leave chats rapidly." }
6. No Badgering Others (`@'ing`) :material-information-outline:{ title="This includes asking others repeatedly for a response after being ignored or told no." }
7. Keep bot commands in command specific channels
8. No Role-Playing :material-information-outline:{ title="This is in place to prevent issues arising due to missing context or to prevent users from circumventing certain rules." }
1. All Above Rules Apply Here :material-information-outline:{ title="All rules mentioned in this document apply to the voice chats." }
2. Follow Discord ToS & Guidelines :material-information-outline:{ title="Follow all rules outlined by Discord in their ToS and Guidelines" }
3. No NSFW Audio/Streams :material-information-outline:{ title="Players should not stream any content that violates BeamMP rules and Discord TOS." }
4. The rule above includes gambling Services/Websites.
5. No Excessive Audio :material-information-outline:{ title="Excessively using soundboards, playing loud music or other uses of audio channels to intentionally agitate or target others is prohibited." }
6. No Join/Leave Spamming :material-information-outline:{ title="Most users will have sound effects enabled, do not join and leave voice-chats rapidly." }
7. No Badgering Others (`@'ing`) :material-information-outline:{ title="This includes asking others repeatedly for a response after being ignored or told no." }
8. Keep bot commands in command specific channels.
10. No Role-Playing :material-information-outline:{ title="This is in place to prevent issues arising due to missing context or to prevent users from circumventing certain rules." }
11. Do not offer to remote into other users computers or send malicous files.
12. Do not explain/send links on how to pirate, acquire illegal copies of software, hacking accounts (Beaming), or paid mods.
13. Do not advertise non-BeamNG/BeamMP content. Sending Media of your own channel is only allowed in the dedicated [media channel](https://discord.com/channels/601558901657305098/705427325646274680).
14. Follow the instructions of Staff members. If you think a staff member is abusing their power, direct message their lead or project management.
## How to appeal actions against you:
@@ -44,4 +49,4 @@ hide:
All ban appeals are investigated thoroughly, involving at least two (2) members of the staff/moderation team that were not involved in the case-at-hand. The issuing staff member will be allowed to comment, but will not be otherwise involved in the appeal decision. These appeal outcomes are final. BeamMP reserves the right to allow or not allow members as they deem appropriate according to the BeamMP Community Rules (as above), [Discord ToS](https://discord.com/terms), and other factors.
!!! warning
In the event of action taken against you, you are prohibited from creating a new Discord or BeamMP account to circumvent the ban.
In the event of action taken against you, you are prohibited from creating a new Discord or BeamMP account to circumvent the ban.

245
docs/en/game/multiplayer-settings.md
View File

@@ -1,254 +1,255 @@
# Mutliplayer Settings
## **1. Général**
## **1. General**
??? setting "Afficher les options avancées"
??? setting "Show advanced options"
Si cette option est activée, vous verrez tous les paramètres multijoueurs.
If enabled, you will see all multiplayer settings
Si cette option est désactivée, seuls les paramètres de base du mode multijoueur s'afficheront.
If disabled, you will see only basic multiplayer settings
??? setting "Activer la protection contre le clonage de la configuration"
??? setting "Enable config cloning protection"
Si cette option est activée, la configuration de votre véhicule sera protégée contre les sauvegardes par d'autres joueurs.
If enabled, your spawned vehicle config will be protected from other players saving it
Si cette option est désactivée, la configuration du véhicule créé peut être sauvegardée par d'autres joueurs.
If disabled, your spawned vehicle config can be saved by other players
??? setting "Désactiver la mise en pause causée par des instabilités"
??? setting "Disable pausing caused by instabilities"
Si cette option est activée, les instabilités physiques n'entraîneront pas la mise en pause du jeu.
If enabled, physics instabilities will not cause your game to pause
Si cette option est désactivée, les instabilités physiques entraîneront la mise en pause du jeu.
If disabled, physics instabilities will cause your game to pause
!!! note ""
Il est conseillé de le laisser désactivé, car des instabilités répétées peuvent faire planter le jeu.
Its advised to leave disabled, since repeated instabilities can cause the game to crash
??? setting "Utiliser des véhicules simplifiés lorsqu'ils sont disponibles"
??? setting "Use simplified vehicles when available"
Si cette option est activée, le jeu remplacera les véhicules des autres joueurs par leurs versions simplifiées (provenant du trafic de l'IA) si elles sont disponibles.
If enabled, the game will replace vehicles of other players with their simplified versions (from AI traffic) if available
Si cette option est désactivée, le jeu utilisera les modèles de véhicules prévus.
If disabled, the game will use the intended vehicle models
??? setting "Nouveau menu de chat"
??? setting "New chat menu"
Si elle est activée, la discussion en cours de jeu sera affichée dans une fenêtre [IMGUI](https://github.com/ocornut/imgui), qui peut par exemple être déplacée hors du jeu sur un autre moniteur.
If enabled, the ingame chat will be displayed in an [IMGUI](https://github.com/ocornut/imgui) window, that for example can be dragged out of the game onto another monitor
S'il est désactivé, le chat en cours de jeu sera affiché en jeu.
If disabled, the ingame chat will be displayed in the UI app
!!! note ""
Le fait de faire glisser des fenêtres IMGUI hors de la fenêtre principale du jeu peut entraîner des problèmes de performance et tromper les logiciels d'enregistrement d'écran en leur faisant enregistrer la fenêtre de discussion au lieu de la fenêtre principale du jeu.
Dragging IMGUI windows out of the main game window can cause performance issues, as well as trick screen recording software into recording the chat window instead of the main game window
??? setting "Activer le lissage de la position du véhicule"
??? setting "Enable vehicle position smoothing"
Si cette option est activée, BeamMP utilisera un algorithme pour lisser les mises à jour de la position du véhicule à intervalles réguliers. Cela peut être bénéfique pour les joueurs ayant un ping élevé ou lorsqu'une connexion connaît un taux élevé d'abandon de paquets.
If enabled, beamMP will use an algorithm to smooth vehicle position updates to regular intervalls. Can be beneficial between players with high ping or when a connection experiences a high package drop rate
S'il est désactivé, BeamMP mettra à jour les positions des véhicules au fur et à mesure qu'elles sont reçues.
If disabled, beamMP will update vehicle locations as they are received
??? setting "Ignorer l'avertissement de sécurité des mods"
??? setting "Skip the mod security warning popusp"
Si cette option est activée, la fenêtre contextuelle de sécurité des mods ne s'affichera pas lorsque vous essayez de vous connecter à un serveur avec des mods
If enabled, the mod security popup will not be shown when trying to connect to a server with mods
Si elle est désactivée, la fenêtre contextuelle de sécurité des mods s'affichera à chaque fois que vous vous connecterez à un serveur avec des mods.
If disabled, the mod security popup will be shown whenever you connect to a server with mods
??? setting "Activation de la file d'attente pour les mises à jour/modifications des véhicules des joueurs"
??? setting "Enable player vehicle update/edit queuing"
Si cette option est activée, les véhicules des autres joueurs et les modifications seront placés dans une file d'attente. Voir la section `2. File d'attente d'événements` pour plus de détails
If enabled, other players vehicle spawns and edits will be put into a queue. See the section `2. Event queue` for further details
Si cette option est désactivée, les véhicules des autres joueurs seront chargés instantanément par le jeu.
If disabled, other players vehicle spawns and edits will be loaded by the game instantly
??? setting "Activer la synchronisation automatique des pièce des véhicules"
??? setting "Enable automatic part sync"
Si cette option est activée, les pièces de vos véhicules seront automatiquement synchronisées avec les autres joueurs après quelques secondes.
If enabled, your vehicles parts will automatically be synced to other players after a few seconds
Si cette option est désactivée, vous devez cliquer sur le bouton de synchronisation des pièces dans le sélecteur de pièces pour envoyer une synchronisation aux autres joueurs.
If disbaled, you need to click the part sync button in the part picker in order to send a sync out to other players
??? setting "Désactiver le passage aux véhicules des autres joueurs"
??? setting "Disable switching to other players vehicles"
Si cette option est activée, le passage d'un véhicule à l'autre saute les véhicules des autres joueurs.
If enabled, tabbing trough vehicles will skip other players vehicles
Si cette option est désactivée, la navigation dans les véhicules passe par tous les véhicules apparus.
If disabled, tabbing trough vehicles will cycle over every spawned vehicle
??? setting "Fondu enchaîné des véhicules à mesure qu'ils se rapprochent"
??? setting "Fade out vehicles as they get closer"
Si cette option est activée, les autres véhicules s'effacent au fur et à mesure qu'ils se rapprochent.
If enabled, other vehicles will fade out as they get closer
Si l'option est désactivée, les autres véhicules restent entièrement visibles quelle que soit la distance.
If disbaled, other vehicles will stay fully visible regardless of distance
!!! note ""
Cela n'affecte que le maillage 3D visible d'un véhicule, et non son maillage de faisceaux de nœuds physiques. Afin de désactiver également la physique, vous devez activer la « physique de collision simplifiée » dans les paramètres de jeu.
This only affects the visible 3d mesh of a vehicle, not its physics node-beam-mesh. In order to also disable physics, you need to enable `Simplified collision physics` in the Gameplay settings
??? setting "Afficher les identifiants des joueurs"
??? setting "Show the player ID`s"
Si cette option est activée, la liste des joueurs en jeu comportera une ligne supplémentaire indiquant l'identifiant de chaque joueur. Utile pour le développement ou la modération
If enabled, the ingame playerlist will have an additional row showing each players ID. Useful for development or moderation
Si l'option est désactivée, la liste des joueurs en jeu n'affichera que les lignes du nom de joueur et du ping.
If disabled, the ingame playerlist will only show the rows for playername and ping
??? setting "Autoriser le rafraîchissement de la liste des serveurs en cours de jeu"
??? setting "Allow the serverlist to refresh ingame"
Si cette option est activée, la liste des serveurs sera mise à jour à intervalles réguliers pendant le jeu. Cela peut provoquer des pics de lag
If enabled, the serverlist will update in regular intervalls while playing. This can cause lag spikes
Si cette option est désactivée, la liste des serveurs ne sera mise à jour qu'à l'ouverture du menu principal.
If disabled, the serverlist will only update once you open the main menu
## **2. File d'attente d'événements**
## **2. Event queue**
??? setting "Mettre en évidence les joueurs en file d'attente"
??? setting "Highlight queued players"
Si cette option est activée, les joueurs ayant un événement en attente seront mis en évidence dans la liste des joueurs en jeu.
If enabled, players with a queued event will be highlighted in the ingame playerlist
Si cette option est désactivée, les joueurs ne seront pas mis en évidence individuellement.
If disabled, players will not be individually highlighted
??? setting "Appliquer les changements de véhicule avec"
??? setting "Apply vehicle changes with"
S'il est réglé sur `Bouton gauche de la souris`, cliquer sur le nom d'un joueur dans la liste des joueurs en utilisant le bouton gauche de la souris chargera les événements en file d'attente. En cliquant avec le bouton droit de la souris, le joueur sera spectateur.
If set to `Left mouse button`, clicking on a players name in the playerlist using the left mouse button will load the queued events. Clicking with the right mouse button will spectate said player
Si le réglage est `Bouton droit de la souris`, cliquer sur le nom d'un joueur dans la liste des joueurs en utilisant le bouton droit de la souris chargera les événements en attente. En cliquant avec le bouton gauche de la souris, le joueur sera spectateur.
If set to `Right mouse button`, clicking on a players name in the playerlist using the right mouse button will load the queued events. Clicking with the left mouse button will spectate said player
??? setting "Appliquer automatiquement les changements de véhicules en attente"
??? setting "Automatically apply queued vehicle changes"
Si cette option est activée, les événements en file d'attente seront automatiquement chargés une fois que vous aurez passé sous le seuil de vitesse pendant le temps défini comme délai d'attente.
If enabled, the queued events will be automatically loaded once you've been going under the speed treshold for the amount of time set as the timeout
S'il est désactivé, les événements en file d'attente ne seront chargés que manuellement, en cliquant soit sur le bouton « Événements » en haut de l'écran à droite, soit sur le nom d'un joueur dans la liste des joueurs.
If disabled, the queued events will only load manually, by clicking on either the `Events` button at the top of the screen or on a players name in the playerlist
??? setting "Seuil de vitesse d'application de la file d'attente"
??? setting "Queue apply speed treshold"
Ce point de consigne définit le seuil de vitesse du chargement automatique de la file d'attente d'événements. Votre véhicule doit être plus lent que ce seuil pendant plus longtemps que le délai d'application de la file d'attente pour que les événements en file d'attente soient chargés.
This setpoint defines the speed treshold of the automatic event queue loading. Your vehicle has to be slower than this for longer than `Queue apply timeout` in order to load the queued events
??? setting "Délai d'application de la file d'attente"
??? setting "Queue apply timeout"
Ce point de consigne définit le délai de chargement automatique de la file d'attente des événements. Votre véhicule doit être plus lent que le « Seuil de vitesse d'application de la file d'attente » pendant ce temps afin de charger les événements en file d'attente.
This setpoint defines the time delay of the automatic event queue loading. Your vehicle has to be slower than `Queue apply speed treshold` for this time in order to load the queued events
??? setting "Sauter la file d'attente si l'on est spectateur"
??? setting "Skip queue if spectating others"
Si cette option est activée, un événement se chargera instantanément si vous êtes spectateur d'un autre joueur.
If enabled, an event will instantly load if you are spectating another player
S'il est désactivé, un événement sera mis en file d'attente comme il le serait si vous étiez concentré sur votre propre véhicule.
If disabled, an event will be queued just like it would when focused on your own vehicle
??? setting "Ne mets pas en file d'attente les Monocycles (Bonshommes de neige/Beamlings)"
??? setting "Don't queue Unicycles (Snowmen/Beamlings)"
Si l'option est activée, un événement concernant un bonhomme de neige ou un phare sera chargé instantanément.
If enabled, an event concerning a snowmen/beamling will be loaded instantly
Si cette option est désactivée, les bonshommes de neige et les phares seront mis en file d'attente comme les autres véhicules.
If disabled, snowmen/beamlings will be queued just like other vehicles
## **3. Définir Unicycle par défaut**
## **3. Set default Unicycle**
??? setting "Configuration par défaut de l'unicycle"
??? setting "Default Unicycle config"
Ce paramètre définit la variante de monocycle à charger par défaut. Vous pouvez choisir entre des configurations préétablies et les vôtres si vous avez enregistré des configurations d'unicycle personnalisées.
This setpoint defines the unicycle variant to be loaded by default. You can choose between premade configs and your own should you have saved custom unicycle configs
??? setting "Sauvegarde automatique de votre dernière utilisation d'unicycle"
??? setting "Automatically save your last used Unicycle"
Si cette option est activée, le dernier monocycle utilisé sera automatiquement sauvegardé et rechargé lorsque vous le ferez apparaître à nouveau.
If enabled, your last used unicycle will be automatically saved and reloaded once you spawn it again
Si désactivé, la configuration par défaut de l'unicycle sera utilisée à chaque fois.
If disabled, your default unicycle config will spawn every time
## **4. Boules**
## **4. Blobs**
??? setting "Activer les boules pour les véhicules non chargées"
??? setting "Enable blobs for unspawned vehicles"
Si cette option est activée, vous verrez un orbe ou une boule à la place d'un véhicule non apparu.
If enabled, you will see a placeholder orb, or blob, in place of an unspawned vehicle
Si cette option est désactivée, le véhicule non apparu sera invisible.
If disabled, an unspawned vehicle will be invisible
??? setting "Accorder les couleurs"
??? setting "Tune colors"
??? setting « Visible »
??? setting "Visible"
Si cette option est activée, une boule sera dessiné, en utilisant la couleur ci-dessous
If enabled, a blob will be drawn, using the color below
S'il est désactivé, aucune boule ne sera dessiné pour la fonction spécifiée.
If disabled, no blob will be drawn for the specified function
??? setting "Valeurs RGB HEX"
??? setting "RGB HEX values"
Véhicule en attente : La couleur qu'une boule utilisera si un véhicule est en file d'attente. Valeur standard #FF6400
Queued vehicle: The color a blob will use if a vehicle is queued for spawning. Standard value #FF6400
Véhicule illégal : La couleur qu'une boule utilisera si un véhicule est illégal, par exemple à cause d'un mod qui a été "interdit". Valeur standard #000000
Illegal vehicle: The color a blob will use if a vehicle is illegal, for example trough a mod that was sideloaded. Standard value #000000
Véhicule supprimé : La couleur qu'une boule utilisera si un véhicule a été supprimé par l'utilisateur. Valeur standard #333333
## **5. Étiquettes**
Deleted vehicle: The color a blob will use if a vehicle was deleted by the user. Standard value #333333
??? setting "Masquer les étiquettes des joueurs"
## **5. Nametags**
Si cette option est activée, les étiquettes des joueurs ne seront pas affiché.
??? setting "Hide player nametags"
Si cette option est désactivée, les étiquettes des joueurs seront affiché en fonction de la position relative de leur véhicule.
If enabled, player nametags will not be drawn
??? setting "Afficher la distance par rapport aux autres joueurs"
If disabled, player nametags will be drawn according to their vehicles relative position
Si cette option est activée, le nom du véhicule sera précédé de la distance qui le sépare du véhicule concerné.
??? setting "Show distance from other players"
Si cette option est désactivée, aucune distance supplémentaire n'est indiquée.
If enabled, the nametag will be prepended by the distance to the respective vehicle
??? setting "Les étiquettes s'estompent à l'intérieur et à l'extérieur."
If disabled, no additional distance will be shown in the nametag
Si cette option est activée, l'étiquette sera estompé en fonction de la « distance d'estompement » et de la « direction d'estompement de l'étiquette ».
??? setting "Fade nametags in/out"
S'il est désactivé, l'étiquette sera affiché avec une opacité standard, quelle que soit la distance par rapport au véhicule concerné.
If enabled, a nametag will be faded in/out according to `Fade distance` and `Invert nametag fade direction`
??? setting "Distance de fondu/direction de fondu de l'étiquette inversé"
If disabled, anametag will be drawn at standard opacity regardless of distance to the respective vehicle
!!! setting "Fondu enchaîné"
??? setting "Fade distance/Invert nametag fade direction"
Les étiquettes sont de moins en moins visibles au fur et à mesure que le joueur s'éloigne.
!!! setting "Fade out"
`Distance de fondu` définit la distance à laquelle l'étiquette sera dessiné avec une opacité minimale.
Nametags are getting less visible the further away a player is
!!! setting "Fondu enchaîné"
`Fade distance` defines the distance at which a nametag will be drawn at minimal opacity
Les étiquettes sont de plus en plus visibles au fur et à mesure que le joueur s'éloigne
!!! setting "Fade in"
`Distance de fondu` définit la distance à laquelle l'étiquette sera affiché avec une opacité maximale.
Nametags are getting more visible the further away a player is
??? setting "Ne pas cacher complètement les étiquettes"
`Fade distance` defines the distance at which a nametag will be drawn at maximal opacity
Si cette option est activée, l'étiquette ne peut pas devenir totalement invisible, il conservera une opacité minimale quelle que soit la distance.
??? setting "Don't fully hide nametags"
Si cette option est désactivée, les étiquettes peuvent devenir totalement invisibles.
If enabled, a nametag can not get fully invisible, it will retain a minimal opacity regardless of distance
??? setting "Raccourcir les étiquettes de noms et de rôles"
If disabled, nametags can get fully invisble
Si cette option est activée, `Limite de longueur du nom` tronquera les noms et les rôles jusqu'à la limite de caractères fixée.
??? setting "Shorten nametag and role tags"
Si elle est désactivée, les étiquettes de nom et de rôle seront affichées dans leur intégralité.
If enabled, `Nametag length limit` will truncate nametags and roles to the set limit of characters
??? setting "Faire affiché le nom des spectateurs sous le nom des véhicules."
If disabled, nametag and role tags will be shown at full length
Si cette option est activée, le nom d'un spectateur sera ajouté sous l'étiquette d'un joueur.
??? setting "Show spectators' nametag under vehicle nametags"
Si cette option est désactivée, aucun nom de spectateur ne sera ajouté à l'étiquette.
If enabled, a spectators name will be added underneath a players nametag
??? setting "Même couleur pour les étiquettes des spectateurs"
If disabled, no spectator names will be added to nametags
Si cette option est activée, le nom d'un spectateur sera toujours entouré d'un fond gris.
??? setting "Same color for spectator nametags"
S'il est désactivé, le nom d'un spectateur sera entouré d'un arrière-plan coloré, reflétant le rôle du spectateur.
If enabled, a spectators name will always be surrounded by a grey background
## **6. Autres**
If disabled, a spectators name will be surrounded by a colored background, reflecting the spectators role
??? setting "Afficher l'activité du réseau dans la console"
## **6. Others**
Si cette option est activée, l'activité du réseau beamMP sera affichée dans la console.
??? setting "Show network activity in the console"
Si elle est désactivée, aucune autre activité réseau ne sera affichée dans la console.
If enabled, the beamMP network activity will be shown in the console
If disabled, no further network activity will be shown in the console
!!! danger ""
Soyez prudent avec ce paramètre, car toutes les sorties de la console sont également écrites dans les fichiers journaux
Be careful with this setting, since all the console output gets also written into the log files
Ceux-ci peuvent croître de plusieurs centaines de Mo en quelques minutes lorsque ce paramètre est activé.
They can grow by hundreds of MB in minutes with this setting enabled
??? setting "Port du lanceur BeamMP"
??? setting "Launcher port"
Ce paramètre définit le port utilisé pour communiquer avec le lanceur
This setpoint defines the port used for communicating with the launcher
Ne doit être modifié que si le port standard 4444 ne peut pas être utilisé
Should only be changed if the standard port 4444 can not be used
N'oubliez pas de le changer également du côté du lanceur, en modifiant `launcher.cfg`.
Dont forget to also change it on the launcher side, by modifying `launcher.cfg`
!!! tip ""
Le port spécifié n'est que le premier de deux, le second port utilisé est directement suivant, set port + 1
The port specified is only the first of two, the second port being used is directly following, set port + 1
Le premier port transporte les paquets du réseau central, le second les paquets du réseau de jeu, tous deux via TCP.
The first port carries core network pakets, the second game network pakets, both over TCP

4
docs/en/index.md
View File

@@ -28,3 +28,7 @@ Thinking about creating your own BeamMP server? Our comprehensive guide [here](.
Discover the ins and outs of creating resources for the BeamMP Server in our [Resource Development Guide](../guides/mod-creation/server/getting-started.md).
Exciting updates are on the horizon, including a brand-new homepage designed to enhance your browsing experience. Stay tuned for more! :slight_smile:
## Community Rules
Read through the BeamMP [Community rules](https://docs.beammp.com/community/rules/) and how to appeal bans.

25
docs/fr/FAQ/Change-launcher-port.md Normal file
View File

@@ -0,0 +1,25 @@
# Problème
Le lanceur ne se connecte pas au jeu. Ce guide rapide explique comment modifier manuellement le port du lanceur.
# Changer le port manuellement
1. Démarrer BeamNG
2. Dans le menu principal, allez dans Options, puis Multijoueur
3. Dans les options multijoueurs, activez `Show advanced options`
4. Faites défiler jusqu'en bas
5. Dans `Launcher port` remplacez le numéro de port par un autre, par exemple 4567
6. Fermer BeamNG
7. Faites un clic droit sur le raccourci du lanceur BeamMP et sélectionnez `Open file location` dans le menu contextuel
8. Ouvrez le fichier `launcher.cfg` dans un éditeur de texte
9. Remplacez le numéro `"Port": 4444,` par celui que vous avez utilisé précédemment dans les options du jeu, dans cet exemple 4567
10. Enregistrez les modifications et fermez l'éditeur de texte
11. Démarrer le lanceur BeamMP
Si la connexion persiste, réessayez avec un autre port. Un numéro compris entre 2000 et 65535 est un numéro de port valide.
## Vous rencontrez toujours des problèmes ?
Créez un ticket d'assistance sur notre [serveur Discord](https://discord.gg/BeamMP) .
Tags: Launcher, Connection Failed, Port Number

45
docs/fr/FAQ/How-to-check-for-CGNAT.md Normal file
View File

@@ -0,0 +1,45 @@
Comment vérifier CGNAT ?
## Problème
Toutes les exclusions de pare-feu et les règles de redirection de port sont correctement configurées, mais personne ne peut rejoindre votre serveur hébergé à domicile ?
Si vous rencontrez des problèmes de connexion et que vous utilisez un hébergeur, contactez-le pour obtenir de l'aide. Si vous souhaitez utiliser un VPS ou ne pouvez pas héberger de serveur chez vous, consultez notre [liste de services d'hébergement partenaires](../../server/create-a-server/#partnered-hosting-services-paid) (documentation de configuration du serveur).
# Qu'est-ce que CGNAT ?
Pour une explication détaillée de ce qu'est CGNAT et pourquoi c'est un problème lorsque vous essayez d'héberger un serveur à la maison, jetez un œil à [cette page](https://en.wikipedia.org/wiki/Carrier-grade_NAT) .
# Comment vérifier CGNAT ?
## Méthode 1 :
Ouvrez une invite de commande et exécutez `tracert -4 beammp.com` . Cela affichera une série de sauts réseau. Attendez la fin de l'opération (jusqu'à 30 sauts peuvent être nécessaires). Vérifiez les premières adresses IP après celle de votre routeur/modem/passerelle. Si plusieurs adresses IP comprises entre `100.64.xx` et `100.127.xx` ou `10.xx.xx.xx` apparaissent après le premier saut, vous êtes probablement derrière un CGNAT.
!!! note
```
Le premier saut sera votre routeur/modem/passerelle et diffère selon les appareils.
Les plages officielles pour les réseaux locaux sont les suivantes : « 10.0.0.xxx » - « 192.168.xxx.xxx » - « 172.16.xxx.xxx »
```
## Méthode 2 :
Trouvez l'adresse IP WAN de votre routeur en la consultant sur son interface. Comparez-la à l'adresse IP publiée sur https://whatsmyip.org, par exemple. Si elles ne sont pas identiques, vous êtes derrière un CGNAT.
## Méthode 3/Solution :
Contactez votre fournisseur d'accès Internet pour obtenir de l'aide. Selon votre fournisseur d'accès, il se peut qu'il ne propose pas d'adresses IP *dynamiques* dédiées. N'oubliez pas qu'une adresse IP statique n'est pas nécessaire.
!!! warning
```
Les fournisseurs de services Internet ne peuvent proposer des adresses IP dédiées qu'en tant qu'**option payante**.
Veuillez vérifier les prix de nos services d'hébergement partenaires car ils pourraient être moins chers que ces frais !
```
Exemple de réseau non-CGNAT :
![image](https://github.com/user-attachments/assets/fee21a50-cbb0-4322-9c26-d9f04f88ae37)
Tags: Server, 10060 10061, CGNAT, Connection Failed, Port Forward, Firewall

42
docs/fr/FAQ/How-to-deactivate-mods.md Normal file
View File

@@ -0,0 +1,42 @@
## Pourquoi dois-je désactiver mes mods ?
Dans BeamMP, le serveur auquel vous vous connectez fournit les mods nécessaires. Ceux-ci sont téléchargés et activés automatiquement lors de la connexion. L'installation et l'activation de mods locaux peuvent souvent entraîner un dysfonctionnement de BeamMP, même avec un seul mod supplémentaire.
!!! warning
```
Supprimez tous les mods placés dans le dossier BeamNG.Drive\content\ ou ses sous-dossiers. Cet emplacement n'est PAS destiné à l'installation de mods et peut entraîner des problèmes, comme indiqué dans le fichier « DO_NOT_INSTALL_MODS_HERE.txt », situé dans le même répertoire.
!!! quote 'DO_NOT_INSTALL_MODS_HERE.txt"
NE copiez PAS les mods dans ce dossier : cela peut entraîner des mods cassés, une installation plus lente des mises à jour, un gestionnaire de mods cassé, un mode sans échec cassé et autres.
```
## Comment désactiver/supprimer mes mods ?
Il existe 3 options pour résoudre les problèmes possibles lors de l'utilisation de BeamMP.
### 1. Désactiver les mods
Avant de rejoindre un serveur, assurez-vous qu'aucun mod autre que « multiplayerbeammp » n'est activé. Si le jeu se bloque ou si vous rencontrez toujours des problèmes, reportez-vous à l'option suivante.
### 2. Création d'un nouveau dossier utilisateur
Ouvrez le dossier utilisateur BeamNG.Drive et renommez le dossier de la dernière version (par exemple 0.35) en 0.xx_OLD (0.35_OLD). Fermez BeamNG.drive avant de le renommer. ![image](../../assets/content/new-userfolder.png)
### 3. Suppression des mods des dossiers de contenu.
Pour accéder au dossier Beamng.drive\content\ et le vider de tout mod, ouvrez l'emplacement d'installation de BeamNG.drive. Faites un clic droit sur le dossier `content` et supprimez-le. Procédez à la vérification des fichiers du jeu via Steam ou Epic Games. Les fichiers seront alors à nouveau téléchargés.
Une fois terminé, lancez BeamNG.Drive via le lanceur BeamMP. Le seul mod activé dans le dépôt devrait être « multiplayerbeammp », ainsi que le bouton d'accès à BeamMP dans le menu principal. Si vous rencontrez toujours des difficultés pour rejoindre un serveur moddé, il est probable que des mods défectueux ou obsolètes soient disponibles.
### 4. Nettoyage du cache de BeamMP-Launcher
Pour nettoyer les mods en cache des répertoires BeamMP, accédez à l'emplacement d'installation de votre lanceur BeamMP. Par défaut, le chemin est « C:\Users\AppData\BeamMP-Launcher ». Vous y trouverez un dossier « Resources ». Supprimez ce dossier pour supprimer tous les mods en cache. Cela peut être utile si vous avez besoin de plus d'espace disque ou si vous souhaitez supprimer des mods BeamNG obsolètes.
!!! question "Mes paramètres et configurations ont disparu ! Comment puis-je les restaurer ?"
```
Si vous avez renommé le dossier utilisateur, vous avez forcé le jeu à créer un nouveau dossier utilisateur propre. Vous pouvez copier les dossiers « paramètres » et « véhicules » du dossier renommé (par exemple, 0.34_OLD) vers le nouveau dossier créé.
Assurez-vous que BeamNG.Drive est fermé et remplacez tous les éléments à l'emplacement où vous souhaitez copier les dossiers. Toutes les configurations et tous les paramètres devraient maintenant être identiques.
```

24
docs/fr/FAQ/player-faq.md
View File

@@ -1,22 +1,22 @@
# FAQ joueurs
## Comment avoir accès à l'accès anticipé (early access)?
## Comment lier mon compte Discord ?
L'accès anticipé (EA) (incluant le nom en jeu (nametag) mauve and d'autre bonus) peut être obtenus en nous supportant financièrement sur [Patreon](https://patreon.com/BeamMP) en achetant un niveau, faisant un don, ou en boostant notre serveur Discord.
Faire un don de **x** quantitée US$ = **x** clée(s) additionnelle(s) incluant les bonus de l'accès anticipé (EA).
Booster le serveur vous donne accès à 4 clées additionnelles en plus des bonus de l'accès anticipé (EA).
Lier vos comptes Discord et BeamMP est une nouvelle fonctionnalité de BeamMP. Pour cela, envoyez un message `!link` » au bot [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/) . Ce dernier vous enverra un lien pour vous connecter à votre compte BeamMP. Connectez-vous simplement à votre compte BeamMP ; vous recevrez alors un second message vous informant que vos comptes ont bien été liés. 🎉
## Je me suis abonné(es) au Patreon. Comment est-ce que je peux avoir accès à mes bonus?
## omment avoir accès à l'accès anticipé (early access)?
Assurerez-vous de faire les étapes suivantes pour recevoir vos bonus automatiquement:
L'accès anticipé (avec le badge violet et d'autres avantages) est disponible en nous soutenant financièrement sur [Patreon](https://patreon.com/BeamMP) : achat d'un niveau, don ou boost du serveur Discord. Un don de **x** $ US équivaut à **x** clés de serveur supplémentaires, avantages EA inclus. Le boost vous donne 4 clés de serveur supplémentaires en plus des avantages EA.
## Je me suis abonné sur Patreon. Comment bénéficier de mes avantages ?
Veuillez vous assurer de faire ce qui suit pour recevoir automatiquement vos avantages :
1. Liez votre compte Discord sur Patreon pour recevoir le rôle et l'accès dans le serveur Discord.
2. Assurez-vous que vous utilisez la même adresse courriel sur Patreon et pour votre compte BeamMP, vous pouvez voir l'adresse utilisée pour votre compte BeamMP sur le [Forum](https://forum.beammp.com/).
2. Veuillez vous assurer d'utiliser la même adresse e-mail sur Patreon que celle que vous utilisez pour votre compte BeamMP sur le [Forum](https://forum.beammp.com/) .
Soyez patient s'il vous plait, le système peut prendre quelques heures pour se synchroniser, parfois jusqu'à 12 heures. Si vous n'avez pas reçus vos bonus après 12 heures et vous avez suivi les étapes ci-dessus, contacter le support BeamMP s'il vous plait.
Veuillez patienter, la synchronisation du système peut prendre quelques heures, parfois jusqu'à 12 heures. Si vous n'avez pas reçu vos avantages après 12 heures et que vous avez suivi les étapes ci-dessus, veuillez contacter l'assistance BeamMP.
## J'ai d'autres questions!
## J'ai d'autres questions !
Si votre question ou problème est lié au jeu, référez-vous à la [FAQ du jeu](game-faq.md) s'il vous plait.
Si votre question ou problème est en lien avec le fait de faire fonctionner un serveur, référez-vous à la [FAQ de serveur](server-faq.md) s'il vous plait.
Sinon, vous pouvez regardez le [forums](https://forum.beammp.com/c/faq/35) où les membres de la communauté peuvent pauser des questions et répondres à celles des autres.
Si votre question ou votre problème concerne le jeu ou le fonctionnement, veuillez consulter la [FAQ du jeu](game-faq.md) . Si votre question ou votre problème concerne l'utilisation d'un serveur, veuillez consulter la [FAQ du serveur](server-faq.md) . Sinon, consultez les [forums](https://forum.beammp.com/c/faq/35) où la communauté peut poser des questions et obtenir des réponses.

25
docs/fr/FAQ/where-to-find-my-IP.md Normal file
View File

@@ -0,0 +1,25 @@
# Comment puis-je trouver l'IP de mon serveur ?
## Pour les serveurs hébergés VPS
Si vous hébergez un serveur auprès de l'un de nos hébergeurs partenaires, l'adresse IP sera affichée sur l'interface de gestion du serveur concernée. Vous pouvez également trouver l'adresse IP de votre/vos serveur(s) sur le site web [de Keymaster](https://keymaster.beammp.com/login) .
## Pour les serveurs hébergés à domicile
Pour les serveurs hébergés à domicile, ouvrez [whatsmyip.org](https://whatsmyip.org) dans un navigateur. Cela affichera l'adresse IPv4 publique avec laquelle vous êtes contacté depuis Internet.
Notez que 127.0.0.1 est l'adresse locale et ne peut être utilisée que par vous-même, si le serveur est hébergé sur le même ordinateur. Si vous rencontrez toujours des problèmes de connexion avec votre serveur hébergé, vérifiez les [redirections de port](https://docs.beammp.com/server/port-forwarding/) et 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>
## Comment vérifier CGNAT ?
Jetez un œil à [cette page](https://docs.beammp.com/FAQ/How-to-check-for-CGNAT/) pour déterminer si vous pouvez héberger un serveur à la maison ou non.
Mots-clés : IP, serveur, échec de connexion, 10060/10061

162
docs/fr/beamng/snippets.md Normal file
View File

@@ -0,0 +1,162 @@
!!! warning "Ce site est en construction !"
```
Ce site est en cours de développement actif.
Vous souhaitez nous aider ? Cliquez sur la page avec un crayon à droite !
Cela peut également être fait sur n'importe quelle page de notre documentation
```
# Extraits de BeamNG.drive
## Extraits de code Lua
### Drawing a marker &amp; Vehicle detection
Dessiner des marqueurs sur la carte peut être l’un des meilleurs moyens d’indiquer à l’utilisateur qu’il existe une forme d’interaction qu’il peut y effectuer.
Dessiner un marqueur est assez simple. Voici un exemple de tracé d'un marqueur de ligne de bus :
```Lua
local function createBusMarker(markerName)
local marker = createObject('TSStatic')
marker:setField('shapeName', 0, "art/shapes/interface/position_marker.dae")
marker:setPosition(vec3(0, 0, 0))
marker.scale = vec3(1, 1, 1)
marker:setField('rotation', 0, '1 0 0 0')
marker.useInstanceRenderData = true
marker:setField('instanceColor', 0, '1 1 1 0')
marker:setField('collisionType', 0, "Collision Mesh")
marker:setField('decalType', 0, "Collision Mesh")
marker:setField('playAmbient', 0, "1")
marker:setField('allowPlayerStep', 0, "1")
marker:setField('canSave', 0, "0")
marker:setField('canSaveDynamicFields', 0, "1")
marker:setField('renderNormals', 0, "0")
marker:setField('meshCulling', 0, "0")
marker:setField('originSort', 0, "0")
marker:setField('forceDetail', 0, "-1")
marker.canSave = false
marker:registerObject(markerName)
scenetree.MissionGroup:addObject(marker)
return marker
end
-- this can then be called in a loop to setup your markers.
-- NOTE: You should only do this once as part of your setup and not called on each frame.
if #markers == 0 then
for k,v in pairs(nameMarkers) do
local mk = scenetree.findObject(v)
if mk == nil then
log('I', logTag,'Creating marker '..tostring(v))
mk = createBusMarker(v)
ScenarioObjectsGroup:addObject(mk.obj)
end
table.insert(markers, mk)
end
end
```
Voici un exemple de marqueur personnalisé de [BeamNG-FuelStations](https://github.com/BeamMP/BeamNG-FuelStations/tree/master) :
```Lua
local stations = [
{ "location": [ -778.813, 485.973, 23.46 ], "type":"gas" },
{ "location": [ 617.164, -192.107, 53.2 ], "type":"ev" },
]
local function IsEntityInsideArea(pos1, pos2, radius)
return pos1:distance(pos2) < radius
end
local onUpdate = function (dt)
for k, spot in pairs(stations) do -- loop through all spots on the current map
local bottomPos = vec3(spot.location[1], spot.location[2], spot.location[3])
local topPos = bottomPos + vec3(0,0,2) -- offset vec to get top position (2m tall)
local spotInRange = false -- is this spot in range? used for color
local spotCompatible = false -- is this spot compatible?
if activeVeh then -- we have a car and its ours (if in mp)
local vehPos = activeVeh:getPosition()
spotInRange = IsEntityInsideArea(vec3(vehPos.x, vehPos.y,vehPos.z), bottomPos, 1.5)
spotCompatible = activeFuelType == "any" or spot.type == "any" or activeFuelType == spot.type
end
local spotColor = (spotInRange and spotCompatible) and activeColorMap[spot.type] or inactiveColorMap[spot.type] or ColorF(1,1,1,0.5)
debugDrawer:drawCylinder(bottomPos:toPoint3F(), topPos:toPoint3F(), 1, spotColor) --bottom, top, radius, color
end
end
```
### exemples de guihooks
#### Notifications, en haut à droite de l'écran
![image](https://github.com/StanleyDudek/Docs/assets/49531350/c8a87842-b95a-4eca-84dc-93072ecc9158)
```lua
--guihooks.trigger('toastrMsg', {type, title, msg, config = {timeOut}})
guihooks.trigger('toastrMsg', {type = "info", title = "Info Message:", msg = "Info Message Text Here", config = {timeOut = 5000}})
guihooks.trigger('toastrMsg', {type = "warning", title = "Warning Message:", msg = "Warning Message Text Here", config = {timeOut = 5000}})
guihooks.trigger('toastrMsg', {type = "error", title = "Error Message:", msg = "Error Message Text Here", config = {timeOut = 5000}})
```
#### Notifications de message, en haut à gauche de l'écran par défaut dans l'application Messages
![image](https://github.com/StanleyDudek/Docs/assets/49531350/6baef813-50cb-43c3-9c59-0de550b014b6)
```lua
--guihooks.trigger('Message', {msg, ttl, category, icon}) --requires Messages app
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "arrow_upward", icon = "arrow_upward"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "arrow_downward", icon = "arrow_downward"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "flag", icon = "flag"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "check", icon = "check"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "check_circle", icon = "check_circle"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "warning", icon = "warning"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "error", icon = "error"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "directions_car", icon = "directions_car"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "star", icon = "star"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "timeline", icon = "timeline"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "save", icon = "save"})
guihooks.trigger('Message', {msg = "Message Text Here", ttl = 5.0, category = "settings", icon = "settings"})
```
#### Flash central grand ou petit pour l'affichage
![image](https://github.com/StanleyDudek/Docs/assets/49531350/d0cf754f-83f8-4d15-9159-27350da127de) ![image](https://github.com/StanleyDudek/Docs/assets/49531350/1df6fc9b-756f-484e-b8d9-5df346dc4c26)
```lua
--guihooks.trigger('ScenarioFlashMessage', {{msg, ttl, sound, big}} ) -- requires RaceCountdown ui app
guihooks.trigger('ScenarioFlashMessage', {{"Message", 5.0, 0, true}} )
guihooks.trigger('ScenarioFlashMessage', {{"Message Text Here", 5.0, 0, false}} )
--countdown example, when all executed at once, the items are queued and will follow eachother after the previous ttl expires
guihooks.trigger('ScenarioFlashMessage', {{"3", 1.0, "Engine.Audio.playOnce('AudioGui', 'event:UI_Countdown1')", true}})
guihooks.trigger('ScenarioFlashMessage', {{"2", 1.0, "Engine.Audio.playOnce('AudioGui', 'event:UI_Countdown2')", true}})
guihooks.trigger('ScenarioFlashMessage', {{"1", 1.0, "Engine.Audio.playOnce('AudioGui', 'event:UI_Countdown3')", true}})
guihooks.trigger('ScenarioFlashMessage', {{"GO!", 3.0, "Engine.Audio.playOnce('AudioGui', 'event:UI_CountdownGo')", true}})
--another sound example
guihooks.trigger('ScenarioFlashMessage', {{"Teleported!", 3.0, "Engine.Audio.playOnce('AudioGui', 'event:UI_Checkpoint')", false}})
```
#### Écran persistant central de taille moyenne
![image](https://github.com/StanleyDudek/Docs/assets/49531350/6290e018-6b3d-4674-98f2-34282a723258)
```lua
--guihooks.trigger('ScenarioRealtimeDisplay', {msg = msg} ) -- requires Race Realtime Display ui app
guihooks.trigger('ScenarioRealtimeDisplay', {msg = "Message Text Here"} )
--these messages persist, clear with a blank string
--if you are running live data, this is a good one to update rapidly (think timers, distance calcs, et cetera)
guihooks.trigger('ScenarioRealtimeDisplay', {msg = ""} )
```
## Extraits de code IMGUI
## Extraits de code de l'interface utilisateur CEF

43
docs/fr/contributing.md Normal file
View File

@@ -0,0 +1,43 @@
# Contribuer à la documentation de BeamMP
BeamMP utilise [Material for MkDocs](https://squidfunk.github.io/mkdocs-material) pour son thème. C'est un thème pour [MkDocs](https://www.mkdocs.org). Les documentations peuvent être retrouvées sur leurs site web respectifs.
## Pour commencer
Vous pouvez utiliser une des deux méthodes ci-dessous pour contribuer à la documentation:
### 1. Modifiez directement les fichiers markdown
Modifier directement les fichiers markdown est la façon la plus rapide pour les petites modifications tel que les erreurs de frappes, erreurs de grammaires ou les petits ajouts de contenus. Cette approche nécessite une compréhension des fichiers markdown puisque vous devez comprendre les changement que vos modifications vont produire.
Si vous décider d'utiliser cette méthode, veuillez suivre ces étapes:
1. Cliquez sur edit sur la page que vous souhaitez modifier.
2. Faites une fork du projet et intégrez le à votre propre compte GitHub.
3. Faites les modifications que vous pensez nécessaires.
4. Vérifiez les modifications que votre fork apporte.
5. Faite une requête de pour intégrer vos changement à notre répertoire [ici](https://github.com/BeamMP/Docs).
Une fois que vous avez fait votre demande d'intégration, une personne de l'équipe de modération de BeamMP va réviser vos modifications et va, soit approuver les changements, soit demander de faire des modifications nécessaires. Si des modifications ont été demandées et que vous les avez effectuées nous allons réévaluer votre requête d'intégration. Les modifications que vous avez apporter seront ensuite appliquées automatiquement due à notre intégration continue.
### 2. Faire des modifications avec un aperçu en direct
Modifier notre documentation de cette façon ressemble à l'option 1, cependant, vous allez pouvoir apercevoir vos changements en direct.
1. Cliquez sur edit sur la page que vous souhaitez modifier.
2. Faites une fork du projet et intégrez le à votre propre compte GitHub.
3. Faite une copie local du projet.
4. Configurez: «Material for MkDocs» en suivant leur guide [ici](https://squidfunk.github.io/mkdocs-material/getting-started/)
5. Exécutez `mkdocs serve` pour démarrer le serveur de documentation de rechargement en direct à partir duquel vous avez cloné le fork.
6. Faites les modifications que vous pensez nécessaires.
7. Vérifiez les modifications que votre fork apporte.
8. Faite une requête de pour intégrer vos changement à notre répertoire [here](https://github.com/BeamMP/Docs).
## Présentation du projet
```
mkdocs.yml # The configuration file.
docs/
index.md # The documentation homepage.
... # Other markdown pages, images and other files.
```

2
docs/fr/game/getting-started.md
View File

@@ -5,7 +5,7 @@
BeamMP est entièrement compatible avec Windows et Linux, la compatibilité avec MacOS est en cours de développement.
Cependant, puisque Linux et MacOS sont des systèmes d'opération secondaire plusieurs problèmes (bug) sont à prévoir.
!!!Attention
!!!warning "Attention"
Aucune version piratée ou dépassée de BeamNG.drive ne sera compatible avec BeamMP.
L'équipe de support de BeamMP ne fournit aucun soutien pour les versions piratées ou défectueuses.

283
docs/fr/server/create-a-server.md Normal file
View 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=""> ![](../../assets/content/keymaster_homepage.png) </figure>
#### 2.2. Création d'une clé
Pour créer votre clé, cliquez sur le bouton vert "+" en haut à droite.
<figure markdown=""> ![](../../assets/content/keymaster_new_key.png) </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=""> ![](../../assets/content/keymaster_server_name.png) </figure>
Cela devrait, au final, ressembler à ceci :
<figure markdown=""> ![](../../assets/content/keymaster_key_done.png) </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=""> ![](../../assets/content/keymaster_copy_key.png) </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]** &gt; **Envoyer vers** &gt; **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=""> ![](../../assets/content/after-running-once.png) </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 &gt; Contrôles &gt; 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
View 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
View 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
View 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` .