Bedrock et Geyser : comprendre et résoudre les messages du journal du serveur

Tu trouveras ici les messages qui apparaissent dans le journal du serveur autour des joueurs Bedrock. Ils viennent de deux directions : sur un serveur Java, le plugin Geyser traduit la connexion des joueurs Bedrock, et Floodgate leur permet de rejoindre le serveur sans compte Java. Sur un serveur Bedrock natif (Bedrock Dedicated Server), les messages proviennent en revanche le plus souvent des add-ons, c'est-à-dire des packs de comportement et de ressources.

Chaque section traite exactement un message. Tu trouves le texte complet dans la Console, et pour les serveurs Java en plus sous Fichiers dans logs/latest.log. Lis aussi les lignes situées juste en dessous, car elles indiquent souvent le pack concerné ou la véritable cause.

Avant de modifier des fichiers de configuration, des add-ons ou des fichiers de monde, crée une sauvegarde sous Sauvegardes. Ainsi, tu peux revenir à l'ancien état à tout moment.

Geyser ne parvient pas à charger ses fichiers de langue

Voici à quoi ressemble le message :

java.lang.AssertionError: Unable to load Geyser locale map for <Langue>
    at Geyser-Spigot.jar//org.geysermc.geyser.text.GeyserLocale.loadGeyserLocale(GeyserLocale.java:141)

Ce qui se passe : pour chaque joueur Bedrock, Geyser a besoin du fichier de langue Minecraft correspondant à ses paramètres de langue, par exemple pour l'allemand ou l'anglais britannique. Geyser télécharge ces fichiers au démarrage et les place dans un dossier dédié. Si le téléchargement a échoué au démarrage ou si le dossier est endommagé, Geyser ne trouve pas le fichier. La connexion du joueur Bedrock échoue alors, les joueurs Java ne sont pas concernés.

Comment résoudre le problème :

1. Redémarre le serveur via la Console. Geyser recharge alors les fichiers de langue.
2. Suis le démarrage dans la console. Si tu y vois « Unable to download and extract … locale », c'est déjà le téléchargement qui a échoué. Une section dédiée à ce cas se trouve plus bas.
3. Si le message persiste, arrête le serveur et supprime dans Fichiers le dossier plugins/Geyser-Spigot/locales ou le dossier .cache de Geyser.
4. Redémarre le serveur et demande à un joueur Bedrock de se connecter.

Bon à savoir : ces dossiers ne contiennent que des données que Geyser télécharge de nouveau lui-même. Tes paramètres dans config.yml sont conservés.

Geyser signale une erreur dans la session d'un joueur Bedrock

Voici à quoi ressemble le message :

[Geyser-Spigot] Exception caught in session of unknown (pre-login)
[Geyser-Spigot] Error thrown in <Joueur>'s event loop!
[Geyser-Spigot] An exception occurred:

Ce qui se passe : pour chaque joueur Bedrock, Geyser gère une session propre et y traduit tout ce qui circule entre le client Bedrock et le serveur Java. Si quelque chose s'est mal passé lors de cette traduction, seul ce joueur est généralement déconnecté. Le serveur et tous les autres joueurs continuent de fonctionner. « pre-login » signifie que la connexion a été interrompue avant l'authentification. Une ReadTimeoutException en dessous indique une connexion coupée.

Comment résoudre le problème :

1. Note l'heure, le joueur concerné et ce qu'il était en train de faire, par exemple ouvrir un menu ou changer de monde.
2. Mets à jour Geyser et Floodgate dans Plugins vers la dernière version. Si tu les as téléversés toi-même, remplace les anciens fichiers JAR dans plugins/ au lieu d'en ajouter de nouveaux à côté.
3. Redémarre le serveur et demande au joueur de refaire l'action.
4. Si l'erreur revient sans cesse avec le même joueur ou la même action, signale-la avec la ligne d'erreur et les lignes qui suivent sur le Discord du projet Geyser.

