Guides
DépannageImportOutputDiff

Pourquoi votre commande Minecraft ne fonctionne pas

9 min de lecture

La plupart des commandes cassées échouent pour l'une des quatre raisons suivantes: la commande cible la mauvaise version de Minecraft, le sélecteur ne correspond à rien, le JSON ou le NBT est mal formé ou la commande utilise uniquement des données Java dans Bedrock. NBTForge aide en reconstruisant les commandes prises en charge dans des champs saisis, en affichant des avertissements et en gardant l'Output visible pendant que vous modifiez.

Commencez par identifier le type d’échec, puis suivez la liste de contrôle avant de réessayer la commande.
Collez d'abord la commande cassée dans Import, puis confirmez l'édition et la version cible de Java.
Gardez l'Output visible pendant la correction de la commande et utilisez Diff après chaque modification afin que la véritable modification soit évidente.

Résultat du guide

Une passe de débogage de commande reproductible qui isole les problèmes de syntaxe, de cible, de version et d'édition avant de coller à nouveau.

Ouvrir le workflow liéImport, Output, DiffDébogage des commandes cassées

Parcours recommandé

  1. Collez la commande dans la barre d'importation et vérifiez si NBTForge peut la router vers un module visuel.
  2. Définissez Edition et Version pour qu'ils correspondent au monde qui exécutera la commande.
  3. Lisez les avertissements de Output avant de modifier les champs, en particulier lors du déplacement entre Java et Bedrock.
  4. Vérifiez les sélecteurs de cible séparément avec une simple commande de test avant de blâmer la charge utile NBT.
  5. Utilisez Diff après chaque correctif afin de savoir quelle partie de la commande a réellement changé.

Commencez par une incompatibilité de version

Une commande copiée à partir d'un monde Java actuel peut échouer dans Java 1.20.4 ou une version antérieure, car la syntaxe des composants d'objet n'existait pas encore. L'inverse est également courant: l'ancien objet NBT peut être accepté par un monde plus ancien mais échoue ou se comporte différemment après le changement de composant de l'objet 1.20.5.

Définissez d'abord la version NBTForge, puis régénérez l'Output. Si la commande change de forme après le changement de version, traitez cela comme une véritable différence de syntaxe plutôt que comme une réécriture cosmétique.

  • Utilisez Java 1.20.4 ou une version antérieure pour les exemples d'objets hérités NBT.
  • Utilisez Java 1.20.5+ pour l'Output d'objet de style composant.
  • Utilisez Bedrock Stable uniquement lorsque la famille de commandes est prise en charge par la syntaxe Bedrock.

Séparer les bogues de sélection des bogues de charge utile

Une commande valide peut apparaître interrompue lorsque le sélecteur ne correspond à aucune entité ou correspond au mauvais joueur. Testez le sélecteur avec une petite commande telle qu'un titre, un tellraw ou un effet avant de déboguer une longue invocation ou de donner une charge utile.

Lorsqu'un sélecteur inclut des filtres de distance, de scores, de tags, d'équipes ou NBT, supprimez les filtres un par un jusqu'à ce que la commande recommence à correspondre. Ajoutez ensuite à nouveau les filtres par les plus petites étapes possibles.

Vérifier les cotations et les données imbriquées

Les commandes longues s'articulent généralement autour de composants de texte JSON imbriqués, de guillemets échappés, de noms d'objets, de lignes lore ou de NBT écrits à la main. Si la commande inclut du texte de joueur visible, reconstruisez ce texte dans l'éditeur visuel au lieu de modifier les guillemets à la main.

NBTForge est plus utile après l'importation car il transforme une grande chaîne en champs saisis plus petits. Modifiez un champ, vérifiez le résultat et évitez de modifier plusieurs sections imbriquées à la fois.

  • Les noms et lore échouent souvent car le texte JSON est doublement échappé.
  • Les livres peuvent échouer lorsque le texte de la page contient des guillemets sans échappement.
  • Les données personnalisées peuvent échouer lorsque les accolades ou les crochets ne se ferment pas dans le bon ordre.

Expédier l'artefact copié

Utilisez ce guide pour produire l'artefact qu'un joueur ou un créateur de carte exécutera réellement: une commande copiée, un pack Project commandé ou une ressource de datapack. La révision finale doit avoir lieu sur cette Output copiée, et pas seulement sur l'état du générateur modifiable.

Lorsque le flux de travail est sensible à la version, étiquetez la version cible à côté de la commande. Lorsqu'il utilise des sélecteurs, des tableaux de bord, des barres de boss, des balises, des tables de butin ou un ordre de Project, testez ces dépendances dans un monde propre avant de publier la configuration.

Pour des exemples réels de débogage, comparez le Préréglage de commande de zombie chevauchant une araignée, le Préréglage de commande d'invocation de Spider Jockey et le Préréglage du butin du boss de feu Blaze Emperor.

  • Copiez de Output pour une commande et de Project pour les packs commandés.
  • Séparez les variantes Java, Bedrock et d’instantané.
  • Testez d'abord les sélecteurs destructeurs avec une Output inoffensive.
  • Mettez à jour les presets associés lorsque le guide devient le flux de travail canonique.

Guides et presets liés

FAQ

Pourquoi une commande fonctionne-t-elle dans un monde mais pas dans un autre?

La cause la plus courante est une incompatibilité de version ou d’édition Minecraft. La syntaxe des objets Java, les fonctionnalités d'instantané et la prise en charge des commandes Bedrock peuvent différer même lorsque la commande semble similaire.

Dois-je corriger une commande longue à la main?

Seulement pour de petites modifications. Pour les commandes d'objets longs, d'invocation, de texte ou de datapack, importez la commande et modifiez les champs visuellement afin que les données d'échappement et les données imbriquées restent plus faciles à examiner.

Quand ce guide doit-il devenir un pack Project?

Utilisez Project lorsque le flux de travail nécessite plusieurs commandes, comporte un ordre de configuration et de nettoyage ou doit être à nouveau modifié après le test. Les commandes ponctuelles peuvent rester dans Output.