Comment mettre à jour son serveur BeamMP ?

Contexte

Vous gérez un serveur BeamMP chez Winheberg et vous voulez le mettre à jour vers une version plus récente ? Que ce soit pour profiter de nouvelles fonctionnalités ou pour corriger un bug, la procédure se fait en quelques minutes depuis votre panel gaming.

Ce guide vous explique pas à pas comment effectuer cette mise à jour proprement, sans perdre vos mods, vos maps ou votre configuration de serveur.

Comment savoir si votre serveur a besoin d'une mise à jour ?

BeamMP est sympa avec vous. Dès qu'une nouvelle version est disponible, le serveur affiche un message d'avertissement dans la console toutes les minutes. Si vous voyez ce type de log se répéter, il est temps de passer à l'action.

[23/05/26 23:05:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server! Download it here: https://beammp.com/! For a guide on how to update, visit: https://docs.beammp.com/server/server-maintenance/#updating-the-server
[23/05/26 23:06:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server!
[23/05/26 23:07:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server!

Le message vous indique directement le numéro de la nouvelle version disponible (ici v3.9.3). Tant que vous ne mettez pas à jour, ce log apparaîtra toutes les minutes dans votre console, ce qui peut vite devenir polluant pour le diagnostic d'autres problèmes.

Surveillez régulièrement la console de votre serveur. Si vous voyez ce warning, prenez quelques minutes pour suivre la procédure ci-dessous. Ça vous évitera de tourner sur une version dépassée susceptible de contenir des bugs corrigés depuis.

Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants.

Un serveur BeamMP actif sur votre panel gaming Winheberg
Une sauvegarde récente de votre serveur (recommandé en cas de problème post-mise à jour)
Quelques minutes devant vous, idéalement aux heures creuses pour ne pas déranger vos joueurs

La procédure nécessite de supprimer un fichier et de réinstaller le serveur. Vos mods, vos maps et vos configurations seront conservés, mais une sauvegarde reste toujours une bonne précaution avant ce type d'opération.

Bonne nouvelle, vos mods et maps sont conservés

Avant de commencer, rassurez-vous. La procédure de mise à jour ne supprime pas vos contenus personnalisés. Le Reinstall Server du panel Winheberg ne remplace que le fichier exécutable du serveur BeamMP, sans toucher à votre dossier Resources qui contient vos mods, ni à vos fichiers de configuration.

Vous récupérez donc votre serveur exactement comme avant, juste avec une version plus récente du moteur BeamMP.

1. Accéder à votre serveur BeamMP

Connectez-vous à votre panel gaming Winheberg
Sélectionnez votre serveur BeamMP
Arrêtez votre serveur s'il est en cours d'exécution (cliquez sur Stop)

Le serveur doit impérativement être arrêté pour pouvoir supprimer le fichier exécutable. Tenter de le supprimer pendant qu'il tourne ne fonctionnera pas, ou pourra corrompre votre serveur.

2. Supprimer le fichier BeamMP-Server

Une fois votre serveur arrêté, rendez-vous dans les fichiers de votre serveur.

Dans le menu latéral du panel, cliquez sur Files
À la racine de votre serveur, repérez le fichier nommé BeamMP-Server (sans extension, car nos serveurs BeamMP tournent sous Linux)
Faites un clic droit dessus et sélectionnez Delete (ou cochez la case puis cliquez sur Delete)
Confirmez la suppression

Ne supprimez que ce fichier. Ne touchez pas aux dossiers Resources, Server, ni aux fichiers ServerConfig.toml. Vous garderez ainsi toute votre configuration et vos mods intacts.

3. Réinstaller le serveur depuis Settings

Une fois le fichier supprimé, retournez à la racine de votre serveur dans le panel.

Dans le menu latéral, cliquez sur Settings
Descendez jusqu'à la section Reinstall Server (ou équivalent)
Cliquez sur le bouton Reinstall Server
Confirmez l'opération si une fenêtre vous le demande

Le panel va alors télécharger automatiquement la dernière version du fichier BeamMP-Server et l'installer à la place de l'ancien.

Cette manipulation ne fait que retélécharger le fichier exécutable depuis les serveurs officiels de BeamMP. Tous vos mods, maps et configurations restent strictement intacts dans leurs dossiers respectifs.

4. Démarrer votre serveur

Une fois l'installation terminée, vous pouvez relancer votre serveur.

Retournez sur la page principale de votre serveur dans le panel
Cliquez sur Start
Surveillez la console pour vous assurer que le serveur démarre correctement avec la nouvelle version

Vous devriez voir dans les logs un message indiquant la nouvelle version de BeamMP en cours d'exécution.

5. Vérifier que tout fonctionne

Pour confirmer que la mise à jour s'est bien passée.

Connectez-vous au serveur depuis votre client BeamMP in-game
Vérifiez que vos mods sont bien présents et fonctionnels
Vérifiez que votre map se charge correctement
Testez quelques fonctionnalités essentielles (chat, spawn de véhicule, etc.)

Si tout fonctionne, votre serveur BeamMP tourne maintenant sur la dernière version 🎉

En cas de problème

Voici les erreurs les plus fréquentes que vous pourriez rencontrer après une mise à jour.

❌ Le serveur ne démarre pas après la réinstallation

Consultez la console du panel, vous y verrez l'erreur exacte. Les causes les plus fréquentes sont les suivantes.

Un mod incompatible avec la nouvelle version de BeamMP, désactivez-le temporairement pour confirmer
Un fichier de configuration obsolète (ServerConfig.toml), comparez avec un exemple de la nouvelle version pour repérer les options qui auraient changé
Une dépendance manquante côté système, dans ce cas, contactez notre support

❌ Le bouton "Reinstall Server" ne fait rien

Si le bouton ne déclenche pas la réinstallation, vérifiez les points suivants.

Votre serveur est bien arrêté, l'opération ne fonctionne pas serveur en cours d'exécution
Vous avez bien supprimé le fichier BeamMP-Server au préalable
Rechargez la page du panel et réessayez

❌ Mes mods ne fonctionnent plus après la mise à jour

Certains mods peuvent ne plus être compatibles avec la nouvelle version de BeamMP. Vérifiez sur la page du mod (ou son forum de référence) s'il existe une version mise à jour compatible avec votre nouvelle version de serveur. Sinon, il faudra patienter qu'une mise à jour du mod sorte, ou revenir à une version antérieure de BeamMP.

❌ Mes joueurs ne peuvent plus se connecter

Une nouvelle version de BeamMP côté serveur peut nécessiter que vos joueurs aient également une version récente de leur client BeamMP. Demandez-leur de mettre à jour leur client via le launcher officiel et de relancer le jeu.

Bonnes pratiques

Quelques recommandations pour gérer vos mises à jour BeamMP sereinement.

Faites une sauvegarde de votre serveur (mods, configurations, dossier complet) avant chaque mise à jour majeure
Ne mettez pas à jour en pleine session de jeu si votre serveur est actif, prévenez vos joueurs et faites-le aux heures creuses
Suivez l'actualité de BeamMP (beammp.com) pour anticiper les changements importants
Vérifiez la compatibilité de vos mods avant la mise à jour si possible, surtout les mods majeurs comme les frameworks de gameplay ou les maps lourdes
Testez votre serveur après la mise à jour avec quelques joueurs de confiance avant d'annoncer la reprise officielle

Besoin d'aide ?

Si vous rencontrez un problème lors de la mise à jour de votre serveur BeamMP, ou si votre serveur refuse de démarrer après l'opération, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client, renseignez le champ Produit lié avec le serveur concerné, et joignez les logs de démarrage de la console.

Votre serveur BeamMP est maintenant à jour, profitez des nouveautés et bon jeu 🚗