Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Appendix C — All Data Component Types

Every data component the game recognises, grouped by what it does. For each one you get a one-line description and a note on the value it expects. Where a component is taught in the book, the chapter is marked like (Ch23). Components without a chapter marker are not taught directly but follow the same item_id[component=value] bracket syntax you learned in Chapter 21.

This list comes from the wiki’s Data component format page (its master List of components). It reflects current Java Edition (26.2). A component’s value is always written in SNBT (a single value, a list [...], or a compound {...}) exactly as in the /give examples throughout Part VI. The “value note” below describes the typical shape; for the full field list of any component, look up its entry on the wiki’s Data component format page.

A handful of components are non-encoded (used internally, never written on items in commands) or joke-version only (April Fools’ snapshots). Those are listed last, for completeness, and are out of scope for normal data packs.

Display components

These shape how an item looks, what it’s called, and what its tooltip shows. They never change behaviour. Most are taught in Chapter 22.

  • minecraft:custom_name — A player-set custom name for an item, block, or entity; can be added, changed, or removed by anyone with the item at an anvil. Value: a text component (e.g. {text:"Magic Wand",color:"light_purple",italic:false}). (Ch21, Ch22)
  • minecraft:item_name — A built-in name the item carries that, unlike custom_name, cannot be changed in an anvil and is shown in italics-off. Value: a text component or string. (Ch22)
  • minecraft:lore — Extra description lines shown under the name in the tooltip. Value: a list of text components, one per line (e.g. [{text:"This Stick is very sticky."}]). (Ch22)
  • minecraft:rarity — The item’s rarity, which colours its name. Value: a rarity keyword (common, uncommon, rare, epic). (Ch22)
  • minecraft:enchantment_glint_override — Forces the shimmer “glint” on or off, overriding the default. Value: boolean (true/false). (Ch21, Ch22)
  • minecraft:item_model — Makes the item render using a different item’s model. Value: a resource location (e.g. "minecraft:diamond_sword"). (Ch22)
  • minecraft:custom_model_data — Arbitrary data (floats, strings, colors, flags) a resource-pack model can read to choose a custom appearance. Value: a compound of typed lists. (Ch22)
  • minecraft:tooltip_style — Selects a custom tooltip box style for the item. Value: a resource location. (Ch22)
  • minecraft:tooltip_display — Hides the whole tooltip, or hides specific components from it. Value: a compound (e.g. {hidden_components:["minecraft:enchantments"]} or {hide_tooltip:1b}). (Ch22)
  • minecraft:map_color — Tints the filled-map item texture. Value: a decimal RGB color. (Ch24)
  • minecraft:map_decorations — Markers/icons placed on a map. Value: a compound of named decorations. (Ch24)
  • minecraft:map_id — Links a filled-map item to its stored map data. Value: an integer map ID. (Ch24)
  • minecraft:dye — Marks a dye item and which color it acts as. Value: a color keyword (e.g. "red").
  • minecraft:dyed_color — The dyed tint of leather armor and similar items. Value: a decimal/hex RGB color or [r,g,b] float list.
  • minecraft:trim — Armor trim pattern and material applied to a piece of armor. Value: a compound {pattern:..., material:...}. (Ch24)
  • minecraft:banner_patterns — The list of layered patterns on a banner. Value: a list of {pattern,color} compounds. (Ch24)
  • minecraft:base_color — The base color of a shield’s banner. Value: a color keyword (e.g. "lime"). (Ch24)
  • minecraft:pot_decorations — The sherds on each face of a decorated pot. Value: a list of sherd item IDs. (Ch24)
  • minecraft:profile — The player skin shown on a player head. Value: a player name, UUID, or full profile compound. (Ch24)
  • minecraft:note_block_sound — Overrides the note-block sound a placed player head triggers. Value: a sound event ID.
  • minecraft:firework_explosion — A single firework-star explosion shape and colors. Value: an explosion compound. (Ch24)

Functional components

