Les datapacks (packs de données) ajoutent à Minecraft des fonctions, des recettes, des progrès ou une nouvelle génération de monde, tandis que les resourcepacks fournissent des textures et des sons. Les deux reposent sur un format de données qui change avec presque chaque version de Minecraft. Si un pack ne correspond pas à la version de ton serveur ou si un fichier qu'il contient est endommagé, le serveur écrit un message dans le log. Le plus souvent, il ignore simplement l'entrée concernée ; dans un cas, il interrompt le démarrage.

Chaque section ci-dessous traite l'un de ces messages. Tu trouveras le message complet, avec les lignes qui suivent, dans la Console ou sous Fichiers dans logs/latest.log. La partie avant les deux-points dans des noms comme <pack>:<entrée> s'appelle l'espace de noms et indique presque toujours de quel pack ou mod provient l'erreur. Avant toute intervention dans le dossier du monde ou dans les fichiers d'un pack, crée une sauvegarde sous Sauvegardes.

« Failed to load datapacks » : Minecraft interrompt le démarrage du serveur

Voici à quoi ressemble le message :

Failed to load datapacks, can't proceed with server load. You can either fix your datapacks or reset to vanilla with --safeMode
java.util.concurrent.ExecutionException: java.lang.IllegalStateException: Overworld settings missing

Ce qui se passe : Minecraft interrompt le démarrage, car les datapacks ou les données de génération du monde nécessaires n'ont pas pu être chargés. Le serveur reste éteint. Le plus souvent, un datapack ne correspond pas à la version de Minecraft ou contient un fichier corrompu. Overworld settings missing signifie que les paramètres du monde principal sont manquants ou n'ont pas pu être lus.

Voici comment le corriger :

  1. Crée une sauvegarde dans Sauvegardes.
  2. Dans la Console, lis les erreurs qui précèdent ce message et celles qui le suivent. Vérifie les datapacks et les mods ajoutés, mis à jour ou supprimés en dernier.
  3. Dans Fichiers, ouvre le dossier datapacks de ton monde. Télécharge une copie du dernier pack ajouté, puis supprime-le pour tester.
  4. Redémarre. Si le serveur fonctionne de nouveau, utilise une version du pack compatible avec la version de Minecraft.
  5. Si le monde a besoin du pack pour les biomes ou les dimensions, restaure une version compatible ou l'état antérieur complet à partir d'une sauvegarde.

Bon à savoir : Après un changement de logiciel, les fichiers du monde peuvent être organisés différemment. Consulte le guide de migration du logiciel concerné ; Changer de version Minecraft et de modloader en toute sécurité peut t'aider.

« Failed to load function » : impossible de charger la fonction du datapack

Voici à quoi ressemble le message :

Failed to load function <Pack>:<Chemin>
java.lang.IllegalArgumentException: Whilst parsing command on line <Ligne>: Incorrect argument for command at position <Position>: …
java.lang.IllegalArgumentException: Whilst parsing command on line <Ligne>: Can't find element '<Pack>:<Entrée>' in registry 'minecraft:item_modifier' …

Ce qui se cache derrière : les datapacks pilotent des déroulements via des fonctions : des fichiers texte avec l'extension .mcfunction, qui contiennent des commandes. Une commande est inconnue, attend d'autres arguments ou renvoie à une entrée de données manquante, par exemple un modificateur d'objet (item_modifier). Le plus souvent, le pack ne correspond pas à la version de Minecraft. La fonction échoue ; le serveur continue de tourner, mais les fonctions du pack qui en dépendent ne fonctionnent pas.

Voici comment le corriger :

  1. Sous « Failed to load function », lis la ligne d'erreur : line indique la ligne, position l'endroit dans celle-ci. « Can't find element » indique l'entrée manquante.
  2. Remplace le pack dans le dossier datapacks de ton monde par la version adaptée à ta version de Minecraft. En cas d'entrées manquantes, vérifie aussi les packs complémentaires dont le pack a besoin.
  3. Pour tes propres packs, corrige la ligne indiquée dans data/<Pack>/function/<Chemin>.mcfunction ; dans les anciens packs, le dossier s'appelle functions.
  4. Redémarre ou saisis reload dans la Console. Sur Paper et Spigot, utilise minecraft:reload, afin que seuls les datapacks soient rechargés.