Bon à savoir : les clients Bedrock reçoivent fréquemment des mises à jour, et une version obsolète de Geyser ne s'entend souvent pas avec les nouveaux clients. Tu peux ignorer un message isolé avec « pre-login » pour lequel aucun joueur ne signale de problème.

Un add-on signale une erreur de script

Voici à quoi ressemble le message :

[Scripting] [<Add-on>] LocationInUnloadedChunkError: Trying to access location (<x>, <y>, <z>) which is not in a chunk currently loaded and ticking.
[Scripting] [<Add-on>] InvalidEntityError: Failed to get property 'dimension' due to Entity being invalid (has the Entity been removed?).

Ce qui se passe : de nombreux add-ons Bedrock embarquent leurs propres scripts dans le pack de comportement. Ces lignes sont signalées par le script de l'add-on lui-même : l'erreur vient donc de l'add-on et non du serveur. Les cas typiques sont l'accès à une entité qui n'existe plus ou à une zone qui n'est pas chargée à ce moment-là. Le serveur continue de fonctionner, généralement seule une fonction de l'add-on est brièvement indisponible. Avec de très nombreux messages, l'add-on peut dégrader les performances.

Comment résoudre le problème :

1. Relève le nom de l'add-on. Il figure dans le deuxième crochet.
2. Compare la version Bedrock de ton serveur sous Version avec les versions indiquées par le créateur de l'add-on.
3. S'il existe une version plus récente de l'add-on, crée une sauvegarde et installe-la en suivant ses instructions.
4. Si l'add-on perturbe le jeu, désactive-le pour tester. Pour cela, supprime son entrée dans Fichiers du fichier worlds/<Monde>/world_behavior_packs.json et redémarre.

Bon à savoir : les contenus apportés uniquement par l'add-on peuvent disparaître du monde lorsque tu le désactives. Seul son créateur peut corriger l'erreur dans le script, les lignes avec « at » l'aident dans cette tâche.

Les packs d'add-on ne se chargent pas correctement

Voici à quoi ressemble le message :

The following issues were found when loading packs:
    behavior_packs/<Pack>
        The property '/header/min_engine_version' has a version of '<Version>' which is too high. The highest value we accept is '<Version>'.

Ce qui se passe : chaque pack d'add-on possède un fichier de description manifest.json. On y trouve notamment le nom, l'identifiant, la version et la version Bedrock minimale dont le pack a besoin. Si le serveur y trouve des erreurs au démarrage, il les liste en retrait sous cette ligne : d'abord le pack, puis la raison. Selon l'erreur, il ne charge pas du tout le pack ou le charge autrement que prévu, par exemple comme pack de ressources au lieu d'un pack de comportement (« Defaulting to resource pack »).

Comment résoudre le problème :

1. Lis les lignes en retrait sous le message. Elles indiquent le pack et la raison.
2. Si tu y vois « too high », l'add-on nécessite une version Bedrock plus récente que celle de ton serveur. Utilise une version plus ancienne de l'add-on ou attends que la version adaptée soit disponible sous Version ou Mises à jour.
3. Pour les autres raisons, la version actuelle de l'add-on proposée par son créateur aide généralement.
4. Si tu as modifié manifest.json toi-même, vérifie-le dans Fichiers. Il doit s'agir d'un JSON valide (accolades, virgules, guillemets) et contenir tous les champs obligatoires, par exemple format_version, header avec name, uuid et version, ainsi que modules.
5. Redémarre et vérifie si la liste a disparu.

La configuration de Geyser ne peut pas être lue

Voici à quoi ressemble le message :

[Geyser-Spigot] Failed to read/create config.yml! Make sure it's up to date and/or readable+writable!
org.geysermc.geyser.platform.spigot.shaded.org.spongepowered.configurate.loader.ParsingException: …

Ce qui se passe : Geyser lit ses paramètres dans plugins/Geyser-Spigot/config.yml. Le fichier est écrit en YAML, un format texte dans lequel l'indentation avec des espaces et les deux-points définissent la structure. Une ParsingException en dessous signifie que le fichier est endommagé à un endroit, souvent après une modification manuelle. Plus rarement, il est obsolète ou n'est pas lisible ou modifiable. Sans configuration valide, Geyser ne démarre en général pas, et les joueurs Bedrock ne peuvent pas rejoindre le serveur. Les joueurs Java ne s'en aperçoivent pas.

