Armes et outils

Dans ce guide, tu vas fabriquer deux choses en rubis : une épée en rubis qui frappe plus fort que le fer, et une pioche en rubis qui mine vite la pierre et les minerais. En chemin, tu découvriras les composants qu'utilisent toutes les armes et tous les outils : dégâts, durabilité, enchantement, réparation et minage.

Ce guide s'appuie sur Ton premier objet personnalisé. Les étapes de l'icône, de la texture et du nom fonctionnent pareil, donc on va se concentrer sur ce qui est nouveau.

La méthode rapide : GodCraft

GodCraft propose des objets Épée et Outil tout prêts. Tu choisis les nombres, il écrit les composants et les tags.

1. Ouvre l'Atelier et ajoute une Épée ou un Outil à ton add-on.
2. Dessine-le dans l'éditeur de pixels (en diagonale, le manche en bas à gauche, comme les outils vanilla).
3. Règle les dégâts, la durabilité, les objets de réparation et les enchantements.
4. Touche Exporter et teste-le sur le zombie le plus proche.

Voici à quoi ça ressemble à la main.

À la main : l'épée

On utilise l'espace de noms myname. Remplace-le partout par le tien.

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "myname:ruby_sword",
      "menu_category": {
        "category": "equipment",
        "group": "minecraft:itemGroup.name.sword"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "myname_ruby_sword"
        }
      },
      "minecraft:display_name": {
        "value": "item.myname:ruby_sword.name"
      },
      "minecraft:max_stack_size": 1,
      "minecraft:hand_equipped": true,
      "minecraft:damage": 7,
      "minecraft:durability": {
        "max_durability": 900
      },
      "minecraft:enchantable": {
        "slot": "sword",
        "value": 14
      },
      "minecraft:repairable": {
        "repair_items": [
          {
            "items": ["myname:ruby"],
            "repair_amount": "query.max_durability * 0.25"
          },
          {
            "items": ["myname:ruby_sword"],
            "repair_amount": "context.other->query.remaining_durability"
          }
        ]
      },
      "minecraft:tags": {
        "tags": ["minecraft:is_sword"]
      }
    }
  }
}

Le rôle de chaque partie

1. menu_category place l'épée dans l'onglet Équipement, dans le même dossier que les épées vanilla.
2. minecraft:max_stack_size vaut 1, car les armes ne s'empilent pas.
3. minecraft:hand_equipped fait tenir l'objet au joueur comme un outil, pointé vers l'avant, au lieu de le tenir comme un objet plat.
4. minecraft:damage indique combien de dégâts l'objet ajoute quand tu attaques avec. Plus c'est haut, plus c'est fort. Commence autour de 7 pour une épée du niveau du diamant, puis teste-la sur quelques créatures et ajuste.
5. minecraft:durability indique combien d'usure l'objet supporte avant de casser. Les outils en fer ont 250, ceux en diamant 1561. Tu peux aussi ajouter damage_chance avec un pourcentage min et max, si tu veux qu'il ne perde de la durabilité qu'une partie du temps.
6. minecraft:enchantable décide quels enchantements lui vont. slot est le type d'objet (sword ici) et value la qualité des enchantements sur une table : l'or est très haut, la pierre bas, 14 est un bon milieu.
7. minecraft:repairable liste ce qui peut le réparer sur une enclume. Chaque entrée a ses items et un repair_amount, une petite formule Molang. La première entrée rend un quart de la durabilité par rubis. La seconde permet aux joueurs de combiner deux épées abîmées.
8. minecraft:tags avec minecraft:is_sword indique au jeu et aux autres add-ons qu'il s'agit d'une épée.

Texture et nom

Enregistre un PNG de 16x16 sous RP/textures/items/ruby_sword.png, puis ajoute-le à ton item_texture.json (dans texture_data) et le nom à ton fichier de langue :

"myname_ruby_sword": {
  "textures": "textures/items/ruby_sword"
}

item.myname:ruby_sword.name=Ruby Sword
item.myname:ruby_pickaxe.name=Ruby Pickaxe

À la main : la pioche

Un outil, c'est une arme avec un travail en plus : casser les blocs vite. Ce travail revient à minecraft:digger.

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "myname:ruby_pickaxe",
      "menu_category": {
        "category": "equipment",
        "group": "minecraft:itemGroup.name.pickaxe"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "myname_ruby_pickaxe"
        }
      },
      "minecraft:display_name": {
        "value": "item.myname:ruby_pickaxe.name"
      },
      "minecraft:max_stack_size": 1,
      "minecraft:hand_equipped": true,
      "minecraft:damage": 5,
      "minecraft:durability": {
        "max_durability": 900
      },
      "minecraft:enchantable": {
        "slot": "pickaxe",
        "value": 14
      },
      "minecraft:repairable": {
        "repair_items": [
          {
            "items": ["myname:ruby"],
            "repair_amount": "query.max_durability * 0.25"
          }
        ]
      },
      "minecraft:digger": {
        "use_efficiency": true,
        "destroy_speeds": [
          {
            "block": {
              "tags": "query.any_tag('stone', 'metal')"
            },
            "speed": 7
          },
          {
            "block": "minecraft:obsidian",
            "speed": 7
          }
        ]
      },
      "minecraft:tags": {
        "tags": ["minecraft:is_pickaxe", "minecraft:is_tool", "minecraft:diamond_tier"]
      }
    }
  }
}

Comment fonctionne le minage

• destroy_speeds est une liste. Chaque entrée dit quels blocs et à quelle vitesse.
• block peut être un seul ID de bloc, comme "minecraft:obsidian", ou un objet avec tags et une requête Molang. query.any_tag('stone', 'metal') correspond à tous les blocs qui ont au moins un de ces tags, donc pas besoin de lister des centaines de blocs.
• speed est la vitesse à laquelle il casse ces blocs. Pour te donner une idée : les outils en bois font 2, en pierre 4, en fer 6, en diamant 8, en netherite 9 et en or 12.
• use_efficiency à true permet à l'enchantement Efficacité de le rendre encore plus rapide.

Les tags des outils

Les tags disent à Minecraft de quel type d'outil il s'agit. minecraft:is_pickaxe et minecraft:is_tool disent « c'est une pioche ». Un tag de niveau comme minecraft:iron_tier ou minecraft:diamond_tier dit à quel point il est solide, avec les mêmes tags que les outils vanilla. Les autres types d'outils utilisent minecraft:is_axe, minecraft:is_shovel ou minecraft:is_hoe.

Teste-les

1. Charge tes packs dans un nouveau monde (voir Exporter et installer).
2. Donne-toi les deux objets avec /give :

/give @s myname:ruby_sword
/give @s myname:ruby_pickaxe

3. Frappe une créature, mine un peu de pierre et essaie d'enchanter les deux sur une table.
4. Abîme-les un peu, puis mets-en un sur une enclume avec un rubis pour tester la réparation.

Les emplacements d'enchantement disponibles

Quand quelque chose ne va pas

D'autres solutions dans Dépannage. Pour que les joueurs puissent les fabriquer, lis Recettes d'artisanat et de fourneau, et pour l'armure assortie, consulte Armure personnalisée.