Guide des échanges de villageois Minecraft

Pourquoi les villageois personnalisés comptent sur un serveur narratif

Le marchand a un avantage énorme : il garde l’échange à l’intérieur du monde. Le joueur ne voit pas un simple menu abstrait, mais un personnage avec un lieu, une fonction et une raison de vendre précisément cet objet. Quand la mise en scène compte, ce type de PNJ paraît faire partie du décor vivant au lieu de ressembler à un bouton déguisé.

L’outil existe parce qu’une commande summon devient vite longue et agaçante à construire à la main. Dès qu’on ajoute plusieurs objets, des limites, du CustomModelData ou un second prix, la syntaxe manuelle commence à voler trop d’attention.

Ce que fait l’outil

Le constructeur génère une longue commande /summon minecraft:villager. Elle définit l’apparence et le comportement du PNJ, puis ajoute un bloc Offers avec une liste de Recipes.

Structure principale

Chaque échange possède au minimum deux piles d’objets : buy et sell. Si le prix utilise deux objets, la commande ajoute aussi buyB.

Les trois modes de version ne sont pas décoratifs

Le constructeur affiche trois choix parce que la syntaxe des items a changé deux fois, pas une seule. Minecraft 1.20.5 a déplacé les items vers les Data Components, puis 1.21.4 a encore affiné le format moderne pour certains champs comme custom_model_data.

• 1.21.4+ utilise toujours count et components, mais certaines structures deviennent un peu plus formelles. Ici, cela se voit surtout sur l’écriture de minecraft:custom_model_data.
• 1.20.5-1.21.3 utilise déjà count et components, mais garde le premier style moderne.
• Avant 1.20.5 utilise Count et l’ancien tag avec les item stacks NBT legacy.

Autrement dit, ces trois modes décident réellement comment buy, buyB et sell seront sérialisés dans la commande summon. Le helper du command block reflète la même séparation surtout pour rester clair, même si le simple /give du bloc change beaucoup moins que le payload complet du villageois.

Champs du villageois

• Profession règle le métier et la tenue du villageois.
• Biome type change sa variante visuelle : plains, desert, taiga, swamp, etc.
• Level influence l’insigne visible à la ceinture.
• NoAI garde le PNJ en place si c’est une boutique fixe.
• Invulnerable le protège des dégâts accidentels.

Champs d’échange

• Buy item est le prix principal, par exemple emerald.
• Second buy item est un prix additionnel : diamant, jeton ou objet de quête.
• Sell item est la récompense reçue par le joueur.
• CustomModelData permet de vendre un objet avec un modèle ou une icône particulière issus du pack.
• Max uses définit la limite d’utilisation de l’échange.

Comment l’utiliser sur un vrai serveur

1. Choisissez d’abord le mode de syntaxe correspondant à votre version.
2. Fixez ensuite l’identité du PNJ : profession, biome, niveau et mobilité.
3. Construisez une seule ligne d’échange complètement avant de dupliquer le schéma.
4. Testez la commande summon une fois en jeu avant de la transmettre à l’équipe ou de l’enfouir dans des fichiers.
5. Si la longueur dépasse déjà ce qui reste confortable dans le chat, passez immédiatement par un command block.

Utilisation sur le serveur

Copiez la commande générée dans la console opérateur ou dans un command block.

Important : si la commande summon dépasse 256 caractères, utilisez directement un command block. Le chat de Minecraft coupe les longues constructions beaucoup plus vite qu’on ne le souhaiterait.

Idées pratiques

• Un vendeur de laissez-passer qui accepte des jetons de quête.
• Un forgeron qui vend des armes liées à CustomModelData.
• Un archiviste qui échange des documents trouvés contre de nouveaux indices.
• Un marchand de faction avec objets verrouillés derrière une monnaie scénarisée.

Erreurs fréquentes

• Choisir le mauvais mode de version puis accuser la logique d’échange alors que le vrai problème est la syntaxe des items.
• Tester cinq échanges d’un coup au lieu de valider une seule ligne d’abord.
• Laisser NoAI désactivé sur un PNJ fixe puis courir après lui dans tout le marché.
• Oublier que les longues commandes summon doivent vivre dans un command block.
• Utiliser CustomModelData sur les objets vendus sans vérifier que le hook visuel existe vraiment côté pack.

FAQ