Files
Docs/docs/fr/server/server-maintenance.md
2026-05-02 14:26:04 +00:00

12 KiB
Raw Permalink Blame History

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 .

Le fichier ServerConfig

La configuration du serveur, qui est un fichier appelé ServerConfig.toml , utilise le format TOML .

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
Port 1024-65535 Le port réseau sur lequel le serveur sera accessible. (Il doit être unique et ne pas être utilisé par un autre service sur le même hôte).
AuthKey Format AuthKey xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx où tous les x sont des caractères alphanumériques (chiffres et lettres) Permet d'identifier un serveur de set public avec le backend.
AllowGuests true/false Détermine si les invités sont autorisés à se connecter au serveur ou non.
LogChat true /false Lorsque cette option est activée (true), les messages de chat sont enregistrés dans le fichier server.log.
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.
IP Adresse de classe locale d'une des cartes réseau connectées à l'hôte. (Par défaut : « 0.0.0.0 » ou « :: ») Le serveur tentera de se connecter à l'adresse IP fournie. Veuillez ne pas modifier ce champ sauf si vous savez ce que vous faites. Il n'est pas nécessaire de modifier cette valeur pour que le serveur fonctionne.
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.
InformationPacket true/false Lorsque cette option est activée (true), le serveur autorisera les clients non authentifiés à obtenir les mêmes informations que celles figurant sur la liste des serveurs, mais directement via le serveur.
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.
Tags Voir la liste des tags autorisés ci-dessous. Mots clés pour la recherche, par exemple : Police, Racing, etc.
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.
MaxPlayers Tout nombre ≥ 1 Le nombre maximal de joueurs par serveur. Cela n'a aucune incidence sur le nombre de véhicules.
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.
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.
ResourceFolder Un chemin d'accès valide vers un dossier, tel que « D:\Server\BeamMP\Resources » Utile pour stocker séparément le serveur et le dossier de ressources.
ImScaredOfUpdates true/false Cette option permet de définir si le serveur doit se mettre à jour automatiquement ou non lorsqu'une nouvelle version est disponible.
UpdateReminderTime Tout nombre suivi de s, min, h, d. (30s) Définit l'intervalle du message de rappel de mise à jour affiché dans le terminal.

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

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 .

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 davoir installé les fichiers redistribuables de Visual C++ afin dexécuter le serveur.
  2. Accédez à 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 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 .