Aller au contenu principal

Composants d'Item

A partir de Minecraft 1.20.5, les items utilisent un nouveau systeme de composants. zMenu fournit un support complet pour ce systeme via la section de configuration components.

info

Les composants necessitent Minecraft 1.20.5 ou superieur. Certains composants ne sont disponibles que dans les versions plus recentes, indiques par un badge a cote du nom de chaque composant.

Structure de base​

item:
  material: DIAMOND_SWORD
  components:
    custom-name: "&6&lEpee Legendaire"
    lore:
      - "&7Une arme puissante"
    enchantments:
      sharpness: 5

attack-range 1.21.11+​

Definit la portee d'attaque d'un item en blocs.

Minecraft Wiki: attack_range

CleTypeDefautPlageDescription
min-reachFloat00-64Distance de portee minimale en mode survie
max-reachFloat30-64Distance de portee maximale en mode survie
min-creative-reachFloat00-64Distance de portee minimale en mode creatif
max-creative-reachFloat50-64Distance de portee maximale en mode creatif
hitbox-marginFloat0.30-1Marge supplementaire pour la detection de hitbox
mob-factorFloat10-2Multiplicateur applique aux hitbox des mobs
components:
  attack-range:
    min-reach: 0
    max-reach: 5
    min-creative-reach: 0
    max-creative-reach: 6
    hitbox-margin: 0.3
    mob-factor: 1.0

attribute-modifiers​

Ajoute des modificateurs d'attributs a l'item.

Minecraft Wiki: attribute_modifiers

CleTypeRequisDescription
typeStringOuiType d'attribut (ex: generic.attack_damage)
amountDoubleOuiValeur du modificateur
operationStringOuiType d'operation: add_value, add_multiplied_base, add_multiplied_total
slotStringNonEmplacement d'equipement: any, mainhand, offhand, head, chest, legs, feet
idStringNonIdentifiant unique du modificateur
components:
  attribute-modifiers:
    - type: generic.attack_damage
      amount: 10
      operation: add_value
      slot: mainhand
      id: "my_plugin:attack_bonus"
    - type: generic.movement_speed
      amount: 0.1
      operation: add_multiplied_base
      slot: feet

Types d'attributs disponibles:

  • generic.armor - Points d'armure
  • generic.armor_toughness - Solidite d'armure
  • generic.attack_damage - Degats d'attaque
  • generic.attack_knockback - Recul d'attaque
  • generic.attack_speed - Vitesse d'attaque
  • generic.flying_speed - Vitesse de vol
  • generic.follow_range - Distance de suivi
  • generic.knockback_resistance - Resistance au recul
  • generic.luck - Chance
  • generic.max_absorption - Absorption maximale
  • generic.max_health - Sante maximale
  • generic.movement_speed - Vitesse de deplacement
  • generic.scale - Echelle de l'entite
  • generic.step_height - Hauteur de pas

Definit les motifs sur un item de banniere.

Minecraft Wiki: banner_patterns

components:
  banner-patterns:
    - pattern: stripe_top
      color: red
    - pattern: cross
      color: blue

base-color​

Definit la couleur de base pour les boucliers et bannieres.

Minecraft Wiki: base_color

components:
  base-color: RED

Couleurs disponibles: WHITE, ORANGE, MAGENTA, LIGHT_BLUE, YELLOW, LIME, PINK, GRAY, LIGHT_GRAY, CYAN, PURPLE, BLUE, BROWN, GREEN, RED, BLACK

block-state​

Definit les proprietes d'etat de bloc pour les items de bloc lorsqu'ils sont places.

Minecraft Wiki: block_state

components:
  block-state:
    facing: north
    powered: true
    waterlogged: false

blocks-attacks 1.21.5+​

Configure le comportement de blocage comme un bouclier pour les items.

Minecraft Wiki: blocks_attacks

CleTypeDefautDescription
block-delay-secondsFloat0Delai avant que le blocage devienne actif
disable-cooldown-scaleFloat1Echelle du temps de recharge quand le bouclier est desactive
block-soundString-Son joue lors du blocage
disabled-soundString-Son joue quand le bouclier est desactive
item-damage.thresholdFloat0Seuil de degats avant que l'item prenne des degats
item-damage.baseFloat0Degats de base de l'item
item-damage.factorFloat1.5Facteur multiplicateur de degats
damage-reductionsList[]Liste des regles de reduction de degats

