Dépannage

Les problèmes les plus fréquents sur un serveur Grounded 2, et comment les résoudre. Dans tous les cas, la Console du panel est votre premier outil : lisez les dernières lignes affichées avant l'arrêt ou l'erreur.

Erreurs liées à Steam

Le serveur télécharge Grounded 2 pendant l'installation (ou une réinstallation), avec le compte Steam dédié renseigné dans l'onglet Startup. Si le téléchargement n'aboutit pas, l'installation se termine quand même, sans le jeu : le panel ne la signale pas comme « en échec », c'est la Console qui dit quoi faire.

• Où lire le message : dans l'onglet Console, à la fin de l'installation, un bloc encadré de lignes ===== commence par [YH] ACTION REQUISE :. Le même texte est enregistré dans le fichier YH-INSTALL-STEAM.txt, à la racine du serveur (onglet Files). Les messages sont en français, sans accents.
• Au démarrage : tant que le jeu n'est pas installé, la Console répète ce message avec le lien du guide, puis le serveur s'arrête (voir L'installation n'est pas terminée).
• Nombre de tentatives : pour une erreur de compte (identifiants, Steam Guard, jeu non possédé…), le serveur ne fait qu'une tentative de connexion, pour ne pas vous envoyer plusieurs codes ni déclencher le blocage temporaire de Steam. Pour une erreur réseau, il réessaie automatiquement jusqu'à 3 fois.
• Si une version du jeu était déjà installée, elle reste en place : la Console l'indique (Une version deja installee du jeu reste disponible).

Message dans la Console ([YH] ACTION REQUISE : …)	Cause	Solution
Compte Steam non renseigne	STEAM_USER ou STEAM_PASS vide : normal sur un serveur tout juste livré	Voir Renseigner les identifiants
Steam Guard : Steam vient d'envoyer un code par e-mail… (SteamCMD : Account Logon Denied)	Code Steam Guard pas encore fourni	Voir Code Steam Guard manquant ou expiré
Code Steam Guard invalide ou expire (Invalid Login Auth Code)	Code expiré, mal recopié ou déjà utilisé	Voir Code Steam Guard manquant ou expiré
Identifiant ou mot de passe Steam incorrect (Invalid Password)	Nom de compte ou mot de passe incorrect	Voir Identifiants invalides
Ce compte Steam ne possede pas Grounded 2 (No subscription)	Le compte dédié ne possède pas le jeu	Voir Le compte ne possède pas le jeu
Ce compte utilise l'authentificateur mobile Steam	Steam Guard par application mobile	Voir Code Steam Guard manquant ou expiré
Steam bloque temporairement les connexions de ce compte (Rate Limit Exceeded)	Trop de tentatives de connexion en peu de temps	Voir Trop de tentatives
Le telechargement de Grounded 2 via SteamCMD a echoue	Erreur réseau ou Steam indisponible, malgré 3 essais	Réinstallez le serveur ; si le problème persiste, contactez le support
Pas de message, mais le serveur se coupe quand vous lancez le jeu	Compte principal utilisé pour le serveur	Voir Le serveur se coupe quand je lance le jeu

Identifiants invalides

1. Dans l'onglet Startup, vérifiez STEAM_USER : c'est le nom de compte Steam (celui saisi pour se connecter), pas le pseudo du profil ni l'adresse e-mail
2. Vérifiez STEAM_PASS, en respectant les majuscules et minuscules
3. Supprimez tout espace avant ou après les valeurs
4. Testez ces identifiants en vous connectant au compte dédié sur store.steampowered.com dans une fenêtre de navigation privée
5. Relancez l'installation : onglet Paramètres → Réinstaller le serveur

Si vous avez récemment changé le mot de passe du compte dédié, mettez à jour STEAM_PASS : Steam peut ensuite redemander un code Steam Guard.

Code Steam Guard manquant ou expiré

Lors de la première installation, Steam refuse la connexion et envoie un code à l'adresse e-mail du compte dédié : c'est normal. La Console affiche Steam Guard : Steam vient d'envoyer un code par e-mail a l'adresse du compte dedie.