These change how an item behaves: eating, mining, fighting, wearing, durability, cooldowns. Most are taught in Chapter 23; durability/repair details also appear there.

  • minecraft:food — Makes the item edible and sets nutrition/saturation. Value: a compound (e.g. {nutrition:3,saturation:1,can_always_eat:true}). (Ch23)
  • minecraft:consumable — Lets the item be consumed and configures consume time, animation, sound, and on-consume effects. Value: a compound (e.g. {consume_seconds:3.0,animation:'eat',...}). (Ch23)
  • minecraft:use_remainder — The item left behind after the item is used up (like a bucket → empty bucket). Value: an item stack compound ({id:..., count:..., components:...}). (Ch24)
  • minecraft:use_cooldown — A cooldown applied after use, optionally shared across a cooldown group. Value: a compound (e.g. {seconds:10,cooldown_group:"foo:bar"}). (Ch23)
  • minecraft:use_effects — Effects applied when the item is used. Value: a compound of effect definitions.
  • minecraft:tool — Makes the item act as a tool: mining speed and per-block rules. Value: a compound (e.g. {default_mining_speed:1.5,rules:[...]}). (Ch23)
  • minecraft:weapon — Makes the item act as a weapon, with durability-per-attack and shield-disable fields (attack damage comes from attribute_modifiers). Value: a compound (e.g. {item_damage_per_attack:10,disable_blocking_for_seconds:5}). (Ch23)
  • minecraft:attack_range — How far the item’s melee hit reaches, in blocks. Value: a compound. (Ch23)
  • minecraft:minimum_attack_charge — How full the attack indicator must be before the item can attack. Value: a float 0–1 (e.g. 0.5).
  • minecraft:swing_animation — Customises the item’s swing animation. Value: a compound.
  • minecraft:piercing_weapon — Makes a melee attack pierce through targets, with custom sounds. Value: a compound (e.g. {sound:..., hit_sound:...}).
  • minecraft:kinetic_weapon — A charge/ram attack with timing windows for damage, knockback, and dismount. Value: a compound of timing fields. (Ch23, new in 26.x)
  • minecraft:blocks_attacks — Turns the item into a shield, defining damage reductions, disable behaviour, and block sound. Value: a compound (e.g. {damage_reductions:[...],block_sound:...}). (Ch23, new in 26.x)
  • minecraft:weapon — see above.
  • minecraft:damage — Current damage taken by a damageable item (how worn it is). Value: an integer. (Ch21, Ch23)
  • minecraft:max_damage — Maximum durability before the item breaks. Value: an integer (e.g. 4). (Ch23)
  • minecraft:break_sound — The sound played when the item runs out of durability and breaks. Value: a sound event ID (e.g. "item.wolf_armor.break"). (new in 26.x)
  • minecraft:damage_resistant — Item types of damage the item entity is immune to (e.g. fire). Value: a compound (e.g. {types:"#minecraft:is_fire"}). (Ch24)
  • minecraft:unbreakable — Marks the item as never losing durability. Value: an empty compound {} (with optional fields). (Ch23)
  • minecraft:repairable — Which items can repair this one in an anvil. Value: a compound (e.g. {items:"stick"}). (Ch23)
  • minecraft:repair_cost — The accumulated anvil prior-work penalty. Value: an integer. (Ch23)
  • minecraft:enchantable — Makes the item enchantable in an enchanting table and sets its enchantability. Value: a compound (e.g. {value:15}). (Ch23)
  • minecraft:enchantments — The active enchantments on the item. Value: a compound mapping enchantment IDs to levels (e.g. {sharpness:3,knockback:2}). (Ch21, Ch24)
  • minecraft:stored_enchantments — Inactive enchantments stored (as on an enchanted book) that don’t apply until transferred. Value: a compound of enchantment→level. (Ch24)
  • minecraft:equippable — Makes the item wearable in a given slot, with equip sound and worn asset. Value: a compound (e.g. {slot:"head",equip_sound:...}). (Ch23)
  • minecraft:glider — Lets the item function as elytra wings when equipped. Value: an empty compound {}. (Ch23, new in 26.x)
  • minecraft:death_protection — Saves the holder from death (totem behaviour) with custom on-death effects. Value: a compound (e.g. {death_effects:[...]}). (Ch23, new in 26.x)
  • minecraft:attribute_modifiers — Attribute modifiers the item applies (e.g. scale, attack damage, movement). Value: a list of modifier compounds. (Ch23)
  • minecraft:max_stack_size — Overrides how many of the item stack in one slot. Value: an integer (1–99, e.g. 64). (Ch23)
  • minecraft:rarity — see Display; also affects enchanting glint behaviour. (Ch22)
  • minecraft:can_break — In Adventure mode, the blocks this item is allowed to break. Value: a compound listing block IDs/tags.
  • minecraft:can_place_on — In Adventure mode, the blocks this block-item may be placed against. Value: a compound listing block IDs/tags.
  • minecraft:intangible_projectile — Marks a fired projectile that can’t be picked up in Survival. Value: a compound.
  • minecraft:damage_type — Overrides the damage type the item deals on hit. Value: a damage-type ID (e.g. "minecraft:campfire").
  • minecraft:potion_duration_scale — Scales the duration of effects from the item’s potion contents. Value: a float multiplier (e.g. 2). (Ch24)
  • minecraft:ominous_bottle_amplifier — The Bad Omen amplifier granted by an ominous bottle. Value: an integer.
  • minecraft:recipes — Recipes unlocked when a knowledge book is used. Value: a list of recipe IDs.
  • minecraft:jukebox_playable — Lets the item play a music disc in a jukebox. Value: a song/jukebox-song reference. (Ch24)
  • minecraft:instrument — The instrument a goat horn plays. Value: an instrument ID or compound. (Ch24)
  • minecraft:provides_banner_patterns — A banner-pattern item: which pattern tag it can apply to a banner. Value: a banner-pattern tag (e.g. '#minecraft:pattern_item/globe'). (new in 26.x)
  • minecraft:provides_trim_material — A trim-material item: which trim material it supplies in smithing. Value: a trim-material reference. (new in 26.x)
  • minecraft:lock — Locks a container so it opens only while holding a matching key item. Value: a key-predicate compound. (Ch24)
  • minecraft:lodestone_tracker — Points a compass at a tracked lodestone position/dimension. Value: a compound (target pos + dimension). (Ch24)