Proprietes de reduction de degats:

CleTypeDescription
typeString/ListType(s) de degats a reduire
baseFloatReduction de degats de base
factorFloatFacteur de reduction de degats
horizontal-blocking-angleFloatAngle de blocage en degres (defaut: 90)
components:
  blocks-attacks:
    block-delay-seconds: 0.25
    disable-cooldown-scale: 1.0
    block-sound: item.shield.block
    disabled-sound: item.shield.break
    item-damage:
      threshold: 3.0
      base: 0
      factor: 1.5
    damage-reductions:
      - type: player_attack
        base: 5.0
        factor: 0.5
        horizontal-blocking-angle: 90

break-sound 1.21.5+​

Definit le son joue lorsque l'item se casse.

Minecraft Wiki: break_sound

components:
  break-sound: "entity.item.break"

bundle-contents​

Stocke des items dans un sac.

Minecraft Wiki: bundle_contents

components:
  bundle-contents:
    - material: DIAMOND
      amount: 10
    - material: EMERALD
      amount: 5
    - material: GOLD_INGOT
      amount: 20

charged-projectiles​

Stocke des projectiles dans les arbaletes.

Minecraft Wiki: charged_projectiles

components:
  charged-projectiles:
    - material: ARROW
      amount: 1
    - material: SPECTRAL_ARROW
      amount: 1

consumable 1.21.2+​

Configure comment un item est consomme.

Minecraft Wiki: consumable

CleTypeDefautDescription
consume-secondsFloat1.6Temps pour consommer l'item en secondes
animationStringEATType d'animation
consume-soundStringentity.generic.eatSon joue lors de la consommation
has-consume-particlesBooleantrueAfficher les particules lors de la consommation
on-consume-effectsList[]Effets a appliquer lors de la consommation
components:
  consumable:
    consume-seconds: 1.6
    animation: EAT
    consume-sound: entity.generic.eat
    has-consume-particles: true
    on-consume-effects:
      - type: APPLY_EFFECTS
        probability: 1.0
        effects:
          - type: speed
            amplifier: 1
            duration: 600
      - type: PLAY_SOUND
        sound: entity.player.burp
      - type: TELEPORT_RANDOMLY
        diameter: 16.0
      - type: CLEAR_ALL_EFFECTS
      - type: REMOVE_EFFECTS
        effects:
          - poison
          - wither

Types d'animation: EAT, DRINK, BLOCK, BOW, SPEAR, CROSSBOW, SPYGLASS, TOOT_HORN, BRUSH, BUNDLE

Types d'effets:

  • APPLY_EFFECTS - Appliquer des effets de potion avec probabilite
  • PLAY_SOUND - Jouer un son
  • TELEPORT_RANDOMLY - Teleporter aleatoirement dans un diametre
  • CLEAR_ALL_EFFECTS - Supprimer tous les effets de potion
  • REMOVE_EFFECTS - Supprimer des effets specifiques

container​

Stocke des items a l'interieur de l'item (comme les boites de shulker).

Minecraft Wiki: container

CleTypeDescription
slotIntegerIndex de l'emplacement (0-26 pour les boites de shulker)
materialStringMateriau de l'item
amountIntegerQuantite de l'item
components:
  container:
    - slot: 0
      material: DIAMOND
      amount: 64
    - slot: 1
      material: EMERALD
      amount: 32

container-loot​

Definit la table de butin pour les items conteneurs.

Minecraft Wiki: container_loot

CleTypeDefautDescription
loot-tableString-Nom de la table de butin (ex: DESERT_PYRAMID)
seedLong0Graine aleatoire pour la generation du butin
components:
  container-loot:
    loot-table: DESERT_PYRAMID
    seed: 12345

Tables de butin disponibles: ABANDONED_MINESHAFT, BASTION_BRIDGE, BURIED_TREASURE, DESERT_PYRAMID, END_CITY_TREASURE, JUNGLE_TEMPLE, NETHER_BRIDGE, PILLAGER_OUTPOST, SHIPWRECK_TREASURE, SIMPLE_DUNGEON, STRONGHOLD_CORRIDOR, VILLAGE_ARMORER, WOODLAND_MANSION, et plus.