1. Récupérez le dernier e-mail de Steam reçu sur l'adresse du compte dédié (vérifiez les courriers indésirables)
2. Collez le code dans la variable STEAM_AUTH (onglet Startup), sans espace
3. Relancez immédiatement l'installation : Paramètres → Réinstaller le serveur

Un code expire vite et ne sert qu'une fois. Si la Console affiche Code Steam Guard invalide ou expire, Steam a pu envoyer un nouveau code : collez le dernier code reçu et relancez sans attendre.

Pas besoin de vider STEAM_AUTH après une installation réussie : la session Steam est mémorisée sur le serveur, et si un ancien code est refusé lors d'une réinstallation, le serveur réessaie automatiquement sans code.

Si la Console affiche Ce compte utilise l'authentificateur mobile Steam, le code s'affiche dans l'application Steam et non par e-mail. Nous recommandons de passer le compte dédié en Steam Guard par e-mail ; sinon, copiez le code affiché dans l'application dans STEAM_AUTH et réinstallez immédiatement. Toute la procédure : Steam Guard, pas à pas.

Le compte ne possède pas le jeu

Le compte renseigné dans STEAM_USER doit avoir Grounded 2 dans sa bibliothèque :

• Connectez-vous au compte dédié et vérifiez sa bibliothèque Steam
• Si vous avez offert le jeu, vérifiez que le cadeau a bien été accepté depuis le compte dédié
• Le partage familial ne suffit pas : le jeu doit appartenir au compte lui-même
• Vérifiez que STEAM_USER correspond bien au compte qui possède le jeu, et pas à un autre de vos comptes

Voir Acheter Grounded 2 sur le compte dédié.

Trop de tentatives (Rate Limit)

Si la Console affiche Steam bloque temporairement les connexions de ce compte (trop de tentatives), Steam a bloqué les connexions du compte dédié après trop d'essais rapprochés.

1. Patientez environ une heure sans relancer l'installation : une nouvelle tentative pendant le blocage peut le prolonger
2. Profitez-en pour vérifier STEAM_USER et STEAM_PASS
3. Réinstallez le serveur, puis suivez la Console. Si Steam envoie un code, collez-le dans STEAM_AUTH et réinstallez sans attendre

La durée exacte du blocage dépend de Steam : si le message revient, patientez à nouveau avant de réessayer.

Le serveur se coupe quand je lance le jeu

Si le serveur s'arrête ou se déconnecte de Steam au moment où vous (ou un ami) lancez Grounded 2, c'est presque toujours que le même compte Steam est utilisé à la fois par le serveur et pour jouer. Steam n'autorise qu'une session de jeu à la fois par compte : la seconde coupe la première.

1. Créez un compte Steam dédié au serveur et achetez-y Grounded 2 (ou offrez-le)
2. Remplacez STEAM_USER et STEAM_PASS par les identifiants de ce nouveau compte
3. Relancez l'installation et validez le code Steam Guard
4. Changez le mot de passe de votre compte principal s'il a été saisi dans le panel

Voir Compte Steam dédié et Steam Guard.

Le serveur ne démarre pas

L'installation n'est pas terminée

Si, au démarrage, la Console affiche [YH] Grounded 2 n'est pas installe : le telechargement Steam n'a pas abouti., suivi du message ACTION REQUISE et du lien vers le guide, puis que le serveur s'arrête, le jeu n'a pas encore été téléchargé avec le compte Steam dédié. Faites ce qu'indique le message (voir Erreurs liées à Steam), puis réinstallez le serveur : onglet Paramètres → Réinstaller le serveur. Redémarrer ne suffit pas : le jeu n'est téléchargé que pendant l'installation.

Le premier démarrage semble bloqué

Au premier lancement, le serveur prépare son environnement puis charge le monde : c'est plus long qu'un démarrage habituel. Tant que la console progresse, ne redémarrez pas.

Erreur dans appsettings.json

Si le serveur ne démarre plus après une modification de appsettings.json, le fichier est probablement invalide (virgule en trop, guillemet ou accolade manquante). Restaurez votre copie, ou vérifiez-le avec un validateur JSON. Voir Configurer le serveur.

Fichiers du serveur modifiés