Comment résoudre le problème :

1. Arrête le serveur et ouvre le fichier plugins/Geyser-Spigot/config.yml dans Fichiers.
2. Vérifie les lignes citées par le message d'erreur : tabulations au lieu d'espaces, indentation décalée, deux-points manquant ou guillemet non fermé.
3. Si tu ne trouves pas l'erreur, renomme le fichier, par exemple en config.yml.alt. Geyser crée un nouveau fichier par défaut au prochain démarrage.
4. Reporte ensuite uniquement les valeurs nécessaires de l'ancien fichier. Le port Bedrock doit correspondre au port UDP que le panel attribue à ton serveur.
5. Démarre le serveur et vérifie dans la Console que Geyser démarre sans erreur.

Bon à savoir : si un fichier fraîchement généré signale aussi l'erreur, c'est plutôt un problème de permissions de fichiers. Si tu ne t'en sors pas, ouvre un ticket et indique l'heure du message.

Floodgate est chargé en double

Voici à quoi ressemble le message :

java.lang.IllegalArgumentException: Duplicate handler name: floodgate-init

Ce qui se passe : au démarrage, Floodgate s'insère dans la connexion réseau du serveur pour pouvoir reconnaître les joueurs Bedrock. Cette intervention ne doit exister qu'une seule fois. Le message indique que Floodgate a été chargé une seconde fois. Le plus souvent, deux fichiers Floodgate se trouvent dans le dossier plugins/, par exemple une ancienne et une nouvelle version. Parfois, un autre plugin embarque lui-même Floodgate. Les joueurs Bedrock peuvent alors échouer à se connecter.

Comment résoudre le problème :

1. Ouvre le dossier plugins/ dans Fichiers et cherche tous les fichiers dont le nom contient « floodgate » et qui se terminent par .jar.
2. Ne garde qu'un seul de ces fichiers, de préférence le plus récent, et supprime les autres.
3. Pour les plugins installés récemment, vérifie si leur description indique qu'ils contiennent Floodgate. Dans ce cas, une seule des deux sources suffit.
4. Redémarre le serveur et demande à un joueur Bedrock de se connecter.

Bon à savoir : le dossier plugins/floodgate n'est pas un second plugin. Il contient les paramètres et la clé de Floodgate et reste en place.

Un add-on contient des entrées que le serveur ne comprend pas

Voici à quoi ressemble le message :

[FeatureRegistry] Feature rule <add-on>:<name> can't place internal feature type.
[Animation] Error: can't find animation <name>

Ce qui se cache derrière : Les add-ons décrivent les créatures, les objets, les blocs, les animations et des éléments de la génération du monde dans leurs propres fichiers. Si le serveur Bedrock ne comprend pas l'une de ces entrées dans sa version, il écrit une ligne de ce type dans le log. « Feature rule » concerne par exemple les règles qui répartissent des plantes ou des structures dans le monde. Cette partie de l'add-on ne fonctionne alors pas ou seulement en partie, le reste et le serveur continuent de tourner. Le plus souvent, l'add-on a été conçu pour une autre version de Bedrock.

Voici comment le résoudre :

1. Trouve le paquet concerné. La partie avant les deux-points est généralement l'abréviation de l'add-on, d'autres lignes indiquent le chemin behavior_packs/….
2. Consulte Version pour savoir quelle version de Bedrock ton serveur utilise.
3. Crée une sauvegarde, télécharge chez le créateur la édition de l'add-on qui correspond à cette version, puis remplace l'ancien paquet.
4. Redémarre et vérifie si les lignes disparaissent.

Bon à savoir : Après une mise à jour du serveur Bedrock, ces lignes apparaissent souvent en nombre, jusqu'à ce que les créateurs aient adapté leurs add-ons.

Geyser attend Floodgate, mais Floodgate est absent

Voici à quoi ressemble le message :