custom-data​

Stocke des donnees persistantes personnalisees (NBT) sur l'item.

Minecraft Wiki: custom_data

Supporte plusieurs types de donnees avec detection automatique du type:

  • String
  • Boolean
  • Integer
  • Long
  • Double
  • Float
  • Byte
  • Short
  • Tableaux byte[], int[], long[]
components:
  custom-data:
    "my_plugin:item_id": "legendary_sword"
    "my_plugin:level": 10
    "my_plugin:enchanted": true
    "my_plugin:damage_bonus": 5.5

custom-model-data​

Donnees de modele personnalise pour l'integration des packs de ressources.

Minecraft Wiki: custom_model_data

CleTypeDescription
floatsList<Float>Valeurs flottantes pour les predicats
flagsList<Boolean>Drapeaux booleens pour les predicats
stringsList<String>Valeurs de chaine pour les predicats
colorsList<Color>Valeurs de couleur (format hex)
components:
  custom-model-data:
    floats:
      - 1.0
      - 2.5
    flags:
      - true
      - false
    strings:
      - "variant_a"
    colors:
      - "#FF5555"
      - "#55FF55"

damage​

Definit la valeur de degats actuelle de l'item.

Minecraft Wiki: damage

components:
  damage: 100

damage-resistant​

Rend l'item resistant a des types de degats specifiques.

Minecraft Wiki: damage_resistant

CleTypeDescription
typesStringTag de type de degats a resister
components:
  damage-resistant:
    types: "minecraft:is_fire"

Tags de types de degats disponibles: is_fire, is_explosion, is_projectile, is_fall, bypasses_armor, bypasses_shield, is_drowning, is_freezing

damage-type 1.21.11+​

Definit le type de degats infliges par l'item lorsqu'il est utilise comme arme.

Minecraft Wiki: damage_type

components:
  damage-type: "minecraft:player_attack"

Types de degats courants: player_attack, mob_attack, arrow, fireball, magic, wither, dragon_breath, freeze, sonic_boom

dye-color​

Definit la couleur de teinture pour les armures en cuir et autres items teignables.

Minecraft Wiki: dyed_color

components:
  dye-color: "#FF5555"

enchantable 1.21.2+​

Definit la valeur d'enchantabilite de l'item.

Minecraft Wiki: enchantable

components:
  enchantable: 15

enchantment-glint-override​

Force ou supprime l'effet de lueur d'enchantement.

Minecraft Wiki: enchantment_glint_override

components:
  enchantment-glint-override: true   # Forcer la lueur
components:
  enchantment-glint-override: false  # Supprimer la lueur

enchantments​

Ajoute des enchantements a l'item.

Minecraft Wiki: enchantments

components:
  enchantments:
    sharpness: 5
    unbreaking: 3
    fire_aspect: 2
    mending: 1

equippable 1.21.2+​

Configure les proprietes d'equipement pour n'importe quel item.

Minecraft Wiki: equippable

CleTypeDefautDescription
slotString-Emplacement d'equipement: HEAD, CHEST, LEGS, FEET, MAINHAND, OFFHAND, BODY
equip-soundString-Son lors de l'equipement
asset-idString-Emplacement de ressource pour le modele d'equipement
dispensableBooleantruePeut etre equipe par les distributeurs
swappableBooleantruePeut etre echange avec d'autres equipements
damage-on-hurtBooleantrueSubit des degats quand l'entite est blessee
equip-on-interactBooleanfalseS'equipe au clic droit
camera-overlayString-Emplacement de ressource pour l'overlay de camera
can-be-shearedBooleanfalsePeut etre cisaille de l'entite
shearing-soundString-Son lors du cisaillement
allowed-entitiesList-Entites qui peuvent porter cet item
components:
  equippable:
    slot: HEAD
    equip-sound: item.armor.equip_leather
    asset-id: "minecraft:leather"
    dispensable: true
    swappable: true
    damage-on-hurt: true
    equip-on-interact: false
    can-be-sheared: false
    allowed-entities:
      - minecraft:player
      - minecraft:armor_stand

firework-explosion​

Configure un effet d'explosion unique d'etoile de feu d'artifice.

Minecraft Wiki: firework_explosion