Grounded 2 est un jeu Windows, que YorkHost fait tourner dans un environnement adapté (Wine) préparé et géré par nos soins. Ne remplacez pas les binaires du serveur (fichiers .exe, .dll, dossiers LanternServer et ue4ss) par des fichiers copiés depuis votre PC ou téléchargés ailleurs, et n'y installez pas d'outils Windows : cela peut empêcher le démarrage. Si des fichiers ont été modifiés ou supprimés par erreur, contactez le support avant toute réinstallation, après avoir sauvegardé votre monde.

Le serveur s'arrête faute de mémoire

Si le serveur s'arrête sans erreur claire, en particulier sur un monde très développé ou avec des mods, la RAM de votre offre est peut-être saturée. Voir Lag et mémoire.

Joueurs qui ne peuvent pas rejoindre

Symptôme	Cause probable	Solution
Le serveur n'apparaît pas dans la liste de parties du jeu	Normal avec Lantern	Connectez-vous avec le launcher Lantern et l'adresse IP:PORT
Connexion impossible juste après le démarrage	Le serveur n'a pas fini de charger	Attendez la fin du démarrage dans la Console
Échec de connexion / délai dépassé	Mauvaise IP ou mauvais port	Utilisez l'IP et le port affichés dans le panel
Le jeu lancé normalement ne trouve pas le serveur	Grounded 2 lancé sans Lantern	Lancez la connexion depuis le launcher Lantern
Un joueur sur Xbox, Game Pass ou PS5 ne peut pas rejoindre	Pas de crossplay	Seule la version Steam (PC) via Lantern sous Windows est compatible
Refus après une mise à jour du jeu	Version du client différente de celle du serveur	Voir Version différente
Serveur plein	4 joueurs déjà connectés	Limite fixée par le jeu
Le serveur se coupe quand un joueur lance le jeu	Compte du serveur utilisé pour jouer	Voir Le serveur se coupe quand je lance le jeu

Le détail de la connexion : Rejoindre le serveur.

Ports

L'ouverture des ports nécessaires est gérée par YorkHost. Ne modifiez pas les ports à la main. Voir Tous les ports sont-ils ouverts ? et Impossible de se connecter au serveur.

Version différente

Grounded 2 est en accès anticipé et Steam met votre jeu à jour automatiquement. Après une mise à jour, le serveur et Lantern doivent eux aussi être compatibles avec la nouvelle version.

1. Un délai peut être nécessaire : Lantern n'est pas une solution officielle et doit être adapté après certaines mises à jour du jeu. Nous suivons le projet de près et appliquons ses évolutions.
2. Gardez le launcher Lantern à jour sur le PC de chaque joueur
3. Avant toute mise à jour côté serveur, créez une sauvegarde depuis l'onglet Backups
4. Vérifiez que le compte Steam dédié est toujours valide : la mise à jour du jeu sur le serveur se fait avec lui
5. Si le serveur reste sur l'ancienne version ou que la connexion échoue toujours, contactez le support

N'utilisez pas de branche bêta de Grounded 2 sur Steam pour jouer sur le serveur.

Lag et mémoire

La consommation du serveur augmente avec la taille du monde, le nombre de constructions et les mods. Si le serveur rame ou s'arrête :

1. Surveillez la RAM dans le panel pendant que vous jouez : si elle est constamment au maximum de votre offre, une offre supérieure est justifiée.
2. Redémarrez régulièrement le serveur, par exemple chaque nuit à une heure creuse, avec un redémarrage automatique depuis l'onglet Schedules.
3. Avec des mods, l'offre Broodmother apporte des ressources supplémentaires.

Pour analyser l'utilisation des ressources, voir aussi Debug des performances.

Toujours bloqué ?

Contactez le support 7j/7 sur Discord ou via votre espace client, en indiquant :

• le nom de votre serveur
• ce que vous avez modifié juste avant le problème
• les dernières lignes de la console au moment de l'erreur

Ne partagez jamais vos mots de passe

N'envoyez jamais le mot de passe de votre compte Steam, ni de votre compte principal ni du compte dédié, dans un message ou une capture d'écran. Masquez-le si une capture affiche l'onglet Startup.