Bon à savoir : les fonctions de mod optionnelles nécessitent le mod correspondant. Ignore de telles erreurs uniquement si l'auteur du pack décrit expressément ces fonctions supplémentaires comme optionnelles.

« Couldn't load … pack metadata » : les métadonnées du pack ne correspondent pas à la version de Minecraft

Voici à quoi ressemble le message :

Couldn't load file/<Pack>.zip pack metadata: Pack declares support for version newer than <Nombre>, but is missing mandatory fields min_format and max_format
Couldn't load file/<Pack>.zip pack metadata: Multi-version packs cannot support minimum version of less than <Nombre>, since this will leave versions in range unable to load pack.

Ce qui se cache derrière : le fichier pack.mcmeta décrit le format et la plage de versions prise en charge d'un datapack ou d'un resourcepack. Si des champs obligatoires manquent ou si la plage indiquée est invalide, le serveur ne charge pas le pack. Le serveur continue de tourner sans ce pack. Une plage de versions remontant trop loin dans le passé peut aussi déclencher le message.

Voici comment le corriger :

  1. Le nom de fichier après file/ indique le pack. Vérifie ta version de Minecraft sous Version.
  2. Télécharge la version adaptée du pack et remplace le fichier concerné sous Fichiers. Les datapacks se trouvent dans le dossier datapacks de ton monde ; remplace les resourcepacks à leur emplacement actuel. Redémarre ensuite.
  3. Pour tes propres packs, aligne les métadonnées sur les exigences de ta version cible : les anciens formats utilisent pack_format, les plus récents min_format et max_format. Pour les packs multi-versions, les anciens champs peuvent aussi être nécessaires.
  4. Vérifie si la plage de versions indiquée est valide et si le message disparaît après le redémarrage.

Bon à savoir : modifier les indications de format n'adapte pas automatiquement les commandes ni les autres contenus du pack.

« Couldn't load tag » : le datapack renvoie à des entrées manquantes

Voici à quoi ressemble le message :

Couldn't load tag minecraft:load as it is missing following references: <Pack>:<Fonction> (from file/<Pack>.zip)
Couldn't load tag <Espace de noms>:<Tag> as it is missing following references: <Mod>:<Entrée> (from <Mod>.jar)
Couldn't load tag <Espace de noms>:<Tag> as it is missing following references: #<Mod>:<Tag> (from mod/<Mod>)

Ce qui se cache derrière : un tag est une liste nommée. minecraft:load et minecraft:tick listent des fonctions ; d'autres tags regroupent par exemple des blocs ou des objets. Une entrée nécessaire n'a pas pu être chargée, parce qu'une fonction est défectueuse ou qu'un pack ou un mod est absent. Un autre tag peut aussi manquer : tu le reconnais au #. Le tag concerné n'est alors pas disponible ; pour les tags de fonctions, les déroulements associés échouent.

Voici comment le corriger :

  1. Corrige d'abord les messages « Failed to load function » du même pack.
  2. Vérifie l'origine indiquée entre parenthèses. Si l'entrée manquante appartient à un autre pack ou mod, installe sa version adaptée.
  3. Si des entrées précédées de minecraft: manquent, vérifie également que le pack correspond à ta version de Minecraft.
  4. Après des modifications de mods, redémarre. Tu peux recharger les datapacks dans la Console avec reload ; sur Paper et Spigot, utilise minecraft:reload.

Bon à savoir : .jar ou mod/ comme origine indique un mod : Erreurs de mod sur les serveurs Forge, NeoForge et Fabric.

« Couldn’t parse data file … » : le fichier du datapack a un format inadapté