Auth-type set to Floodgate but Floodgate is not installed

Ce qui se cache derrière : Dans la configuration de Geyser, le type d'authentification est réglé sur floodgate. Cela permet aux joueurs Bedrock de rejoindre le serveur sans compte Java supplémentaire. Pour cela, le plugin Floodgate doit toutefois être installé et actif. S'il manque, Geyser s'arrête et les joueurs Bedrock ne peuvent pas accéder au serveur. Les joueurs Java ne sont pas concernés.

Voici comment le résoudre :

1. Vérifie sous Plugins ou dans le dossier plugins/ si Floodgate est présent et s'il signale sa propre erreur au démarrage.
2. S'il manque, installe Floodgate depuis la même source que Geyser et adapté à ton logiciel de serveur, dans le dossier plugins/.
3. Si tu ne veux pas utiliser Floodgate, règle plutôt la valeur auth-type sur online dans plugins/Geyser-Spigot/config.yml. Les joueurs Bedrock auront alors besoin en plus d'un compte Java.
4. Redémarre le serveur et teste la connexion avec Bedrock.

Pour en savoir plus : Configurer le crossplay Bedrock avec Geyser et Floodgate

Geyser ne peut pas télécharger les fichiers de langue

Voici à quoi ressemble le message :

[Geyser-Spigot] Unable to download and extract <Langue> locale!

Ce qui se cache derrière : Au démarrage, Geyser télécharge les fichiers de langue de Minecraft depuis Mojang. Ici, cette connexion a été interrompue, et en dessous on lit généralement « Connection reset ». Jusqu'au prochain démarrage réussi, les joueurs Bedrock voient des textes non traduits ou ne peuvent pas du tout se connecter. Le serveur lui-même et les joueurs Java ne sont pas concernés.

Voici comment le résoudre :

1. Redémarre le serveur. Souvent, le téléchargement fonctionne à la tentative suivante.
2. Au démarrage, surveille dans la Console si le message réapparaît.
3. S'il persiste, arrête le serveur et supprime sous Fichiers le dossier plugins/Geyser-Spigot/locales ou le dossier .cache de Geyser.
4. Redémarre et teste la connexion avec Bedrock.

Bon à savoir : Si le message « Unable to load Geyser locale map » suit lors de la connexion, c'est généralement la conséquence de ce téléchargement échoué. S'il échoue sur plusieurs démarrages, ouvre un ticket et indique l'heure du message.

Geyser n'atteint pas un service réseau nécessaire

Voici à quoi ressemble le message :

[Geyser-Spigot] Got an error
java.net.ConnectException: Connection refused

Ce qui se cache derrière : Pour fonctionner, Geyser établit des connexions vers d'autres destinations, par exemple vers un point distant renseigné ou vers des services externes. Ici, l'une de ces connexions n'a pas abouti. La ligne juste en dessous en indique la raison : ConnectException signifie que la destination a refusé, souvent parce que rien n'y tourne. NoRouteToHostException signifie que l'adresse est tout simplement inaccessible. Ce qui ne fonctionne plus dépend de la destination.

Voici comment le résoudre :

1. Lis en entier les lignes sous « Got an error ». L'adresse que Geyser voulait atteindre y figure souvent.
2. Si tu as modifié une adresse cible ou un port dans plugins/Geyser-Spigot/config.yml, compare-les avec les informations du panel et corrige-les.
3. Si la cible se trouve sur un autre serveur, vérifie qu'il fonctionne et qu'il est joignable.
4. Mets à jour Geyser sous Plugins et redémarre le serveur.

Bon à savoir : Si le message n'apparaît qu'une seule fois et que les joueurs Bedrock peuvent toujours rejoindre le serveur, tu peux d'abord l'observer plutôt que d'intervenir immédiatement.

Geyser ne peut pas ouvrir son port Bedrock

Voici à quoi ressemble le message :

[Geyser-Spigot] Failed to start Geyser on <IP>:<Port>