CleTypeDescription
shapeStringForme: BALL, LARGE_BALL, BURST, CREEPER, STAR
colorsColorCouleur primaire (format hex)
fade_colorsColorCouleur d'estompage (format hex)
has_trailBooleanA un effet de trainee
has_twinkleBooleanA un effet de scintillement
components:
  firework-explosion:
    shape: STAR
    colors: "#FF0000"
    fade_colors: "#FFFF00"
    has_trail: true
    has_twinkle: true

fireworks​

Configure les fusees de feu d'artifice.

Minecraft Wiki: fireworks

CleTypeDefautDescription
flight-durationInteger1Duree de vol (1-3)
explosionsList[]Liste des effets d'explosion

Proprietes d'explosion:

CleTypeDescription
shapeStringForme: BALL, LARGE_BALL, BURST, CREEPER, STAR
colorsListCouleurs primaires (format hex)
fade-colorsListCouleurs d'estompage (format hex)
has-trailBooleanA un effet de trainee
has-twinkleBooleanA un effet de scintillement
components:
  fireworks:
    flight-duration: 2
    explosions:
      - shape: LARGE_BALL
        colors:
          - "#FF0000"
          - "#00FF00"
        fade-colors:
          - "#FFFF00"
        has-trail: true
        has-twinkle: true

food​

Rend n'importe quel item comestible.

Minecraft Wiki: food

CleTypeDefautRequisDescription
nutritionInteger-OuiPoints de nourriture restaures (barres de faim)
saturationFloat-OuiModificateur de saturation
can-always-eatBooleanfalseNonPeut manger meme sans avoir faim
components:
  food:
    nutrition: 6
    saturation: 0.8
    can-always-eat: true

glider 1.21.2+​

Fait fonctionner l'item comme une elytre lorsqu'il est equipe dans l'emplacement de poitrine.

Minecraft Wiki: glider

components:
  glider: true

instrument​

Configure les proprietes d'instrument de corne de chevre.

Minecraft Wiki: instrument