Voici à quoi ressemble le message :

Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Unknown registry key …']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['List is too short: 0, expected range [1-9]']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Not a string: {"item":"minecraft:tnt"}; List must have contents']

Ce qui se cache derrière : les datapacks décrivent entre autres les recettes et les progrès en JSON, un format texte pour des données structurées. Les mods fournissent eux aussi de tels fichiers. Le fichier est du JSON valide, mais il contient des champs inadaptés, des listes vides ou des références à des entrées inconnues, par exemple un sérialiseur de recettes qui traite le format de recette. Minecraft ignore l'entrée concernée ; la recette manque, le serveur continue de tourner.

Voici comment corriger le problème :

  1. Lis après from quel fichier est concerné ; DataResult.Error[…] indique l'erreur.
  2. S'il provient d'un datapack, remplace-le dans Fichiers, dans le dossier datapacks de ton monde, par la version correspondant à ta version de Minecraft.
  3. S'il provient d'un mod, vérifie sa version et les dépendances requises ; pour un Modpack, mets à jour le pack entier.
  4. Pour tes propres packs, adapte le fichier au format de ta version de Minecraft. Le wiki Minecraft décrit les formats de fichiers.
  5. Redémarre et vérifie le message.

Bon à savoir : Not a string signifie ici : à cet endroit, un texte est attendu à la place d'un objet.

« Couldn't parse data file » : les données du pack ou du mod sont illisibles

Voici à quoi ressemble le message :

Couldn't read tag list <Espace de noms>:<Tag> from <Fichier> in data pack mod/<Mod>
Couldn't parse data file '<Espace de noms>:<Entrée>' from '<Fichier>.json': … Failed to parse either …
java.lang.IllegalStateException: Failed to parse <Espace de noms>:<Entrée> from pack file/<Pack>.zip

Ce qui se cache derrière : Minecraft ne peut pas lire une entrée de données. « Failed to parse either » signifie que son contenu ne correspond à aucune des écritures attendues ; First et Second indiquent les erreurs respectives. Le plus souvent, un mod ou un datapack ne correspond pas à la version de Minecraft, ou le pack est endommagé. Les recettes, les tables de butin et les progrès peuvent aussi être concernés. L'entrée échoue ; pour les listes de tags, tout un groupe peut rester vide. Cela peut perturber les recettes ou la génération du monde.

Voici comment le corriger :

  1. Cherche la source dans l'erreur complète : mod/<Mod> ou un .jar indique un mod, file/<Pack>.zip un datapack. L'espace de noms est un autre indice.
  2. Vérifie sous Mods ou dans le dossier datapacks de ton monde que les versions correspondent à ta version de Minecraft. Unknown registry key indique une entrée de données manquante ; vérifie les packs complémentaires nécessaires.
  3. Sauvegarde l'état actuel, arrête le serveur et mets à jour le dernier mod ou pack ajouté.
  4. Si l'erreur est apparue après un nouveau datapack, retire-le pour tester et redémarre.

Bon à savoir : pour les erreurs de mod, consulte Erreurs de mod sur les serveurs Forge, NeoForge et Fabric.

« Couldn’t load advancements » : des progrès manquent ou sont invalides

Voici à quoi ressemble le message :

Couldn't load advancements: [<pack>:<progress>, <pack>:<progress>]

Ce qui se cache derrière : les advancements sont les progrès que les joueurs débloquent en jeu. Minecraft n'a pas pu résoudre les entrées indiquées lors du chargement des datapacks, par exemple parce qu'elles font référence à quelque chose qui n'existe pas dans cette version. De nombreux datapacks et mods utilisent aussi les progrès de façon invisible comme déclencheurs, par exemple pour détecter qu'un joueur a trouvé une structure. Ces fonctions ne marchent alors plus, tandis que le serveur continue de tourner.