Ce qui se cache derrière : Geyser accepte les connexions Bedrock via son propre port UDP. L'UDP est le protocole réseau que Bedrock utilise pour la connexion. Geyser n'a pas pu ouvrir ce port : soit un autre service l'occupe déjà, soit il n'est pas attribué à ton serveur et ne peut donc pas être utilisé. Les connexions Bedrock ne fonctionnent alors pas, les joueurs Java peuvent toujours rejoindre le serveur.

Voici comment le résoudre :

1. Relève dans le panel quel port Bedrock (UDP) est attribué à ton serveur.
2. Sous Fichiers, ouvre le fichier plugins/Geyser-Spigot/config.yml et compare la valeur port dans la section bedrock. Elle doit correspondre exactement au port attribué.
3. Vérifie si un autre service UDP utilise le même port, par exemple la Query (query.port dans server.properties) ou un plugin de chat vocal. Chacun de ces services a besoin de son propre port.
4. Enregistre, redémarre le serveur et teste la connexion avec Bedrock.

Pour en savoir plus : Crossplay Bedrock : Geyser, Floodgate et port UDP

Le script d'un add-on s'est bloqué et a été interrompu

Voici à quoi ressemble le message :

[Watchdog] Unhandled critical exception of type '<Type>' in behavior pack '<Add-on>'

Ce qui se cache derrière : Le serveur Bedrock surveille les scripts des add-ons avec un gardien, le Watchdog. Si un script prend trop de temps, le serveur l'interrompt afin que le monde entier ne se fige pas. Le nom de l'add-on apparaît dans le message après « behavior pack ». À ce moment, le serveur peut brièvement saccader et des fonctions de l'add-on cessent de fonctionner. Le serveur lui-même continue de tourner.

Voici comment le résoudre :

1. Relève le nom de l'add-on dans le message.
2. Vérifie auprès du créateur s'il existe une édition plus récente pour la version de Bedrock de ton serveur (voir Version), et installe-la après avoir fait une sauvegarde.
3. Observe si le message apparaît lors d'une action précise, par exemple en entrant dans une zone ou quand de nombreuses créatures se trouvent au même endroit.
4. S'il apparaît souvent, désactive l'add-on pour tester et observe si les saccades disparaissent.

Bon à savoir : Un message isolé n'est pas un motif d'inquiétude. Ce qui compte, c'est de savoir s'il se répète.

Une entrée de permissions sans XUID ou sans niveau

Voici à quoi ressemble le message :

xuid or permission missing from permissions file

Ce qui se cache derrière : Sur un serveur Bedrock, le fichier permissions.json définit qui possède quel niveau de permission, par exemple opérateur. Chaque entrée nécessite deux informations : la XUID, c'est-à-dire l'identifiant fixe du compte Xbox ou Microsoft, et le niveau. Si l'une des deux manque, le serveur ne peut associer l'entrée à aucun joueur et ne l'applique pas. Le serveur fonctionne normalement, seule cette permission n'est pas prise en compte.

Voici comment corriger le problème :

1. Ouvre la configuration de ton serveur et, dedans, la section « Permissions (Ops) ».
2. Supprime la ligne sans XUID ou ajoute la XUID du joueur.
3. Redémarre ensuite le serveur.
4. C'est plus simple avec la commande op <Joueur> dans la Console, pendant que le joueur est en ligne. Le serveur enregistre alors lui-même la XUID.

Bon à savoir : Sur Bedrock, c'est la XUID qui compte, pas le pseudo du joueur. Une entrée sans XUID reste donc sans effet, même si le pseudo est correct.

Ton message n'est pas listé ?

Lis le message en entier dans la Console ou dans logs/latest.log, y compris les lignes juste avant. Si une stacktrace suit, c'est-à-dire une liste de lignes commençant par « at », elle montre où l'erreur est survenue. Des noms comme Geyser-Spigot.jar ou floodgate y révèlent le plugin concerné. Sur les serveurs Bedrock, des crochets ou des chemins sous behavior_packs/ indiquent l'add-on. Crée une sauvegarde avant de modifier quoi que ce soit. Si tu n'avances pas, ouvre un ticket et indique l'heure du message.