Container components

These let one item hold other items or item-like contents.

  • minecraft:container — The items stored inside a container item (shulker box, barrel, etc.). Value: a list of {slot,item} compounds. (Ch24)
  • minecraft:container_loot — A loot table that fills the container when first opened. Value: a compound (e.g. {loot_table:"chests/desert_pyramid"}). (Ch24)
  • minecraft:bundle_contents — The items packed inside a bundle. Value: a list of item stack compounds. (Ch24)
  • minecraft:charged_projectiles — Projectiles currently loaded in a crossbow. Value: a list of item stack compounds. (Ch24)
  • minecraft:bees — Bees currently housed in a bee nest/hive item. Value: a list of bee compounds (entity_data + hive timers). (Ch24)
  • minecraft:sulfur_cube_content — The contents of a sulfur-cube item. Value: a compound. (new in 26.x)

Specialty components

Niche or block/entity-data components: written books, potions, maps, NBT carried into placed blocks and spawned entities, your pack’s private scratchpad, and the mob-customising components.

  • minecraft:custom_data — A private scratchpad of arbitrary NBT your data pack can read and match on; the game ignores it. Value: any compound (e.g. {foo:1}). (Ch21, Ch24)
  • minecraft:writable_book_content — The editable pages of a book-and-quill. Value: a compound with a pages list. (Ch24)
  • minecraft:written_book_content — The signed pages, title, and author of a written book. Value: a compound. (Ch24)
  • minecraft:potion_contents — The potion type and/or custom effects an item brews. Value: a compound with potion (string ID), custom_effects (list), custom_color (int — a decimal color overriding the swirl/particle color), and custom_name (string). (Ch24)
  • minecraft:suspicious_stew_effects — The effects a suspicious stew grants when eaten. Value: a list of effect compounds. (Ch24)
  • minecraft:fireworks — A firework rocket’s flight duration and explosion list. Value: a compound. (Ch24)
  • minecraft:block_state — Block-state properties applied when the block item is placed. Value: a compound of property→value (e.g. {type:"top"}). (Ch24)
  • minecraft:block_entity_data — NBT copied into the block entity when the item is placed (e.g. a spawner’s contents). Value: a block-entity compound. (Ch24)
  • minecraft:entity_data — NBT applied to the entity an item spawns/places (e.g. an armor stand). Value: an entity compound including its id. (Ch24)
  • minecraft:bucket_entity_data — NBT of the creature stored in a mob bucket. Value: an entity compound (name/variant live in their own components).
  • minecraft:debug_stick_state — Which block-state property the debug stick is set to edit per block. Value: a compound of block ID → property.
  • minecraft:firework_explosion — see Display (firework-star shape).

Mob-customising components (entity variant components)