Voici comment corriger le problème :

  1. L'espace de noms avant les deux-points aide à trouver le datapack ou le mod concerné. Pour cela, vérifie les contenus installés et les lignes précédant le message.
  2. Mets à jour ce pack ou ce mod avec la version correspondant à ta version de Minecraft. Si tu n'en as pas besoin, supprime-le après avoir fait une sauvegarde dans Sauvegardes.
  3. Après des modifications de mods, redémarre le serveur. Pour de simples modifications de datapacks, reload dans la Console fonctionne aussi, et minecraft:reload sur Paper et Spigot.
  4. Si le message est toujours là ensuite, lis les lignes qui le précèdent dans logs/latest.log. Le serveur y indique souvent quelle partie d'une entrée ne convient pas.

Bon à savoir : même si l'espace de noms est minecraft, l'origine peut être un datapack. Les packs peuvent créer leurs propres entrées sous ce nom.

Le prédicat du datapack a un format incorrect

Voici à quoi ressemble le message :

Couldn't parse element predicates:<pack>:<name> - Not a json array: {"condition":"minecraft:any_of","terms":[…]}

Ce qui se cache derrière : un prédicat est une condition enregistrée qu'un datapack vérifie, par exemple si un joueur a un certain score. Les commandes et les tables de butin y font appel. Ta version de Minecraft attend ici une liste entre crochets [ … ], mais le pack fournit un objet unique entre accolades { … }. Minecraft ne charge donc pas le prédicat. Tout ce qui dépend de lui dans le pack se comporte mal ou pas du tout. Le serveur lui-même continue de tourner.

