Dépannage Valheim

Ce guide couvre les problèmes courants que vous pouvez rencontrer lors de l'exploitation d'un serveur dédié Valheim, notamment les problèmes de connexion, les échecs de chargement de monde et les erreurs liées aux mods. Pour la configuration initiale du serveur, consultez le Guide de configuration d'un serveur dédié Valheim. Pour les étapes d'installation de mods, consultez le Guide d'installation de mods Valheim.

Le serveur n'apparaît pas dans le navigateur de serveurs

Cause : Le navigateur de serveurs Steam découvre les serveurs via le port de requête, et non le port de jeu. Si le port de requête est bloqué ou mal configuré, le serveur n'apparaîtra dans aucune liste de serveurs même si les joueurs peuvent se connecter directement.

Solution : Ouvrez GPanel et accédez à l'onglet Réseau. Confirmez que votre port de jeu et votre port de requête sont listés et correctement assignés. Si vous n'êtes pas sûr de vos ports, consultez Comment trouver l'IP et le port de votre serveur. Utilisez la méthode des favoris Steam (décrite dans le guide de configuration) pour vous connecter directement pendant le dépannage de la visibilité dans la liste des serveurs.

Le serveur refuse de démarrer en raison d'une erreur de mot de passe

Cause : Le mot de passe contient moins de 5 caractères, est vide, ou contient le nom du serveur comme partie de la chaîne du mot de passe.

Solution : Accédez à l'onglet Démarrage dans GPanel et mettez à jour la variable Password. Assurez-vous qu'elle respecte toutes les exigences suivantes :

Au moins 5 caractères
Ne contient pas le ServerName comme sous-chaîne
N'est pas laissé vide

Redémarrez le serveur après avoir enregistré.

Le monde ne se charge pas / Un nouveau monde est généré à la place

Cause : La variable de démarrage WorldName ne correspond pas au nom de fichier des fichiers du monde, ou seul l'un des deux fichiers de monde requis (.fwl ou .db) est présent.

Solution :

Connectez-vous via SFTP et naviguez vers :

/.config/unity3d/IronGate/Valheim/worlds_local/

Confirmez que les fichiers <WorldName>.fwl et <WorldName>.db sont tous les deux présents.
Vérifiez que la variable de démarrage WorldName dans GPanel correspond exactement au nom de fichier (sensible à la casse, sans extension).
Si un nouveau monde a été généré, arrêtez le serveur, supprimez ou renommez les fichiers du monde nouvellement créés, restaurez vos fichiers de sauvegarde et redémarrez.

Les joueurs ne peuvent pas se connecter

Cause : Il existe plusieurs raisons possibles pour lesquelles les joueurs ne peuvent pas se connecter à un serveur Valheim.

Solution : Parcourez les vérifications suivantes :

Le serveur est encore en cours de démarrage : Valheim peut prendre plusieurs minutes pour démarrer complètement, surtout avec des mods. Attendez que la console indique que le serveur est prêt avant de vous connecter.
Mauvais port : Les joueurs se connectant via le navigateur en jeu doivent utiliser le port de jeu. Les joueurs ajoutant le serveur via les favoris Steam doivent utiliser le port de requête. Vérifiez l'onglet Réseau dans GPanel pour vos ports assignés.
Mot de passe incorrect : Assurez-vous que les joueurs entrent le bon mot de passe du serveur. Les mots de passe sont sensibles à la casse.
Version de mod incompatible : Si Valheim Plus ou d'autres mods obligatoires sont installés, tous les joueurs doivent avoir exactement la même version. Consultez le Guide d'installation de mods pour plus de détails.

Les mods BepInEx ne se chargent pas

Cause : Les fichiers BepInEx ont été placés dans le mauvais répertoire, ou la bibliothèque doorstop est absente de la racine du serveur.

Solution :

Vérifiez via SFTP que le dossier BepInEx/ se trouve dans le répertoire racine du serveur aux côtés de valheim_server.x86_64.
Vérifiez que le dossier doorstop_libs/ existe également à la racine du serveur et contient libdoorstop_x64.so. Sur les panneaux basés sur Pterodactyl, le doorstop est chargé via des variables d'environnement — un script run_bepinex.sh n'est pas utilisé et n'a pas besoin d'être présent.
Vérifiez que vos fichiers .dll de mods sont dans BepInEx/plugins/, et non à la racine ou dans un autre sous-répertoire.
Redémarrez le serveur et vérifiez le journal de la console du serveur pour les messages d'initialisation de BepInEx ou les sorties d'erreur.

La structure de répertoires attendue est :

/ (server root)
  valheim_server.x86_64
  BepInEx/
    plugins/        ← mod .dll files go here
    config/
    patchers/
  doorstop_libs/
    libdoorstop_x64.so

Le serveur plante ou est instable après l'ajout de mods

Cause : Un mod est incompatible avec la version actuelle de Valheim, entre en conflit avec un autre mod, ou est mal configuré.

Solution :

Vérifiez la sortie de la console du serveur dans GPanel pour les messages d'erreur qui font référence à un mod ou un nom de plugin spécifique.
Supprimez tous les mods de BepInEx/plugins/ et redémarrez le serveur pour confirmer qu'il fonctionne correctement sans mods.
Réajoutez les mods un par un, en redémarrant entre chaque, pour identifier quel mod cause le plantage.
Consultez la page Thunderstore ou Nexus du mod pour les notes de compatibilité et les dépendances requises.

Après une mise à jour du jeu Valheim : Les mods peuvent cesser de fonctionner jusqu'à ce que leurs auteurs publient des versions mises à jour. Si votre serveur était stable avant une mise à jour et plante après, supprimez temporairement les mods jusqu'à ce que des versions mises à jour soient disponibles.

Le crossplay ne fonctionne pas

Cause : La variable de démarrage crossplay n'est pas activée, ou des mods interfèrent avec la fonctionnalité crossplay.

Solution :

Accédez à l'onglet Démarrage dans GPanel et définissez ENABLE_CROSSPLAY sur 1.
Redémarrez le serveur.
Notez que la plupart des mods BepInEx ne sont pas compatibles avec le crossplay. Si vous avez des mods installés et que les joueurs crossplay ne peuvent pas se connecter, vous devrez peut-être choisir entre les mods et le support du crossplay.

Articles connexes

Guide de configuration d'un serveur dédié Valheim — Configuration de démarrage, connexion et sauvegardes de monde
Guide d'installation de mods Valheim — BepInEx, Thunderstore et Valheim Plus
Comment trouver l'IP et le port de votre serveur
Comment transférer des fichiers via SFTP

Si vous continuez à rencontrer des problèmes après avoir suivi ce guide, notre équipe de support est disponible pour vous aider. Ouvrez un ticket de support en incluant les détails GPanel de votre serveur, une description du problème et tout message d'erreur de la console du serveur.

Dépannage Valheim - Base de connaissances

Support

Catégories

Dépannage Valheim