Present on spawn eggs, mob buckets, paintings, item frames, etc. They set the variant, color, size, or collar of the entity the item produces. All take a single keyword value (in quotes), and most are covered together in Chapter 24.

  • minecraft:axolotl/variant — Axolotl color variant. Value: a variant keyword (e.g. "blue"). (Ch24)
  • minecraft:cat/variant — Cat appearance variant. Value: a variant keyword (e.g. "jellie"). (Ch24)
  • minecraft:cat/collar — Tamed-cat collar color. Value: a color keyword (e.g. "blue"). (Ch24)
  • minecraft:chicken/variant — Chicken variant (also affects what an egg hatches). Value: a variant keyword (e.g. "cold"). (Ch24)
  • minecraft:cow/variant — Cow variant. Value: a variant keyword (e.g. "cold"). (Ch24)
  • minecraft:fox/variant — Fox variant. Value: a variant keyword (e.g. "snow"). (Ch24)
  • minecraft:frog/variant — Frog variant. Value: a variant keyword (e.g. "cold"). (Ch24)
  • minecraft:horse/variant — Horse coat variant. Value: a variant keyword (e.g. "chestnut"). (Ch24)
  • minecraft:llama/variant — Llama variant. Value: a variant keyword (e.g. "gray"). (Ch24)
  • minecraft:mooshroom/variant — Mooshroom variant. Value: a variant keyword (e.g. "brown"). (Ch24)
  • minecraft:painting/variant — Which painting motif is placed. Value: a painting-variant keyword (e.g. "plant"). (Ch24)
  • minecraft:parrot/variant — Parrot color variant. Value: a variant keyword (e.g. "blue"). (Ch24)
  • minecraft:pig/variant — Pig variant. Value: a variant keyword (e.g. "warm"). (Ch24)
  • minecraft:rabbit/variant — Rabbit variant. Value: a variant keyword (e.g. "evil"). (Ch24)
  • minecraft:salmon/size — Salmon size. Value: a size keyword (e.g. "large"). (Ch24)
  • minecraft:sheep/color — Sheep wool color. Value: a color keyword (e.g. "blue"). (Ch24)
  • minecraft:shulker/color — Shulker color. Value: a color keyword (e.g. "red"). (Ch24)
  • minecraft:tropical_fish/base_color — Tropical fish base color. Value: a color keyword. (Ch24)
  • minecraft:tropical_fish/pattern — Tropical fish pattern. Value: a pattern keyword (e.g. "snooper"). (Ch24)
  • minecraft:tropical_fish/pattern_color — Tropical fish pattern color. Value: a color keyword. (Ch24)
  • minecraft:villager/variant — Villager biome type. Value: a variant keyword (e.g. "desert"). (Ch24)
  • minecraft:wolf/variant — Wolf variant. Value: a variant keyword (e.g. "rusty"). (Ch24)
  • minecraft:wolf/collar — Tamed-wolf collar color. Value: a color keyword (e.g. "blue"). (Ch24)
  • minecraft:wolf/sound_variant — Wolf sound variant. Value: a variant keyword (e.g. "cute"). (Ch24)

Components you won’t write in commands

The following exist in the game but are not part of the normal item_id[component=value] workflow. They are listed here only so the table is complete; you don’t use them in data packs.

Non-encoded (internal only)

Used by the game internally and never stored on items in commands; they cannot be set with /give or read with /data.

  • minecraft:additional_trade_cost — Added to a villager trade’s wanted count. Value: an integer.
  • minecraft:creative_slot_lock — Locks an informational paper item into its creative-inventory slot. Value: a compound.
  • minecraft:map_post_processing — Internal flag set when a filled map is locked or scaled. Value: an integer (0 lock / 1 scale).

Joke-version only (April Fools’ snapshots)

Added in joke snapshots; not present in normal releases.

minecraft:clicks, minecraft:contacts_messages, minecraft:explicit_foil, minecraft:fletching, minecraft:heat, minecraft:hovered, minecraft:lubrication, minecraft:potato_bane, minecraft:resin, minecraft:secret_message, minecraft:snek, minecraft:undercover_id, minecraft:views, minecraft:xp, minecraft:dimension_id, minecraft:exchange_value, minecraft:instant_room, minecraft:mine_active, minecraft:mine_completed, minecraft:mob_trophy/type, minecraft:sky, minecraft:special_mine, minecraft:trophy/type, minecraft:world_effect_uhint, minecraft:world_effect_unlock, minecraft:world_modifiers, minecraft:follow.