Voici comment le corriger :

  1. Le nom après predicates: indique le pack et le prédicat.
  2. Télécharge la version du datapack correspondant à ta version de Minecraft et remplace l'ancienne dans le dossier datapacks de ton monde.
  3. Pour tes propres packs, ouvre data/<pack>/predicate/<name>.json (dans les anciens packs, le dossier s'appelle predicates) et mets le fichier au format actuel, comme le décrit le wiki Minecraft.
  4. Redémarre ou recharge les datapacks.

Le texte d'invite du pack de ressources du serveur est mal formaté

Voici à quoi ressemble le message :

Failed to parse resource pack prompt '<Hint>'
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setStrictness(Strictness.LENIENT) to accept malformed JSON at line 1 column 1 path $

Ce qui se cache derrière : avec resource-pack-prompt dans server.properties, tu définis le texte que voient les joueurs lorsque le serveur leur propose un pack de ressources. Minecraft attend ici un composant de texte au format JSON, pas une simple phrase. Si le serveur ne peut pas lire la valeur, il omet l'invite. Le serveur continue de tourner normalement, seul ton texte d'invite personnalisé n'apparaît pas.

Voici comment le corriger :

  1. Dans Fichiers, ouvre le fichier server.properties dans le dossier principal du serveur.
  2. Écris la valeur sous forme de texte JSON, par exemple resource-pack-prompt={"text":"<Hint>"}.
  3. Si tu n'as pas besoin d'invite personnalisée, laisse la valeur vide après le signe égal.
  4. Enregistre le fichier et redémarre le serveur.

Bon à savoir : les autres valeurs du fichier sont expliquées dans Configurer le fichier server.properties de Minecraft.

Le fichier pack.mcmeta d'un pack est défectueux

Voici à quoi ressemble le message :

Couldn't load file/<Pack>.zip pack metadata: com.google.gson.stream.MalformedJsonException: <Details>

Ce qui se cache derrière : pack.mcmeta est la fiche d'identité de chaque pack et se trouve dans son dossier racine. Ici, ce n'est pas du JSON valide : il manque par exemple une virgule, un guillemet ou une accolade. Minecraft ne peut donc pas identifier le pack et ne le charge pas. Le serveur continue de tourner sans le pack.

Voici comment le corriger :

  1. Le plus simple est de retélécharger le pack depuis sa page officielle et de remplacer le fichier dans le dossier datapacks de ton monde.
  2. Pour tes propres packs, ouvre pack.mcmeta. Si le pack est une archive ZIP, télécharge-la, corrige le fichier sur ton ordinateur et renvoie l'archive.
  3. Vérifie le contenu avec un validateur JSON, c'est-à-dire un site web ou un éditeur qui signale les erreurs de syntaxe, et corrige l'endroit signalé. Le message indique souvent la ligne et la colonne.
  4. Redémarre le serveur.

Bon à savoir : les erreurs typiques sont une virgule après la dernière entrée, des guillemets typographiques au lieu de guillemets droits et une accolade fermante manquante.

Une recette mentionne un objet qui n'existe pas

Voici à quoi ressemble le message :

Expected item to be an item, was unknown string '<mod>:<item>'

Ce qui se cache derrière : une recette mentionne un objet qui n'existe pas sur le serveur. Presque toujours, il manque le mod qui apporte cet objet, ou il est présent dans une version où l'objet porte un autre nom. Seule la recette concernée est ignorée. Le serveur démarre normalement, mais cette recette précise ne peut pas être fabriquée en jeu.

Voici comment le corriger :

  1. Lis le nom entre guillemets. Avant les deux-points se trouve le mod concerné : pour horsepower:flour, il s'agit du mod « horsepower ».
  2. Vérifie dans Mods si ce mod est installé.
  3. S'il est installé, compare sa version avec celle prévue par ton modpack et aligne-la.
  4. Redémarre le serveur et vérifie si le message disparaît.

Bon à savoir : si le mod manque volontairement, par exemple parce que tu l'as retiré du modpack, tu peux ignorer le message. Seule cette recette sera alors absente. Pour savoir comment les mods et le modpack s'accordent, consulte Configurer correctement les mods et modpacks Minecraft.

Une recette utilise un type de traitement inconnu

Voici à quoi ressemble le message :

com.google.gson.JsonSyntaxException: Unknown recipe '<mod>:<recipe-type>'

Ce qui se cache derrière : de nombreux mods apportent leurs propres types de recettes, par exemple pour un moulin ou une presse. Ici, une recette utilise un type de traitement que le serveur ne connaît pas. Le mod qui le définit est absent ou trop ancien. La recette est ignorée, le serveur continue de tourner.

Voici comment le corriger :

  1. Le nom avant les deux-points indique le mod concerné.
  2. Installe-le dans Mods ou mets-le à jour vers une version compatible avec ton modpack.
  3. Si la recette provient d'un datapack que tu as ajouté toi-même, supprime la recette dans ce pack ou retire tout le pack du dossier datapacks de ton monde.
  4. Redémarre le serveur.

Bon à savoir : si un mod manque complètement, le message apparaît souvent de nombreuses fois d'affilée avec le même nom avant les deux-points. Il suffit alors d'installer ce seul mod. S'il manque volontairement, seules les recettes qui utilisent son type de traitement sont absentes.

Fichier JSON vide dans les données d'un mod ou d'un datapack

Voici à quoi ressemble le message :

com.google.gson.JsonParseException: java.io.EOFException: End of input at line 1 column 1 path $

Ce qui se cache derrière : Lors du chargement des données du jeu, c'est-à-dire les recettes, les tables de butin, les tags et autres, Minecraft a trouvé un fichier JSON vide. « End of input at line 1 column 1 » signifie que le fichier se termine avant le premier caractère. Il provient souvent d'un mod, d'un datapack ou d'un envoi incomplet ou corrompu. L'entrée concernée est ignorée, le serveur continue de tourner.

Voici comment le corriger :

  1. Dans la Console ou dans logs/latest.log, lis les lignes juste avant et juste après. Elles indiquent généralement quel fichier ou quel mod est concerné.
  2. Si le fichier se trouve dans un datapack que tu as créé toi-même, remplace-le par une version complète ou supprime-le.
  3. S'il appartient à un mod ou à un datapack téléchargé, télécharge-le à nouveau et renvoie-le sur le serveur. Veille à ce que l'envoi se termine complètement.
  4. Redémarre le serveur.

Bon à savoir : Pour de nombreux fichiers ou des fichiers volumineux, un programme SFTP est souvent plus pratique que l'envoi via le navigateur : Modifier les fichiers du serveur dans le panel et se connecter via SFTP.

L'archive du pack de ressources a une structure invalide

Voici à quoi ressemble le message :

<Pack> does not contain a valid pack_manifest.json or manifest.json
The resource pack <Pack> is invalid and failed to load

Ce qui se cache derrière : Le pack de ressources n'a pas pu être chargé. Cela concerne surtout les packs Bedrock : ils nécessitent un fichier manifest.json ou pack_manifest.json qui décrit le pack. La cause la plus fréquente est un niveau de dossier supplémentaire : dans l'archive, un dossier se trouve d'abord à la racine et le fichier n'est qu'à l'intérieur. Une archive corrompue ou un format de pack inadapté provoquent aussi ce message. Le pack est alors absent, le serveur continue de tourner.

Voici comment le corriger :

  1. Lis le message détaillé dans les lignes autour de ce message ; il indique la raison exacte.
  2. Ouvre l'archive sur ton ordinateur. manifest.json ou pack_manifest.json doit se trouver directement au niveau le plus haut, pas dans un sous-dossier.
  3. Si le fichier se trouve dans un sous-dossier, recompresse le contenu de ce dossier en archive ZIP et renvoie-la sur le serveur.
  4. Si l'archive est corrompue, télécharge à nouveau le pack. Un pack de ressources Java avec pack.mcmeta au lieu d'un manifeste ne convient pas ici ; il doit être recréé au format Bedrock.
  5. Redémarre le serveur.

Bon à savoir : D'autres messages Bedrock sont expliqués dans Serveur Bedrock et Geyser : messages dans le log.

Un bloc Jigsaw indique un bloc de remplacement inconnu

Voici à quoi ressemble le message :

Failed to parse jigsaw replacement state '<Block>' at BlockPos{x=<x>, y=<y>, z=<z>}

Ce qui se cache derrière : Les blocs Jigsaw sont des blocs techniques qui permettent d'assembler des structures à partir de plusieurs éléments. Chaque bloc Jigsaw définit par quel bloc il est remplacé après l'assemblage. Ici, ce bloc de remplacement est inconnu, le plus souvent à cause d'une faute de frappe comme minecrat: au lieu de minecraft:. Lors de la génération, le bloc reste vide à cet endroit. Le serveur continue de tourner, la structure a simplement un trou.

Voici comment le corriger :

  1. Note la position indiquée dans BlockPos{…} : x, y et z.
  2. Rends-toi à cet endroit en mode créatif avec les droits OP, par exemple avec /tp <x> <y> <z>.
  3. Ouvre le bloc Jigsaw par un clic droit et corrige le nom dans le champ du bloc de remplacement (dans le client en anglais « Turns into »).
  4. Si la structure provient d'un datapack ou d'un mod, l'erreur se trouve dans son fichier de structure. Dans ce cas, une version corrigée du pack ou du mod est nécessaire ; signale l'erreur à son auteur.

Bon à savoir : Le message est sans danger pour le fonctionnement. Il n'affecte que l'apparence de la structure à cet endroit précis. Pour savoir comment attribuer les droits OP, consulte Droits OP et commandes sur le serveur Minecraft.

Ton message n'y figure pas ?

Lis le message en entier dans la Console ou dans logs/latest.log, y compris les lignes juste avant : on y voit souvent quel pack était en cours de chargement. L'espace de noms avant les deux-points et des indications comme file/<Pack>.zip ou mod/<mod> révèlent l'origine du message. Si une stacktrace suit, c'est-à-dire des lignes indentées avec at …, les noms de dossiers et de paquets qu'elle contient indiquent le mod ou le plugin concerné. Avant de modifier des fichiers du monde ou d'un pack, crée une sauvegarde sous Sauvegardes. Si tu es bloqué, ouvre un ticket et indique l'heure du message.