Simple (par nom d'instrument):

components:
  instrument: "minecraft:ponder_goat_horn"

Configuration avancee:

CleTypeDescription
sound-eventStringSon a jouer
use-durationFloatDuree d'utilisation en secondes
rangeFloatPortee d'ecoute en blocs
descriptionStringDescription de l'instrument
components:
  instrument:
    sound-event: "minecraft:ponder_goat_horn"
    use-duration: 7.0
    range: 256.0
    description: "Une corne de chevre mysterieuse"

Instruments disponibles: ponder_goat_horn, sing_goat_horn, seek_goat_horn, feel_goat_horn, admire_goat_horn, call_goat_horn, yearn_goat_horn, dream_goat_horn

item-model 1.21.2+​

Definit directement le modele de l'item.

Minecraft Wiki: item_model

components:
  item-model: "minecraft:custom/my_model"

item-name​

Definit le nom de base de l'item (ne peut pas etre modifie sur une enclume, affiche en italique).

Minecraft Wiki: item_name

components:
  item-name: "&6Item Special"

jukebox-playable 1.21+​

Rend l'item jouable dans un jukebox.

Minecraft Wiki: jukebox_playable

components:
  jukebox-playable: "minecraft:music_disc.cat"

kinetic-weapon 1.21.11+​

Configure le comportement d'arme de type lance pour le combat monte.

Minecraft Wiki: kinetic_weapon

CleTypeDefautDescription
delay-ticksInteger0Delai avant l'attaque en ticks
forward-movementFloat0Mouvement vers l'avant lors de l'impact
damage-multiplierFloat1Multiplicateur de degats
soundString-Son lors de la charge
hit-soundString-Son lors de l'impact
damage-conditionsObject-Conditions pour infliger des degats
dismount-conditionsObject-Conditions pour demonter la cible
knockback-conditionsObject-Conditions pour le recul

Proprietes de condition:

CleTypeDescription
max-duration-ticksIntegerDuree maximale pour la condition
min-speedFloatVitesse minimale du joueur
min-relative-speedFloatVitesse minimale relative a la cible
components:
  kinetic-weapon:
    delay-ticks: 0
    forward-movement: 0.5
    damage-multiplier: 2.0
    sound: "entity.player.attack.sweep"
    hit-sound: "entity.player.attack.strong"
    damage-conditions:
      max-duration-ticks: 100
      min-speed: 0.5
      min-relative-speed: 0.3
    dismount-conditions:
      max-duration-ticks: 50
      min-speed: 0.8
      min-relative-speed: 0.5

lodestone-tracker​

Configure le suivi de magnetite pour la boussole.

Minecraft Wiki: lodestone_tracker

CleTypeDefautDescription
trackedBooleantrueSi la magnetite est suivie
target.postList<Integer>-Coordonnees cibles [x, y, z]
target.dimensionString-Nom du monde
components:
  lodestone-tracker:
    tracked: true
    target:
      post: [100, 64, -200]
      dimension: world

lore​

Definit les lignes de description de l'item.

Minecraft Wiki: lore

components:
  lore:
    - "&7Ligne 1"
    - "&7Ligne 2"
    - ""
    - "&eCliquez pour utiliser !"

Ou en une seule ligne:

components:
  lore: "&7Une description simple"

map-color​

Definit la couleur du marqueur de carte pour les cartes remplies.

Minecraft Wiki: map_color

components:
  map-color: "#FF5555"

map-id​

Definit l'ID de carte pour les cartes remplies.

Minecraft Wiki: map_id

components:
  map-id: 1234

max-damage​

Definit la durabilite maximale de l'item.

Minecraft Wiki: max_damage

components:
  max-damage: 2000

max-stack-size​

Remplace la taille de pile maximale (1-99).

Minecraft Wiki: max_stack_size

components:
  max-stack-size: 16

minimum-attack-charge 1.21.11+​

Definit la charge d'attaque minimale requise pour infliger des degats.

Minecraft Wiki: minimum_attack_charge

components:
  minimum-attack-charge: 0.5

ominous-bottle-amplifier​

Definit l'amplificateur de Mauvais Presage pour les bouteilles inquietantes.

Minecraft Wiki: ominous_bottle_amplifier

components:
  ominous-bottle-amplifier: 4

piercing-weapon 1.21.11+​

Configure le comportement d'arme de type trident.

Minecraft Wiki: piercing_weapon

CleTypeDefautDescription
deals-knockbackBooleantrueSi les coups infligent un recul
dismountsBooleanfalseSi les coups demontent les cavaliers
soundString-Son lors du lancer
hit-soundString-Son lors de l'impact
components:
  piercing-weapon:
    deals-knockback: true
    dismounts: true
    sound: "item.trident.throw"
    hit-sound: "item.trident.hit"

potion-contents​

Configure les effets de potion et l'apparence.

Minecraft Wiki: potion_contents

CleTypeDescription
potionStringType de potion de base (ex: speed, healing)
custom-colorStringCouleur de potion personnalisee (format hex)
custom-nameStringNom de potion personnalise
custom-effectsListListe des effets de potion personnalises

Proprietes des effets personnalises:

CleTypeDescription
typeStringType d'effet (ex: speed, jump_boost)
amplifierIntegerNiveau d'effet (0 = niveau 1)
durationIntegerDuree en ticks (20 ticks = 1 seconde)
ambientBooleanParticules ambiantes (comme la balise)
show-particlesBooleanAfficher les particules d'effet
show-iconBooleanAfficher l'icone d'effet
components:
  potion-contents:
    potion: speed
    custom-color: "#FF0000"
    custom-name: "&cPotion de Super Vitesse"
    custom-effects:
      - type: speed
        amplifier: 1
        duration: 600
        ambient: false
        show-particles: true
        show-icon: true
      - type: jump_boost
        amplifier: 2
        duration: 600

potion-duration-scale 1.21.5+​

Multiplie la duree des effets de potion.

Minecraft Wiki: potion_duration_scale

components:
  potion-duration-scale: 1.5

profile 1.21.9+​

Configure l'apparence des tetes de joueur.

Minecraft Wiki: profile

Simple (par nom de joueur ou UUID):

components:
  profile: "Notch"
components:
  profile: "069a79f4-44e9-4726-a5be-fca90e38aaf5"

Par URL de texture:

components:
  profile: "http://textures.minecraft.net/texture/abc123..."

Configuration avancee:

components:
  profile:
    id: "069a79f4-44e9-4726-a5be-fca90e38aaf5"
    name: "Notch"
    texture: "http://textures.minecraft.net/texture/..."
    model: classic  # ou "slim"
    cape: "http://textures.minecraft.net/texture/..."

rarity​

Definit la rarete de l'item, ce qui affecte la couleur du nom.

Minecraft Wiki: rarity

components:
  rarity: EPIC

Valeurs disponibles:

  • COMMON - Nom blanc
  • UNCOMMON - Nom jaune
  • RARE - Nom cyan
  • EPIC - Nom violet clair

recipes​

Debloque des recettes lorsque l'item est obtenu (livre de connaissances).

Minecraft Wiki: recipes

components:
  recipes:
    - "minecraft:diamond_sword"
    - "minecraft:diamond_pickaxe"
    - "minecraft:enchanting_table"

repair-cost​

Definit le cout de reparation sur l'enclume.

Minecraft Wiki: repair_cost

components:
  repair-cost: 5

stored-enchantments​

Enchantements stockes dans les livres enchantes.

Minecraft Wiki: stored_enchantments

components:
  stored-enchantments:
    mending: 1
    unbreaking: 3

suspicious-stew-effects​

Definit les effets de potion pour le ragout suspect.

Minecraft Wiki: suspicious_stew_effects

components:
  suspicious-stew-effects:
    - type: blindness
      amplifier: 0
      duration: 100
    - type: saturation
      amplifier: 0
      duration: 200

swing-animation 1.21.11+​

Configure l'animation de balancement lors de l'utilisation de l'item.

Minecraft Wiki: swing_animation

CleTypeDefautDescription
durationInteger6Duree de l'animation en ticks
typeStringWHACKType d'animation
components:
  swing-animation:
    duration: 6
    type: WHACK

Types d'animation: WHACK, BRUSH

tool​

Transforme n'importe quel item en outil avec des capacites de minage.

Minecraft Wiki: tool

CleTypeDefautDescription
default-mining-speedFloat1.0Vitesse par defaut pour les blocs non specifies
damage-per-blockInteger1Durabilite perdue par bloc mine
can-destroy-blocks-in-creativeBooleantruePeut casser des blocs en mode creatif
rulesList[]Regles de minage specifiques aux blocs

Proprietes des regles:

CleTypeDefautDescription
blocksList/String-Bloc(s) ou tag de bloc
speedFloat1.0Vitesse de minage pour ces blocs
correct-for-dropsBooleanfalseSi les blocs lachent des items lorsqu'ils sont mines
components:
  tool:
    default-mining-speed: 1.0
    damage-per-block: 1
    can-destroy-blocks-in-creative: true
    rules:
      - blocks:
          - minecraft:stone
          - minecraft:granite
          - minecraft:diorite
        speed: 8.0
        correct-for-drops: true
      - blocks: "#minecraft:mineable/pickaxe"
        speed: 4.0
        correct-for-drops: true

tooltip-display 1.21.5+​

Controle la visibilite de l'infobulle.

Minecraft Wiki: tooltip_display

CleTypeDefautDescription
hide-tooltipBooleanfalseMasquer l'infobulle entiere
components:
  tooltip-display:
    hide-tooltip: true

tooltip-style 1.21.2+​

Definit un style d'infobulle personnalise depuis les packs de ressources.

Minecraft Wiki: tooltip_style

components:
  tooltip-style: "minecraft:custom_tooltip"

trim​

Applique des motifs de garniture d'armure.

Minecraft Wiki: trim

CleTypeRequisDescription
materialStringOuiMateriau de garniture
patternStringOuiMotif de garniture
components:
  trim:
    material: gold
    pattern: sentry

Materiaux: amethyst, copper, diamond, emerald, gold, iron, lapis, netherite, quartz, redstone

Motifs: coast, dune, eye, host, raiser, rib, sentry, shaper, silence, snout, spire, tide, vex, ward, wayfinder, wild

unbreakable​

Rend l'item incassable.

Minecraft Wiki: unbreakable

components:
  unbreakable: true

use-cooldown 1.21.2+​

Ajoute un temps de recharge apres l'utilisation de l'item.

Minecraft Wiki: use_cooldown

CleTypeDefautDescription
secondsFloat0Duree du temps de recharge en secondes
cooldown-groupString-Identifiant du groupe de temps de recharge (les items du meme groupe partagent le temps de recharge)
components:
  use-cooldown:
    seconds: 1.0
    cooldown-group: "my_plugin:special_items"

use-effects 1.21.11+​

Configure les effets lors de l'utilisation de l'item (comme la longue-vue).

Minecraft Wiki: use_effects

CleTypeDefautDescription
can-sprintBooleanfalsePeut sprinter pendant l'utilisation
speed-multiplierFloat0.2Multiplicateur de vitesse de deplacement pendant l'utilisation
interact-vibrationsBooleantrueEmet des vibrations de sculk lors de l'interaction
components:
  use-effects:
    can-sprint: false
    speed-multiplier: 0.2
    interact-vibrations: true

use-remainder 1.21.2+​

Item restant apres utilisation (comme les bols de ragout).

Minecraft Wiki: use_remainder

components:
  use-remainder:
    material: BOWL
    amount: 1

weapon 1.21.5+​

Configure les proprietes de degats de l'arme.

Minecraft Wiki: weapon

CleTypeDefautDescription
item-damage-per-attackInteger1Durabilite perdue par attaque
disable-blocking-for-secondsFloat0Duree pour desactiver le blocage au bouclier
components:
  weapon:
    item-damage-per-attack: 1
    disable-blocking-for-seconds: 5.0

writable-book-content​

Contenu pour le livre et plume (livre inscriptible).

Minecraft Wiki: writable_book_content

CleTypeDescription
pagesListListe des pages avec contenu texte brut
components:
  writable-book-content:
    pages:
      - title: "Mon Journal"
        raw: "Jour 1 : J'ai commence mon aventure..."
      - raw: "Jour 2 : J'ai trouve un village..."
      - raw: "Jour 3 : J'ai decouvert une forteresse !"

written-book-content​

Contenu pour les livres signes.

Minecraft Wiki: written_book_content

CleTypeDescription
titleStringTitre du livre
authorStringNom de l'auteur
generationStringGeneration du livre: ORIGINAL, COPY_OF_ORIGINAL, COPY_OF_COPY, TATTERED
pagesListListe des pages avec contenu texte brut
components:
  written-book-content:
    title: "La Legende de Herobrine"
    author: "Notch"
    generation: ORIGINAL
    pages:
      - raw: "Chapitre 1\n\nC'etait une nuit sombre et orageuse..."
      - raw: "Chapitre 2\n\nLa silhouette mysterieuse apparut..."
      - raw: "Fin"

Exemple complet​

Voici un exemple complet d'une epee legendaire personnalisee utilisant les composants:

item:
  material: DIAMOND_SWORD
  components:
    item-name: "&6&l✦ Excalibur ✦"
    lore:
      - "&7L'epee legendaire des rois"
      - ""
      - "&7Degats: &c+15"
      - "&7Vitesse d'attaque: &a+1.6"
      - ""
      - "&5&oForgee dans le feu du dragon"
      - ""
      - "&eClic droit pour capacite speciale !"
    rarity: EPIC
    enchantments:
      sharpness: 10
      fire_aspect: 2
      unbreaking: 5
      mending: 1
    enchantment-glint-override: true
    attribute-modifiers:
      - type: generic.attack_damage
        amount: 15
        operation: add_value
        slot: mainhand
      - type: generic.attack_speed
        amount: 1.6
        operation: add_value
        slot: mainhand
    unbreakable: true
    max-damage: 5000
    attack-range:
      max-reach: 4
      max-creative-reach: 6

Compatibilite des versions​

ComposantVersion minimale
La plupart des composants1.20.5
food, tool, container-loot, custom-data, damage-resistant, ominous-bottle-amplifier1.20.5
jukebox-playable1.21
consumable, enchantable, equippable, glider, item-model, tooltip-style, use-cooldown, use-remainder1.21.2
blocks-attacks, break-sound, potion-duration-scale, tooltip-display, weapon1.21.5
profile1.21.9
attack-range, damage-type, kinetic-weapon, minimum-attack-charge, piercing-weapon, swing-animation, use-effects1.21.11

Prochaines etapes​

Copyright © 2026 GroupeZ|Build #loading...|-