최근 수정 시각 : 2025-09-17 01:36:56

마인크래프트/아이템/구성 요소


파일:상위 문서 아이콘.svg   상위 문서: 마인크래프트/아이템
※ 자바 에디션의 최신버전인 1.21.8 기준이며, 상하위 버전에 맞지 않는 구성 요소가 있을 수 있습니다.

||<-6><tablealign=center><tablebordercolor=darkgreen><tablebgcolor=#fff,#1c1d1f>
파일:마인크래프트 로고.svg
아이템 관련 문서
||
파일:마인크래프트/벽돌(블록).png
건축 블록 		파일:마인크래프트/청록색 양털.png
색깔 블록 		파일:마인크래프트/잔디 블록.png
자연 블록 		파일:참나무 표지판(마인크래프트).png
기능 블록 		파일:마인크래프트/레드스톤 가루.png
레드스톤 블록
파일:마인크래프트/다이아몬드 곡괭이.png
도구 및 유용한 물건 		파일:마인크래프트/네더라이트 검.png
전투 		파일:마인크래프트/황금 사과.png
음식 및 음료 		파일:마인크래프트/철 주괴.png
재료 		파일:마인크래프트/명령 블록.png
생성 알 & 특수 아이템
{{{#!wiki style="margin:-16px -11px"
}}}||


1. 개요2. 모든 상위 태그
2.1. count2.2. id2.3. Slot2.4. components
3. 모든 아이템
3.1. minecraft:attribute_modifiers3.2. minecraft:blocks_attacks3.3. minecraft:break_sound3.4. minecraft:can_break3.5. minecraft:consumable3.6. minecraft:custom_data3.7. minecraft:custom_model_data3.8. minecraft:custom_name3.9. minecraft:damage_resistant3.10. minecraft:death_protection3.11. minecraft:enchantment_glint_override3.12. minecraft:enchantable3.13. minecraft:enchantments3.14. minecraft:equippable3.15. minecraft:food3.16. minecraft:glider3.17. minecraft:item_model3.18. minecraft:item_name3.19. minecraft:jukebox_playable3.20. minecraft:lore3.21. minecraft:max_damage3.22. minecraft:max_stack_size3.23. minecraft:provides_banner_patterns3.24. minecraft:provides_trim_material3.25. minecraft:rarity3.26. minecraft:repair_cost3.27. minecraft:tool3.28. minecraft:use_cooldown3.29. minecraft:use_remainder3.30. minecraft:tooltip_display3.31. minecraft:tooltip_style3.32. minecraft:weapon
4. 내구도가 있는 모든 아이템
4.1. minecraft:damage4.2. minecraft:repairable4.3. minecraft:unbreakable
5. 모든 블록
5.1. minecraft:block_entity_data5.2. minecraft:block_state5.3. minecraft:can_place_on5.4. minecraft:lock5.5. 벌통 전용
5.5.1. minecraft:bees
5.6. 상자류(상자, 발사기 등) 전용
5.6.1. minecraft:container_loot5.6.2. minecraft:container
6. 현수막, 방패 전용
6.1. minecraft:banner_patterns
7. 방패 전용
7.1. minecraft:base_color
8. 양동이 전용
8.1. minecraft:bucket_entity_data
9. 갑옷 전용
9.1. minecraft:trim
10. 쇠뇌 전용
10.1. minecraft:charged_projectiles10.2. minecraft:intangible_projectile
11. 꾸러미 전용
11.1. minecraft:bundle_contents
12. 디버그 막대기 전용
12.1. minecraft:debug_stick_state
13. 염색이 가능한 아이템 전용
13.1. minecraft:dyed_color
14. 생성 알 전용
14.1. minecraft:entity_data
15. 폭죽 탄약 전용
15.1. minecraft:firework_explosion
16. 폭죽 전용
16.1. minecraft:fireworks
17. 염소 뿔 전용
17.1. minecraft:instrument
18. 나침반 전용
18.1. minecraft:lodestone_tracker
19. 지도 전용
19.1. minecraft:map_color19.2. minecraft:map_decorations19.3. minecraft:map_id
20. 불길한 병 전용
20.1. minecraft:ominous_bottle_amplifier
21. 도자기 전용
21.1. minecraft:pot_decorations
22. 물약 전용
22.1. minecraft:potion_contents22.2. minecraft:potion_duration_scale
23. 플레이어 머리 전용
23.1. minecraft:note_block_sound23.2. minecraft:profile
24. 지식의 책 전용
24.1. minecraft:recipes
25. 마법이 부여된 책 전용
25.1. minecraft:stored_enchantments
26. 수상한 스튜 전용
26.1. minecraft:suspicious_stew_effects
27. 책과 깃펜 전용
27.1. minecraft:writable_book_content
28. 쓰여진 책 전용
28.1. minecraft:written_book_content
29. 내부적으로만 쓰이는 components
29.1. minecraft:creative_slot_lock29.2. minecraft:map_post_processing
30. 임시로 추가된 components

1. 개요

아이템 관련 구성 요소이다. 아이템을 들고 /data get entity @s SelectedItem 명령어를 사용하면 현재 들고 있는 아이템의 정보를 확인 가능하다.

아이템 기본 구성 요소는 여기에서 찾을 수 있다. 참고: 최신 스냅샷 버전(작성 당시 25w36a) 기준이라 최신 릴리즈 버전(작성 당시 1.21.8)과 맞지 않을 수 있다.

NBT를 구성요소로 변경하는 사이트가 있다. #1 #2

2. 모든 상위 태그

파일:nbtFileIcon.svg
모든 상위 태그

2.1. count

<colbgcolor=#40CFFF> count
{count:값}
<colcolor=#000> 기능 아이템 갯수를 지정한다.
사용 대상 아이템
기본값 1
관련 NBT 태그 -
유형
아이템의 갯수를 정한다. 최대 max_stack_size의 값까지 가능하며. 0개 이하이면 공기(=아이템 제거)로 처리되어 아이템이 삭제된다.

2.2. id

<colbgcolor=#40CFFF> id
{id:"문자열"}
<colcolor=#000> 기능 아이템 ID를 지정한다.
사용 대상 아이템
기본값 minecraft:air
관련 NBT 태그 -
유형
아이템 ID를 정한다. 아이템 ID는 F3+H를 눌러 확인할 수 있다.

2.3. Slot

<colbgcolor=#40CFFF> Slot
{Slot:값b}
<colcolor=#000> 기능 아이템 슬롯 위치를 지정한다.
사용 대상 인벤토리에 있는 모든 아이템
기본값 -
관련 NBT 태그 -
유형

2.4. components

<colbgcolor=#40CFFF> components
{components:{추가_문장}}
<colcolor=#000> 기능 아이템 세부 정보(구성 요소)
사용 대상 아이템
기본값 (아이템마다 다름)
관련 NBT 태그 -
유형

아이템 세부 정보(구성 요소)를 정한다. 아래 서술된 모든 구성 요소는 이 components의 하위 NBT이다.

3. 모든 아이템

아이템 구성 요소를 지정할 때 아이템은 다음 명령어와 같이 지정한다. 예: give @p 아이템_이름[이름1=값1,이름2=값2, ...]. 기본 구성 요소를 삭제하려면 [!이름]과 같이 입력한다. 값은 넣지 않는다. give @p 아이템_이름[!이름1,!이름2, ...]

3.1. minecraft:attribute_modifiers

<colbgcolor=#40CFFF> minecraft:attribute_modifiers
[minecraft:attribute_modifiers=[{추가 문장},{추가 문장 2}, ...]]
<colcolor=#000> 기능 아이템에 특성을 부여한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
아이템을 착용 및 보유하고 있는 개체의 특성에 영향을 주는 수정자를 부여한다.
파일:nbtFileIcon.svg
attribute_modifiers Components
  • "minecraft:attribute_modifiers" <
    >
    • (하나당 특성) < >
      • type <
        > - 특성 ID.
      • id <
        > - 특성 수정자의 고유 식별자.
      • slot <
        > - 이 수정자가 적용되려면 어느 슬롯에 넣어야 할지 결정한다. any, hand, armor, mainhand, offhand, head, chest, legs, feet, saddle 중 하나.
      • operation <
        > - 이 수정자의 계산 방식. add_value(덧셈), add_multiplied_base(기본값 기준 곱셈), add_multiplied_total(곱연산) 중 하나.
      • amount <
        > - 값.
      • display < > - 특성 수정자를 표시한다.
        • type <
          > - 다음 3가지만 허용된다.
          • default(기본값): 도구 설명에 계산된 특성 수정자 값을 표시한다.
          • hidden: 특성 수정자를 표시하지 않는다.
          • override: 특성 수정자의 표시를 value에 따라 수정한다.
        • (만약 type이 override일 경우...)'
예: 공격력 10 추가 네더라이트 검: give @s minecraft:netherite_sword[minecraft:attribute_modifiers=[{"type":"minecraft:attack_damage","amount":10.0,"id":"minecraft:base_attack_damage","operation":"add_value","slot":"mainhand"},{"type":"minecraft:attack_speed","amount":-2.4000000953674316,"id":"minecraft:base_attack_speed","operation":"add_value","slot":"mainhand"}]]

3.2. minecraft:blocks_attacks

<colbgcolor=#40CFFF> minecraft:blocks_attacks
[minecraft:blocks_attacks={...}]
<colcolor=#000> 기능 방패처럼 사용할 수 있고, (특정 유형의) 공격 피해를 감소한다.
사용 대상 아이템
기본값 [방패_기본값]. 그 외에는 (비어있음).
관련 구성 요소 -
유형
만약 있을경우 아이템 사용 키(기본값 오른쪽 클릭)로 막을 수 있으며, 방어 성공 시 사용자에게 받는 피해를 감소시킨다.
파일:nbtFileIcon.svg
blocks_attacks Components
  • "minecraft:blocks_attacks" < >
    • block_delay_seconds <
      > - (선택사항) 아이템을 들어올릴 때 지연 시간(초) (기본 0초)
    • disable_cooldown_scale <
      > - (선택사항) 막는 중일 때 무력화 공격(도끼 사용 등)이 발생 시 해당 아이템의 무력화 쿨타임을 곱한다. 0으로 설정 시 무력화 공격을 해도 이 아이템이 무력화되지 않는다. (기본 1.0)
    • damage_reductions <
      > - (선택사항) 주어진 공격에서 얼마나 많은 피해를 막아야 하는지 제어한다.
      • 피해 감소 필드 < >
        • type <

          > - (선택사항) 적용할 피해 유형. 태그(#) 형식도 가능하다. 비어있다면 모든 피해 유형이다.
        • base <
          > - (선택사항) 막을 피해량. (기본 0.0)
        • factor<
          > - (선택사항) 받는 피해 감소 비율. 1이 100%이다. (기본 1.0)
        • horizontal_blocking_angle<
          > - (선택사항) 사용자의 전방 n도만큼 해당 방향에서 오는 공격을 막아낸다. (기본 90.0)
    • item_damage < > - 주어진 공격에서 해당 아이템이 얼마나 많은 손상을 입힐지 제어한다.
      • threshold <
        > - (선택사항)
      • base <
        > - (선택사항)
      • factor<
        > - (선택사항)
    • block_sound <
      > - (선택사항) 성공적으로 방어에 성공했을 때 재생되는 소리 ID. (기본 (비어있음))
    • bypassed_by <
      > - (선택사항) 방패를 무시할 피해 유형. 기본값은 (비어있음)
    • disable_sound <
      > - (선택사항) 무력화 공격으로 인해 아이템이 쿨타임 상태에 빠지게 될 때 재생되는 소리 ID. (기본 (비어있음))
1.8.9 시절 다이아몬드 검 막기: give @s diamond_sword[blocks_attacks={disable_cooldown_scale:0,damage_reductions:[{base:0,factor:0.5}]}]

3.3. minecraft:break_sound

<colbgcolor=#40CFFF> minecraft:break_sound
[minecraft:break_sound='문자열']
<colcolor=#000> 기능 내구도가 0이되어 아이템이 파괴될때 나오는 소리를 지정한다.
사용 대상 아이템
기본값 방패: minecraft:item.shield.break
늑대 갑옷: minecraft:item.wolf_armor.break
그 외: minecraft:entity.item.break
관련 구성 요소 -
유형
있을 경우 아이템의 내구도가 0이 되어 파손될 때 지정한 소리를 재생한다.

3.4. minecraft:can_break

<colbgcolor=#40CFFF> minecraft:can_break
[minecraft:can_break=[{blocks:"블록ID"},{blocks:"블록ID"},...]]
<colcolor=#000> 기능 모험 모드에서 이 구성 요소가 포함된 아이템을 들었을 때 어떤 블록을 부술 수 있는지 지정한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 minecraft:can_place_on
유형
파일:nbtFileIcon.svg
can_break Components
  • "minecraft:can_break" <
    >
    • blocks <
      > - 상호 작용이 가능한 블록 ID.
      • "블록 1"
      • "블록 2"
      • ...
모험 모드에서 부술 수 있는 블록을 지정한다.

3.5. minecraft:consumable

<colbgcolor=#40CFFF> minecraft:consumable
[minecraft:consumable={consume_seconds:초,...}]
<colcolor=#000> 기능 아이템 소모 여부
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 food, use_remainder, use_cooldown, ominous_bottle_amplifier, potion_contents, suspicious_stew_effects
유형
이것이 있다면 해당 아이템은 소모될 수 있다. 다른 구성 요소와 연계가 가능하다.
파일:nbtFileIcon.svg
consumable Components
  • minecraft:consumable < >
    • consume_seconds <
      > - 소모되는데 걸리는 시간(초) (기본값 1.6)
    • animation <
      > - 아이템 사용 시 재생할 애니메이션. 다음 값만 허용된다. eat(기본값), none, drink, block, bow, spear, crossbow, spyglass, toot_horn, brush
    • sound <
      > - 아이템 사용 중일 때 나는 소리 ID. 기본값 minecraft:entity.generic.eat
      • sound_id<
        > - 소리 ID.
      • range<
        > - (선택사항) 소리 고정 범위. 생략시 범위가 가변적이다.
    • has_consume_particles <
      > - 이 아이템을 소비할 때 입자가 방출될지 여부. (기본값 true)
    • on_consume_effects <
      > - (선택사항) 아이템 사용 후 상태 효과.
        • type <
          > - 효과의 종류. 다음 값만 허용된다. apply_effects, remove_effects, clear_all_effects, teleport_randomly, play_sound.
        • 만약 type이 apply_effects일 경우...
          • effects < > - 사용 후 상태 효과 목록.
          • probability <
            > - 사용 후 상태 효과에 걸릴 확률. 기본값은 1.0(100%).
        • 만약 type이 remove_effects일 경우...
          • effects <

            > - 사용 후 특정한 상태 효과가 제거된다.
        • 만약 type이 clear_all_effects일 경우... 사용 후 모든 상태 효과를 제거한다.
        • 만약 type이 teleport_randomly일 경우...
          • diameter <
            > - 사용 후 무작위 위치로 순간이동하는 직경. 기본값은 16.0.
        • 만약 type이 play_sound일 경우...
          • sound <
            > 사용 후 소리를 재생할 소리ID.
            • sound_id<
              > - 소리 ID.
            • range<
              > - (선택사항) 소리 고정 범위. 생략시 범위가 가변적이다.

먹을 수 있는 흙: give @s minecraft:dirt[minecraft:consumable={}]
먹으면 90% 확률로 10초동안 독과 시듦이 걸리는 위더 장미: give @s minecraft:wither_rose[minecraft:consumable={"on_consume_effects":[{"type":"minecraft:apply_effects","effects":[{"amplifier":0,"duration":200,"id":"minecraft:poison"},{"amplifier":0,"duration":200,"id":"minecraft:wither"}],"probability":0.9f}]}]
금 주괴를 먹는데 3초 걸리고, 사용 후 모든 상태 효과가 제거됨: /give @s gold_ingot[minecraft:consumable={"consume_seconds":3.0, "animation":'eat', "sound":'entity.generic.eat', "has_consume_particles":true, "on_consume_effects":[{type:'minecraft:clear_all_effects'}]}]

3.6. minecraft:custom_data

<colbgcolor=#40CFFF> minecraft:custom_data
[minecraft:custom_data={...}]
<colcolor=#000> 기능 사용자 지정 데이터를 저장한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 -
유형
이 아이템의 사용자 지정 데이터를 저장한다.

예시: give @p minecraft:stone[minecraft:custom_data={NamuBoolean:true, NamuByte:1b, NamuShort:32767s, NamuInt:2147483647, NamuLong:673l, NamuFloat:1.01f, NamuDouble:10.01d, NamuString:"나무위키", NamuList:[2015,4,17], WikiIntArray:[I;12,2], BOCompound:{"foo:bar":true}}]
파일:nbtFileIcon.svg
custom_data Components
  • "minecraft:custom_data" <
    >
    • 사용자_지정 <
      Unknown
      > - 사용자 지정
    • ...

3.7. minecraft:custom_model_data

<colbgcolor=#40CFFF> minecraft:custom_model_data
[minecraft:custom_model_data={"floats":[1.0f,0.0f,...],"flags":[true,false,...],"strings":["문자열","..."],"colors":[0x123456,...]}]
<colcolor=#000> 기능 아이템의 사용자 지정 모델을 정한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 minecraft:item_model
유형
파일:nbtFileIcon.svg
custom_model_data Components

3.8. minecraft:custom_name

<colbgcolor=#40CFFF> minecraft:custom_name
[minecraft:custom_name="이름"]
<colcolor=#000> 기능 아이템 이름을 지정한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 item_name, lore
유형

아이템의 이름을 정한다. SNBT 형식으로 써야 하며 작성 방법은 마인크래프트/명령어/텍스트 구성 요소 문서를 참고한다. 모루를 사용한 판정이므로 이름에 기울림꼴이 있다. 아이템이 기울림꼴 되는 것을 원하지 않는다면 item_name를 사용한다.

예시: give @p minecraft:stone[minecraft:custom_name=[{text:"나무",color:"#13ad65"},{text:"위키",color:"#00a495"}]]]

3.9. minecraft:damage_resistant

<colbgcolor=#40CFFF> minecraft:damage_resistant
[minecraft:damage_resistant={types:"문자열"}]
<colcolor=#000> 기능 개체 상태 아이템의 특정한 피해 무시 설정을 지정한다.
사용 대상 아이템
기본값 네더의 별의 경우 {types:"#minecraft:is_explosion"}
네더라이트의 경우 {types:"#minecraft:is_fire"}
그 외는(비어있음)
관련 구성 요소 -
유형
아이템 개체 상태의 특정 유형의 피해를 무시한다. 네더라이트처럼 아이템에 화염 면역이 되거나, 네더의 별의 폭발 면역이 가능하다.

3.10. minecraft:death_protection

<colbgcolor=#40CFFF> minecraft:death_protection
[minecraft:death_protection={}]
<colcolor=#000> 기능 개체 죽음으로부터 면역 여부를 설정한다.
사용 대상 아이템
기본값 [불사의_토템_기본값] 각주 참조. 그 외는 (비어있음).
관련 구성 요소 -
유형
이것이 있다면 손에 든 개체가 죽을 시 생명력 1로 설정하고 죽음을 무시한다.
파일:nbtFileIcon.svg
death_protection Components
  • minecraft:death_protection < >
    • death_effects <
      > - (선택사항) 아이템 사용 후 상태 효과. 자세한 내용은 minecraft:consumable에 있는 on_consume_effects와 같다.
예: 다이아몬드를 들고 죽을 시 즉시 최대 체력: give @s minecraft:diamond[minecraft:death_protection={"death_effects":[{"type":"minecraft:apply_effects","effects":[{"amplifier":16,"duration":2,"id":"minecraft:instant_health"}]}]}]

3.11. minecraft:enchantment_glint_override

<colbgcolor=#40CFFF> minecraft:enchantment_glint_override
[minecraft:enchantment_glint_override=값]
<colcolor=#000> 기능 마법 부여의 강제 반짝임 표시 여부를 설정한다.
사용 대상 아이템
기본값 네더의 별, 경험치 병, 쓰여진 책, 마법이 부여된 책, 마법이 부여된 황금 사과, 엔드 수정, 디버그 막대기, 자석석 나침반일 경우 true.
그외의 아이템은 (비어있음)
관련 구성 요소 -
유형
#minecraft:enchantments를 무시하고, 반짝임 표시를 할지 여부. true일 경우 항상 반짝이고, false의 경우 아이템이 마법이 부여돼도 반짝이지 않는다.

예: 마법이 부여되지 않은 '마법이 부여된 황금 사과' give @p minecraft:enchanted_golden_apple[minecraft:enchantment_glint_override=false]
예2: 마법이 부여된 '황금 사과' give @p minecraft:golden_apple[minecraft:enchantment_glint_override=true]

3.12. minecraft:enchantable

<colbgcolor=#40CFFF> minecraft:enchantable
[minecraft:enchantable={value:값}]
<colcolor=#000> 기능 마법 부여 가능 여부를 설정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
이것이 있다면 이 아이템은 마법 부여대에 마법 부여가 가능하며, 값이 높을수록 높은 등급의 마법 부여가 가능하다. 다만 막대기와 같이 사용 가능한 마법이 비어있다면 부여가 불가능하다.

예: 마법 부여가 불가능한 금 곡괭이: give @s golden_pickaxe[!minecraft:enchantable]
예2: 마법 부여가 가능한 겉날개: give @s elytra[enchantable={value:15}]

3.13. minecraft:enchantments

<colbgcolor=#40CFFF> minecraft:enchantments
[minecraft:enchantments={"마법부여ID":레벨,"마법부여ID":레벨, ...}]
<colcolor=#000> 기능 아이템에 마법 부여를 설정한다.
사용 대상 아이템
기본값 {}
관련 구성 요소 -
유형
마법 부여 정보를 정한다. 자세한 효과는 마인크래프트/마법 부여 문서 참조.

아래는 마법부여 아이디 목록이다. 모드, 데이터 팩으로 추가한 마법 부여는 enchant 명령어로 확인하거나, 마법이 부여된 책을 들고 data get entity @s SelectedItem.components."minecraft:stored_enchantments" 명령어를 입력한다. 마법 부여대, 모루, enchant 명령어로 부여할 수 없는 레벨의 마법 부여도 설정할 수 있다.
minecraft:protection 보호 minecraft:fire_aspect 발화 minecraft:impaling 찌르기
minecraft:fire_protection 화염으로부터 보호 minecraft:looting 약탈 minecraft:riptide 급류
minecraft:feather_falling 가벼운 착지 minecraft:sweeping_edge 휩쓸기 minecraft:channeling 집전
minecraft:blast_protection 폭발으로부터 보호 minecraft:efficiency 효율 minecraft:mending 수선
minecraft:projectile_protection 발사체로부터 보호 minecraft:vanishing_curse 소실 저주 minecraft:multishot 다중 발사
minecraft:respiration 호흡 minecraft:silk_touch 섬세한 손길 minecraft:piercing 관통
minecraft:aqua_affinity 친수성 minecraft:unbreaking 내구성 minecraft:quick_charge 빠른 장전
minecraft:thorns 가시 minecraft:fortune 행운 minecraft:soul_speed 영혼 가속
minecraft:depth_strider 물갈퀴 minecraft:power 힘 minecraft:swift_sneak 신속한 잠행
minecraft:frost_walker 차가운 걸음 minecraft:punch 밀어내기 minecraft:density 육중
minecraft:binding_curse 귀속 저주 minecraft:flame 화염 minecraft:breach 격파
minecraft:sharpness 날카로움 minecraft:infinity 무한 minecraft:wind_burst 돌풍
minecraft:smite 강타 minecraft:luck_of_the_sea 바다의 행운
minecraft:bane_of_arthropods 살충 minecraft:lure 미끼
minecraft:knockback 밀치기 minecraft:loyalty 충성
예: 날카로움 6, 내구성 4가 부여된 네더라이트 검 give @p minecraft:netherite_sword[minecraft:enchantments={"minecraft:sharpness":6,"minecraft:unbreaking":4}]

3.14. minecraft:equippable

<colbgcolor=#40CFFF> minecraft:equippable
[minecraft:equippable={"slot":"장착가능한슬롯", ...}]
<colcolor=#000> 기능 아이템 장착 가능 여부를 설정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
이것이 있다면 특정 슬롯에 장착이 가능하며, 장착 중인 모델을 수정한다.
파일:nbtFileIcon.svg
equippable Components
  • minecraft:consumable < >
    • slot <
      > - 장착 가능한 슬롯. 다음 값만 허용된다. head, chest, legs, feet, body, mainhand, offhand, saddle
    • equip_sound <
      > - (선택 사항) 아이템이 장착될 때 재생할 소리. 지정하지 않으면 기본 방어구 장착 사운드가 재생된다.
    • asset_id <
      > - (선택 사항) 장착 시 모델 네임스페이스 ID. 모델은 리소스 팩에서 정의된다. 지정하지 않으면 머리에 있을 때 아이템 자체로 렌더링이 된다.
    • allowed_entities <
      > - (선택 사항)
    • camera_overlay <
      > - (선택 사항) 아이템 장착 시 이미지 오버레이의 텍스처 네임스페이스 ID. 텍스처 네임스페이스 ID의 위치는 assets/<네임스페이스>/texture/<ID>에 있다. minecraft:misc/pumpkinblur(조각된 호박 기본값)는 assets/minecraft/textures/misc/pumpkinblur.png 이미지를 가져온다.
    • dispensable <
      > - (선택 사항) 발사기를 사용하여 아이템 장착 가능한지 여부. (기본값 true)
    • swappable <
      > - (선택 사항) 마우스 오른쪽 버튼을 클릭하여 해당 슬롯에 아이템을 장착할 수 있는지 여부.(기본값 true)
    • equip_on_interact <
      > - (선택 사항) 아이템 사용 키를 눌러 대상에게 입힐 수 있을지 여부. (기본값 true)
    • damage_on_hurt <
      > - (선택 사항) 착용한 개체가 피해를 입을 때 이 아이템이 손상되는지 여부. (기본값 true)
    • can_be_sheared <
      > - (선택 사항) true일 경우 조건이 충족되는 경우 마우스 오른쪽 버튼을 클릭하여 대상 몹에서 장착 가능 아이템을 제거할 수 있다. (기본값 false)
    • shearing_sound <
      > - (선택 사항) 장착 가능한 아이템을 가위로 깎을 때 재생되는 사운드 ID. (기본값 item.shears.snip)
예: 발에 장착이 가능한 네더라이트 주괴: give @s netherite_ingot[minecraft:equippable={"slot":"feet"}]

3.15. minecraft:food

<colbgcolor=#40CFFF> minecraft:food
[minecraft:food={nutrition:배고픔값,saturation:포만감값}]
<colcolor=#000> 기능 음식 정보를 설정한다.
사용 대상 아이템
기본값 (아이템 마다 다름)
관련 구성 요소 minecraft:consumable
유형
명령어를 설정하고 해당 아이템을 사용하면 허기와 포만감을 채울 수 있다.
파일:nbtFileIcon.svg
food Components
  • minecraft:food < > - 아이템의 음식을 정의한다.
    • nutrition <
      > - 먹으면 회복할 허기 수(1=반칸)
    • saturation <
      > - 먹으면 회복할 포만감 수
    • can_always_eat <
      > - true이면 배가 고프지 않아도 먹을 수 있다.(기본값 false)

먹을 수 있는 케이크: give @s minecraft:cake[minecraft:food={nutrition:2,saturation:0.4},minecraft:consumable={consume_seconds:0.8},minecraft:use_remainder={id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"1"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":1,"minecraft:max_damage":7,"minecraft:use_remainder":{id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"2"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":2,"minecraft:max_damage":7,"minecraft:use_remainder":{id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"3"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":3,"minecraft:max_damage":7,"minecraft:use_remainder":{id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"4"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":4,"minecraft:max_damage":7,"minecraft:use_remainder":{id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"5"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":5,"minecraft:max_damage":7,"minecraft:use_remainder":{id:"minecraft:cake",count:1,components:{"minecraft:block_state":{bites:"6"},"minecraft:food":{nutrition:2,saturation:0.4},"minecraft:consumable":{consume_seconds:0.8},"minecraft:damage":6,"minecraft:max_damage":7}} }} }} }} }} }}]

3.16. minecraft:glider

<colbgcolor=#40CFFF> minecraft:glider
[minecraft:glider={}]
<colcolor=#000> 기능 장착 시 활강 가능 여부를 설정한다.
사용 대상 아이템
기본값 겉날개의 경우 있음. 그 외는 (비어있음)
관련 구성 요소 -
유형
이것이 있다면 장착 시 겉날개와 같이 활강이 가능하다.

네더라이트 흉갑 + 겉날개: give @s minecraft:netherite_chestplate[minecraft:glider={}]

3.17. minecraft:item_model

<colbgcolor=#40CFFF> minecraft:item_model
[minecraft:item_model="모델명"]
<colcolor=#000> 기능 아이템 모델를 지정한다.
사용 대상 아이템
기본값 (아이템 id)[3]
관련 구성 요소 minecraft:custom_model_data
유형

아이템의 모델을 지정한다. 아이템 모델은 리소스 팩 assets/<namespace>/models/item/<id>에서 참조한다. 예: namespace:id

예: 네더의 별 모델을 가진 구운 토끼고기: give @s minecraft:cooked_rabbit[minecraft:item_model="minecraft:nether_star"]

3.18. minecraft:item_name

<colbgcolor=#40CFFF> minecraft:item_name
[minecraft:item_name="이름"]
<colcolor=#000> 기능 아이템 기본 이름을 지정한다.
사용 대상 아이템
기본값 {translate:"(item|block).(네임스페이스).(id)"} [4]
관련 구성 요소 custom_name, lore
유형

아이템의 기본 이름을 정한다. minecraft:custom_name과 달리 모루로 이름을 수정할 수 없으며, 기울림꼴이 나타나지 않는다. SNBT 형식으로 써야 하며 작성 방법은 마인크래프트/명령어/텍스트 구성 요소 문서를 참고한다. 만약 item_name와 custom_name이 동시에 있다면 custom_name이 출력된다.

예시: give @p minecraft:stone[minecraft:item_name=[{text:"나무",color:"#13ad65"},{text:"위키",color:"#00a495"}]] [item_name+lore]

3.19. minecraft:jukebox_playable

<colbgcolor=#40CFFF> minecraft:jukebox_playable
[minecraft:jukebox_playable="음악id"]
<colcolor=#000> 기능 주크박스에 재생 가능 여부를 지정한다.
사용 대상 아이템
기본값 (음반의 경우 각각 다름)
관련 구성 요소 -
유형
이 구성 요소가 있다면 해당 아이템은 주크박스에 재생할 수 있게 된다.
파일:nbtFileIcon.svg
jukebox_playable Components
  • "minecraft:jukebox_playable" <
    > - 음악 id. data/<namespace>/jukebox_song/<id>.json에서 정의된다. 바닐라 음악 id는 아래에 후술한다.
※ 공정 이용에 따라 모든 음악은 30초까지만 들을 수 있다. 11과 calm4.ogg은 예외.
음악 ID 음악 제목 - 작곡가 길이 듣기
minecraft:5 5 - Samuel Åberg 2:58
minecraft:11 11 - C418 1:11
minecraft:13 13 - C418 2:56
minecraft:blocks Block - C418 5:43
minecraft:cat Cat - C418 3:06
minecraft:chirp Chirp - C418 3:07
minecraft:creator Creator - Lena Raine 2:58
minecraft:creator_music_box Creator (Music Box) - Lena Raine 1:15
minecraft:far Far - C418 3:12
minecraft:lava_chicken Lava Chicken - Hyper Potions 2:14
minecraft:mall Mall - C418 3:18
minecraft:mellohi Mellohi - C418 1:38
minecraft:otherside Otherside - Lena Raine 3:16
minecraft:pigstep Pigstep - Lena Raine 2:29
minecraft:precipice Precipice - Aaron Cherof 4:59
minecraft:relic Relic - Aaron Cherof 3:38
minecraft:stal Stal - C418 2:32
minecraft:tears Tears - Amos Roddy 2:55
minecraft:wait Wait - C418 3:55
minecraft:ward Ward - C418 4:11

예: 명령 블록인데 Precipice - Aaron Cherof 음악 재생: give @s minecraft:command_block[minecraft:jukebox_playable='minecraft:precipice']

3.20. minecraft:lore

<colbgcolor=#40CFFF> minecraft:lore
[minecraft:lore=["첫번째 줄","두번째 줄", ...]]
<colcolor=#000> 기능 아이템의 설명.
사용 대상 아이템
기본값 []
관련 구성 요소 item_name, custom_name
유형
아이템의 설명을 정한다. 작성할땐 SNBT 형식으로 써야 하며 작성 방법은 마인크래프트/명령어/텍스트 구성 요소 문서를 참고한다. 최대 256줄까지 작성할 수 있다. 기본 스타일은 기울림꼴에 보라색이 나타난다. 각 Compound 블록을 리스트(대괄호)로 묶으면 한 줄이 된다.
파일:nbtFileIcon.svg
lore Components
예시: give @s minecraft:stoneminecraft:lore=[{text:"여러분이 가꾸어 나가는",color:"#ffffff",italic:false,extra:[{text:" 지식의 나무",color:"#00A495"}]},{text:"두번째 줄.",italic:false}][item_name+lore]

3.21. minecraft:max_damage

<colbgcolor=#40CFFF> minecraft:max_damage
[minecraft:max_damage=값]
<colcolor=#000> 기능 아이템 최대 내구도를 정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
이 아이템의 최대 내구도를 설정한다. 설정하지 않으면 내구도를 깎을 수 없다. 값은 양수여야 한다.

예: 내구도가 258인 금 곡괭이: give @p minecraft:golden_pickaxe[minecraft:max_damage=258]
예: 내구도가 없는 네더라이트 곡괭이: give @p minecraft:netherite_pickaxe[!minecraft:max_damage]

3.22. minecraft:max_stack_size

<colbgcolor=#40CFFF> minecraft:max_stack_size
[minecraft:max_stack_size=값]
<colcolor=#000> 기능 이 아이템의 최대 쌓기(스택)를 설정한다.
사용 대상 아이템
기본값 (대부분의 경우 64)
관련 구성 요소 -
유형
이 아이템의 최대 쌓기(스택)를 수정한다. 1부터 99까지 가능하다. 내구도가 있는 모든 아이템은 최대 1까지 설정 가능하다.

예: 7개까지 쌓을 수 있는 불사의 토템: give @p minecraft:totem_of_undying[minecraft:max_stack_size=7] 8

3.23. minecraft:provides_banner_patterns

<colbgcolor=#40CFFF> minecraft:provides_banner_patterns
[minecraft:provides_banner_patterns='문자열']
<colcolor=#000> 기능 현수막 무늬 슬롯 재료를 지정한다.
사용 대상 아이템
기본값 (???)
관련 구성 요소 -
유형
이것이 있을 경우, 이 아이템은 현수막 무늬 슬롯에 넣을 수 있으며 지정된 현수막 무늬 태그가 된다. # 접두사로 태그가 지정되어야한다.

예: /give @p minecraft:diamond[minecraft:provides_banner_patterns='#minecraft:pattern_item/globe']

3.24. minecraft:provides_trim_material

<colbgcolor=#40CFFF> minecraft:provides_trim_material
[minecraft:provides_trim_material='문자열']
<colcolor=#000> 기능 ???
사용 대상 아이템
기본값 (???)
관련 구성 요소 -
유형

3.25. minecraft:rarity

<colbgcolor=#40CFFF> minecraft:rarity
[minecraft:rarity="문자열"]
<colcolor=#000> 기능 아이템의 등급을 정한다.
사용 대상 아이템
기본값 (대부분의 경우 "common")
관련 구성 요소 -
유형
아이템의 이름 기본 색상을 정한다. common(흰색), uncommon(노란색), rare(하늘색), epic(보라색)만 넣을 수 있다.

3.26. minecraft:repair_cost

<colbgcolor=#40CFFF> minecraft:repair_cost
[minecraft:repair_cost=값]
<colcolor=#000> 기능 모루로 수리 및 결합할 때의 요구 레벨을 지정한다.
사용 대상 아이템
기본값 0
관련 구성 요소 -
유형
모루로 수리 및 결합할 때의 요구 레벨을 정한다.

예: 수리 비용이 32인 다이아몬드 흉갑. give @p minecraft:diamond_chestplate[minecraft:repair_cost=32]

3.27. minecraft:tool

<colbgcolor=#40CFFF> minecraft:tool
[minecraft:tool={추가문장}]
<colcolor=#000> 기능 아이템 도구 여부.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
만약 설정된다면 해당 아이템은 도구가 되며, 규칙(rule)에 따라 특정 블록(들)의 파괴 속도를 지정한다. 그 자체로는 내구도가 생기지 않으며, 내구도까지 구현하려면 minecraft:max_damage 구성 요소를 사용해야 한다.
파일:nbtFileIcon.svg
tool Components
  • minecraft:tool < > - 아이템의 도구를 정의한다.
    • default_mining_speed <
      > - 블록 파괴 속도를 조정한다. 기본값 1.0
    • damage_per_block <
      > - 블록을 부술 때마다 내구도의 값이 내려간다. 무조건 음수가 아닌 수여야 한다.
    • can_destroy_blocks_in_creative <
      > - 만약 false일 경우 이 아이템을 들고 크리에이티브 모드에서 블록을 파괴할 수 없다. 기본값은 true
    • rule <
      > - 특정 블록에 대해 규칙을 지정한다.
      • (규칙 하나) < >
        • blocks <

          > - 이 규칙을 적용할 블록 ID 및 태그
        • speed <
          > - (선택사항) 만약 있다면 default_mining_speed를 무시하고 블록 파괴 속도를 조정한다.
        • correct_for_drops <
          > - (선택사항) 이 블록이 맞다면 도구가 최적화된 도구로 파괴하는 데 적합한지 여부와 블록의 Loot Table에서 요구하는 경우 아이템을 얻는데 적합한지 여부를 재정의한다. 기본값은 false이다.

3.28. minecraft:use_cooldown

<colbgcolor=#40CFFF> minecraft:use_cooldown
[minecraft:use_cooldown={"seconds":초,"cooldown_group":"그룹명"}]
<colcolor=#000> 기능 아이템 사용 후 재사용 대기 시간을 지정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 minecraft:consumable
유형
이것이 있고 아이템 사용시 재사용 대기 시간이 생긴다. cooldown_group은 그룹명과 동일한 아이템의 재사용 대기 시간을 공유한다.

재사용 대기 시간이 없는 엔더 진주: give @s minecraft:ender_pearl[!minecraft:use_cooldown] 16

3.29. minecraft:use_remainder

<colbgcolor=#40CFFF> minecraft:use_remainder
[minecraft:use_remainder={"id":"아이템ID","count":개수}]
<colcolor=#000> 기능 아이템 사용 후 얻을 아이템을 지정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 minecraft:consumable
유형
이것이 있고 아이템 사용 시 특정 아이템을 얻는다. 스튜와 같이 그릇을 남고 싶은 상황에서 쓰인다.

돌 섭취시 조약돌 생성: give @s minecraft:stone[minecraft:use_remainder={id:"minecraft:cobblestone",count:1},minecraft:consumable={}]

3.30. minecraft:tooltip_display

<colbgcolor=#40CFFF> minecraft:tooltip_display
[minecraft:tooltip_display={hide_tooltip:논리값,hidden_components:["아이템구성요소","..."]}]
<colcolor=#000> 기능 툴팁을 숨김 여부를 제어한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 -
유형
특정한 아이템 구성 요소 툴팁을 표시하지 않는다.
파일:nbtFileIcon.svg
tooltip_display Components
  • "minecraft:tooltip_display" < >
    • hide_tooltip <
      > - (선택사항) true일 경우 툴팁을 완전히 숨긴다.(기본 false)
    • hidden_components <
      > - (선택사항) 숨길 아이템 구성 요소.
마법 부여 내용이 표시되지 않는 날카로움 I 마법이 부여된 다이아몬드 검: give @s minecraft:diamond_sword[tooltip_display={minecraft:hidden_components:["minecraft:enchantments"]},minecraft:enchantments={minecraft:sharpness:5}]
툴팁이 표시되지 않는 밀랍칠한 약간 녹슨 깎인 구리 반 블록: give @s minecraft:waxed_exposed_cut_copper_slab[minecraft:tooltip_display={hidden_components=true}]

3.31. minecraft:tooltip_style

<colbgcolor=#40CFFF> minecraft:tooltip_style
[minecraft:tooltip_style="문자열"]
<colcolor=#000> 기능 아이템 툴팁 스타일을 지정한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 -
유형
다음 리소스 팩 파일 가져와 툴팁 배경/테두리를 수정한다. 네임스페이스:경로 형식으로 작성한다.
assets\<네임스페이스>\texture\gui\sprites\tooltip\<경로>_background.png
assets\<네임스페이스>\texture\gui\sprites\tooltip\<경로>_frame.png

3.32. minecraft:weapon

<colbgcolor=#40CFFF> minecraft:weapon
[minecraft:weapon={item_damage_per_attack:값,disable_blocking_for_seconds=}]
<colcolor=#000> 기능 아이템 무기 취급 여부를 설정한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
있을 경우 이 아이템은 무기이며, 각 공격에 대해 '사용된 아이템' 통계가 증가한다.
파일:nbtFileIcon.svg
weapon Components
  • "minecraft:weapon" < >
    • item_damage_per_attack <
      > - (선택사항) 공격시 닳는 내구도.(기본 1)
    • disable_blocking_for_seconds <
      > - (선택사항) 공격 성공 시 방패가 n초동안 무력화된다. (기본 0)
내구도가 10이고 공격할때마다 1씩 닳는 막대기: give @s minecraft:stick[minecraft:weapon={},minecraft:max_damage=10]

4. 내구도가 있는 모든 아이템

4.1. minecraft:damage

<colbgcolor=#40CFFF> minecraft:damage
[minecraft:damage=값]
<colcolor=#000> 기능 아이템 내구도를 지정한다.
사용 대상 내구도가 있는 모든 아이템
기본값 0
관련 구성 요소 -
유형
아이템 내구도를 정한다. 한 번 쓰고 깨지게 하고 싶다면, 그 장비의 내구도와 똑같은 숫자를 입력해 주면 된다. 각 장비별 내구도 수치는 다음과 같다.
아이템 내구도 아이템 내구도 아이템 내구도
거북 등딱지 275 다이아몬드 투구 363 쇠뇌 465
가죽 모자 55 다이아몬드 흉갑 528 겉날개 432
가죽 조끼 80 다이아몬드 레깅스 495 당근 낚싯대 25
가죽 바지 75 다이아몬드 부츠 429 가위 238
가죽 장화 65 네더라이트 투구 407 부싯돌과 부시 64
Copper Helmet(향후 업데이트 예정) 121 네더라이트 흉갑 592 뒤틀린 균 낚싯대 100
Copper Chestplate(향후 업데이트 예정) 176 네더라이트 레깅스 555 늑대 갑옷 64
Copper Leggings(향후 업데이트 예정) 165 네더라이트 부츠 481 철퇴 500
Copper Boots(향후 업데이트 예정) 143 나무 도구 59 방패 336
철&사슬 투구 165 돌 도구 131 낚싯대 64
철&사슬 흉갑 240 구리 도구(향후 업데이트 예정) 190
철&사슬 레깅스 225 철 도구 250
철&사슬 부츠 195 금 도구 32
금 투구 77 다이아몬드 도구 1561
금 흉갑 112 네더라이트 도구 2031
금 레깅스 105 활 384
금 부츠 91 삼지창 250
1회용 네더라이트 검: give @p netherite_sword[minecraft:damage=2031]

4.2. minecraft:repairable

<colbgcolor=#40CFFF> minecraft:repairable
[minecraft:repairable={items:"아이템ID"}]
<colcolor=#000> 기능 이 아이템을 모루로 수리하는데 필요한 재료를 지정한다.
사용 대상 내구도가 있는 모든 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
이것이 있다면 이 아이템은 아이템ID로 모루로 수리가 가능하다. 또한 여러 아이템을 묶는 #태그 형식도 가능하다.

예: 네더라이트 검이 금 주괴로 수리가 가능함: give @s minecraft:netherite_sword[minecraft:repairable={items:"#minecraft:incorrect_for_gold_tool"}]
예2: 네더라이트 검이 금 주괴와 네더라이트 주괴로 수리가 가능함: give @s minecraft:netherite_sword[minecraft:repairable={items:["#minecraft:incorrect_for_gold_tool","#minecraft:netherite_tool_materials"]}]

4.3. minecraft:unbreakable

<colbgcolor=#40CFFF> minecraft:unbreakable
[minecraft:unbreakable={}]
<colcolor=#000> 기능 내구도 비소모 여부를 지정한다.
사용 대상 내구도가 있는 모든 아이템
기본값 (비어있음)
관련 구성 요소 -
유형
이 구성 요소가 있다면 해당 아이템은 더 이상 내구도가 소모되지 않는다. 아이템 툴팁에 "부서지지 않음"이 생긴다. 이것을 숨기려면 tooltip_display 구성 요소를 사용한다.

예시: 부서지지 않는 다이아몬드 검. give @p minecraft:diamond_sword[minecraft:unbreakable={}]

5. 모든 블록

블록이 아이템 상태일 때 붙는 태그다.

5.1. minecraft:block_entity_data

<colbgcolor=#40CFFF> minecraft:block_entity_data
[minecraft:block_entity_data={...}]
<colcolor=#000> 기능 블록 엔티티 NBT 정보를 지정한다.
사용 대상 블록으로 설치 가능한 아이템
기본값 (비어있음)
관련 구성 요소 -
유형

5.2. minecraft:block_state

<colbgcolor=#40CFFF> minecraft:block_state
[minecraft:block_state={...}]
<colcolor=#000> 기능 블록 상태 정보를 지정한다.
사용 대상 블록으로 설치 가능한 아이템
기본값 (비어있음)
관련 구성 요소 -
유형

5.3. minecraft:can_place_on

<colbgcolor=#40CFFF> minecraft:can_place_on
[minecraft:can_place_on=["블록ID_1","블록ID_2", ...]]
<colcolor=#000> 기능 모험 모드에서도 설치할 수 있는 블록을 지정한다.
사용 대상 블록으로 설치 가능한 아이템
기본값 (비어있음)
관련 구성 요소 minecraft:can_break
유형
해당 아이템이 모험 모드에서도 설치할 수 있는 블록을 지정한다.
파일:nbtFileIcon.svg
can_place_on Components
  • "minecraft:can_place_on" <
    > - 상호 작용이 가능한 블록 ID와 블록 태그.
    • "블록 1"
    • "블록 2"
    • ...
예시: 흙, 돌에만 설치가 가능한 다이아몬드 블록 give @p minecraft:diamond_block[minecraft:can_place_on=["minecraft:stone","minecraft:dirt"]]

5.4. minecraft:lock

<colbgcolor=#40CFFF> minecraft:lock
[minecraft:lock={데이터}]
<colcolor=#000> 기능 UI를 잠금 여부를 지정한다.
사용 대상 GUI 있는 블록
기본값 (비어있음)
관련 구성 요소 -
유형
GUI를 잠글 때 사용한다. 들고 있는 손에 올바른 데이터를 가지지 않고 상호작용하면 열리지 않는다.

예: [minecraft:custom_data={"namu":"wiki"}]를 가진 데이터가 있어야 열리는 상자: give @p minecraft:chest[minecraft:lock={components:{"minecraft:custom_data":{"namu":"wiki"} }}]

5.5. 벌통 전용

5.5.1. minecraft:bees

5.6. 상자류(상자, 발사기 등) 전용

5.6.1. minecraft:container_loot

<colbgcolor=#40CFFF> minecraft:container_loot
[minecraft:container_loot={loot_table:"루트_테이블",seed:시드L}]
<colcolor=#000> 기능 이 아이템 속에있는 전리품 테이블와 시드.
사용 대상 상자류
기본값 (비어있음)
관련 구성 요소 -
유형
상자를 열때 보상을 정한다. 명령어 loot spawn ~ ~ ~ loot뒤에 나오는 값이 전리품 테이블(Loot Table)이다.
파일:nbtFileIcon.svg
container_loot Components
  • "minecraft:container_loot" < >
    • loot_table <
      > - 전리품 테이블의 ID
    • seed <
      > - 시드. 값이 0이라면 랜덤한 값으로 변환된다. 작성하지 않으면 0(랜덤)으로 설정한다.
예: 전리품이 '엔드 시티에 있는 상자'인 상자 얻기: give @s minecraft:chest[minecraft:container_loot={loot_table:"minecraft:chests/end_city_treasure",seed:0L}]

5.6.2. minecraft:container

<colbgcolor=#40CFFF> minecraft:container
[minecraft:container=[{item:{...},slot:슬롯번호},{item:{...},slot:슬롯번호2}, ...]]
<colcolor=#000> 기능 상자류 블록의 내용물을 설정한다.
사용 대상 상자류
기본값 (비어있음)
관련 구성 요소 -
유형
상자류 블록의 내용물을 설정한다.
파일:nbtFileIcon.svg
container Components
예: 0번칸에 돌 3개, 1번칸에 흙 7개인 상자: /give @s chest[minecraft:container=[{item:{id:"minecraft:stone",count:3},slot:0}, {item:{id:"minecraft:dirt",count:7},slot:0}]]

6. 현수막, 방패 전용

6.1. minecraft:banner_patterns

7. 방패 전용

7.1. minecraft:base_color

<colbgcolor=#40CFFF> minecraft:base_color
[minecraft:base_color="문자열"]
<colcolor=#000> 기능 방패의 기본 색깔을 지정한다.
사용 대상 방패
기본값 (비어있음)
관련 구성 요소 -
유형
방패의 기본색을 지정한다. 지정하지 않으면 나무 재질의 방패이다.

예시: give @s minecraft:shield[minecraft:base_color="lime"]

8. 양동이 전용

8.1. minecraft:bucket_entity_data

<colbgcolor=#40CFFF> minecraft:bucket_entity_data
[minecraft:bucket_entity_data={NoAI:참과_거짓,Silent:참과_거짓,NoGravity:참과_거짓,Glowing:참과_거짓,Invulnerable:참과_거짓,Health:값f}]
<colcolor=#000> 기능 양동이에 담긴 엔티티의 NBT 정보를 지정한다.
사용 대상 XX이(가) 담긴 양동이
기본값 (비어있음)
관련 구성 요소 -
유형
양동이에 담긴 엔티티의 정보를 설정한다. 풀어줄 때 이 태그를 가진다.
파일:nbtFileIcon.svg
bucket_entity_data Components
  • "minecraft:bucket_entity_data" < > - 엔티티 NBT와 같지만 다음 태그만 가능하다.
    • NoAI <
      >
    • Silent <
      >
    • NoGravity <
      >
    • Glowing <
      >
    • Invulnerable <
      >
    • Health <
      >
    • Age <
      > - 아홀로틀 전용.
    • Variant <
      > - 아홀로틀 전용.
    • HuntingCooldown: <
      > - 아홀로틀 전용.
    • BucketVariantTag <
      > - 열대어 전용.

9. 갑옷 전용

9.1. minecraft:trim

10. 쇠뇌 전용

10.1. minecraft:charged_projectiles

<colbgcolor=#40CFFF> minecraft:charged_projectiles
[minecraft:charged_projectiles=[{id:"아이템ID"},{id:"아이템ID"}, ...]]
<colcolor=#000> 기능 장전된 쇠뇌의 발사체 정보를 지정한다.
사용 대상 쇠뇌
기본값 (비어있음)
관련 구성 요소 -
유형
장전된 쇠뇌의 발사체 정보를 지정한다. 이 구성 요소가 없다면 장전되지 않은 쇠뇌이다.
파일:nbtFileIcon.svg
charged_projectiles Components
  • "minecraft:charged_projectiles" <
    >
    • (발사체) < > - 발사체 하나
    • (발사체) < > - 발사체 하나
    • ...
예시: 장전된 화살이 8개인 쇠뇌(1회용): give @p minecraft:crossbow[minecraft:charged_projectiles=[{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"},{id:"minecraft:arrow"}]]

10.2. minecraft:intangible_projectile

<colbgcolor=#40CFFF> minecraft:intangible_projectile
[minecraft:intangible_projectile={}]
<colcolor=#000> 기능 투사체 아이템 회수 불가능 여부를 지정한다.
사용 대상 쇠뇌
기본값 (비어있음)
관련 구성 요소 -
유형
만약 있다면 투사체 아이템(화살 등)은 주울 수 없다.(크리에이티브 제외)

11. 꾸러미 전용

11.1. minecraft:bundle_contents

<colbgcolor=#40CFFF> minecraft:bundle_contents
[minecraft:bundle_contents=[{아이템}, ...]]
<colcolor=#000> 기능 꾸러미에 저장된 아이템의 정보를 설정한다.
사용 대상 꾸러미
기본값 []
관련 구성 요소 -
유형
파일:nbtFileIcon.svg
bundle_contents Components
예: 다이아몬드 2개, 흙 4개가 들어있는 꾸러미: /give @s bundle[minecraft:bundle_contents=[{id:"minecraft:diamond",count:2}, {id:"minecraft:dirt",count:4}]]

12. 디버그 막대기 전용

12.1. minecraft:debug_stick_state

13. 염색이 가능한 아이템 전용

13.1. minecraft:dyed_color

<colbgcolor=#40CFFF> minecraft:dyed_color
[minecraft:dyed_color=값]
<colcolor=#000> 기능 아이템의 색을 지정한다.
사용 대상 염색이 가능한 아이템
기본값 (비어있음)
관련 구성 요소 -
유형

색을 정할 수 있다. 예: 0xFF00FF

16777215를 초과한 수치를 넣었을 때, 기본색으로 변경한다,

14. 생성 알 전용

14.1. minecraft:entity_data

<colbgcolor=#40CFFF> minecraft:entity_data
[minecraft:entity_data={...}]
<colcolor=#000> 기능 생성 알의 생성되는 개체 정보를 설정한다.
사용 대상 생성 알
기본값 (비어있음)
관련 구성 요소 -
유형
생성 알의 개체 정보를 지정한다.
파일:nbtFileIcon.svg
entity_data Components

15. 폭죽 탄약 전용

15.1. minecraft:firework_explosion

16. 폭죽 전용

16.1. minecraft:fireworks

17. 염소 뿔 전용

17.1. minecraft:instrument

<colbgcolor=#40CFFF> minecraft:instrument
[minecraft:instrument="ID"]
<colcolor=#000> 기능 염소 뿔을 불었을 때 재생되는 음악을 지정한다.
사용 대상 염소 뿔
기본값 ?
관련 구성 요소 -
유형
염소 뿔을 불었을 때 재생되는 음악을 지정한다. 음악은 data/<namespace>/instrument/<id>.json에서 정의된다. 바닐라의 경우는 다음과 같다.
음악 ID
동경(Admire) minecraft:admire_goat_horn
소집(Call) minecraft:call_goat_horn
꿈결(Dream) minecraft:dream_goat_horn
감각(Feel) minecraft:feel_goat_horn
고민(Ponder) minecraft:ponder_goat_horn
수색(Seek) minecraft:seek_goat_horn
노래(Sing) minecraft:sing_goat_horn
갈망(Yearn) minecraft:yearn_goat_horn

18. 나침반 전용

18.1. minecraft:lodestone_tracker

<colbgcolor=#40CFFF> minecraft:lodestone_tracker
[minecraft:lodestone_tracker={target:{pos:[I; X,Y,Z],dimension:"차원ID"},tracked:값b}]
<colcolor=#000> 기능 나침반의 자석석 위치 정보를 지정한다.
사용 대상 나침반
기본값 (비어있음)
관련 구성 요소 -
유형
자석석 나침반이 가리켜야 하는 자석석 위치 정보를 저장한다.

tracked의 값이 true일 경우 가리키는 좌표에 자석석이 파괴되면 무작위로 움직인다. false일 경우 해당 좌표에 자석석이 파괴되도 유지된다.

예: 나침반이 오버월드 X=100, Y=123, Z=-333로 가리키기: give @p minecraft:compass[minecraft:lodestone_tracker={target:{pos:[I;100,123,-333],dimension:"minecraft:overworld"},tracked:0b}]

19. 지도 전용

19.1. minecraft:map_color

<colbgcolor=#40CFFF> minecraft:map_color
[minecraft:map_id=값]
<colcolor=#000> 기능 지도의 색을 설정한다.
사용 대상 지도
기본값 (비어있음)
관련 구성 요소 -
유형
지도의 색을 정한다. 예: 0xFF00FF

19.2. minecraft:map_decorations

19.3. minecraft:map_id

<colbgcolor=#40CFFF> minecraft:map_id
[minecraft:map_id=값]
<colcolor=#000> 기능 지도의 ID를 설정한다.
사용 대상 지도
기본값 (비어있음)
관련 구성 요소 -
유형
지도의 ID를 정한다.

20. 불길한 병 전용

20.1. minecraft:ominous_bottle_amplifier

<colbgcolor=#40CFFF> minecraft:ominous_bottle_amplifier
[minecraft:ominous_bottle_amplifier=값]
<colcolor=#000> 기능 불길한 병 등급을 지정한다.
사용 대상 불길한 병
기본값 0
관련 구성 요소 -
유형
불길한 병의 흉조 효과의 증폭량. 0 ~ 4 사이의 정수만 가능하다.

21. 도자기 전용

21.1. minecraft:pot_decorations

22. 물약 전용

일반, 투척용, 잔류형도 포함된다.

22.1. minecraft:potion_contents

<colbgcolor=#40CFFF> minecraft:potion_contents
[minecraft:potion_contents={potion:"문자열",custom_color:색상,custom_effects:[{물약 정보 1},{물약 정보 2}, ...]}]
<colcolor=#000> 기능 물약의 정보를 지정한다.
사용 대상 물약
기본값 ?
관련 구성 요소 -
유형
물약의 정보를 정한다.
파일:nbtFileIcon.svg
potion_contents Components
  • "minecraft:potion_contents" < >
    • potion <
      > - (선택사항)
    • custom_color <
      > - 물약이 표시되는 색깔. 예: 0xFF00FF
    • custom_effects <
      > - 속성의 정보.
      • (상태 효과 하나) < >
        • id <
          > - 상태 효과 ID. 자세한 내용은 마인크래프트/상태 효과 문서 참고.
        • amplifier <
          > - (선택사항) 상태 효과 증폭값. 기본값은 0.
        • duration <
          > - (선택사항) 지속 시간(틱). 기본값은 1.
        • ambient <
          > - (선택사항) 신호기 효과 여부. 기본값은 false
        • show_particles <
          > - (선택사항) 입자가 방출되는지 여부. 기본값은 true
        • show_icon <
          > - (선택사항) 아이콘이 표시되는지 여부. 기본값은 true
예시: 색이 #FF0000, 속도 증가 20초, 저항 4 3초, 화염 저항 30초인 물약: give @s minecraft:potion[minecraft:potion_contents={custom_color:0xff0000,custom_effects:[{id:"minecraft:speed",duration:400},{id:"minecraft:resistance",amplifier:3,duration:60},{id:"minecraft:fire_resistance",duration:600}]}]

22.2. minecraft:potion_duration_scale

<colbgcolor=#40CFFF> minecraft:potion_duration_scale
[minecraft:potion_duration_scale=값]
<colcolor=#000> 기능 물약의 지속 시간 계수를 설정한다.
사용 대상 아이템
기본값 잔류형 물약은 0.25
물약이 묻은 화살은 0.125
그 외는 1.0
관련 구성 요소 -
유형
있을 경우 물약의 지속 시간을 곱한다. potion_contents 구성 요소의 custom_effects도 영향 받는다. 지정하지 않으면 1.0으로 설정한다.

23. 플레이어 머리 전용

23.1. minecraft:note_block_sound

<colbgcolor=#40CFFF> minecraft:note_block_sound
[minecraft:note_block_sound="소리ID"]
<colcolor=#000> 기능 플레이어 머리 아래의 소리 블록에서 재생되는 소리를 지정한다.
사용 대상 소리 블록
기본값 (비어있음)
관련 구성 요소 -
유형
플레이어 머리 아래에 소리 블록이 레드스톤 신호를 받으면 그 소리를 재생한다. playsound 뒤에 나올 값을 정하면 된다.

예: give @s minecraft:player_head[minecraft:note_block_sound="minecraft:item.trident.thunder"]

23.2. minecraft:profile

<colbgcolor=#40CFFF> minecraft:profile
[minecraft:profile="플레이어 이름"]
<colcolor=#000> 기능 플레이어 머리의 정보를 지정한다.
사용 대상 플레이어 머리
기본값 (비어있음)
관련 구성 요소 -
유형
플레이어 머리의 정보를 설정한다.
파일:nbtFileIcon.svg
profile Components
  • "minecraft:profile" < >
    으로 쓸 경우 데이터가 자동으로 불러와진다.
    • name <
      > - 플레이어 이름.
    • id <
      > - (선택사항) 플레이어 머리의 UUID.
    • properties <
      >
        • name <
          > - textures만 가능하다.
        • signature <
          > - (선택사항) 서명.
        • value <
          > - 플레이어 머리 데이터. base64로 인코딩되었다. 디코딩 하면 다음 내용이 출력한다.
          {{{#!folding [ 펼치기 · 접기 ]
    • timestamp <
      > - (선택사항) 텍스처에 접근한 유닉스 시간 밀리초.
    • profileId <
      > - (선택사항) -가 없는 플레이어 UUID.
    • profileName <
      > - (선택사항) 플레이어 이름.
    • textures < > - 텍스처.
      • SKIN < > - 스킨 텍스처. 현재 장착중인 커스텀 스킨이 없다면 비어있다.
        • url <
          > - 플레이어 커스텀 스킨의 URL 링크.
        • metadata < > - (선택사항) 스킨의 메타데이터.
          • model <
            > - (선택사항) slim(Alex) 모델일 경우 slim. Steve 모델은 비어있다.
      • CAPE < > - (선택사항) 망토 텍스처. 현재 망토가 장착하지 않았다면 비어있다.
        • url <
          > - 망토 URL 링크.}}}
    • texture(향후 업데이트 예정) <
      > - 렌더링에 사용할 스킨 텍스처의 선택적 네임스페이스 ID. 예시: entity/player/wide/steve
    • cape(향후 업데이트 예정) <
      > - 렌더링에 사용할 망토 텍스처의 선택적 네임스페이스 ID.
    • elytra(향후 업데이트 예정) <
      > - 렌더링에 사용할 겉날개 텍스처의 선택적 네임스페이스 ID.
    • model(향후 업데이트 예정) <
      > - 모델 유형. wide와 slim만 가능하다.
예: 이름이 jeb_인 플레이어 머리 소환: give @p minecraft:player_head[minecraft:profile="jeb_"]

24. 지식의 책 전용

24.1. minecraft:recipes

<colbgcolor=#40CFFF> minecraft:recipes
[minecraft:recipes=["아이템ID","아이템ID", ...]]
<colcolor=#000> 기능 지식의 책 사용시 잠금 해제할 제작법을 설정한다.
사용 대상 지식의 책
기본값 (비어있음)
관련 구성 요소 -
유형
지식의 책 사용시 잠금 해제할 제작법을 정한다.

예: 참나무 계단, 참나무 반 블록의 제작법을 잠금 해제: give @p minecraft:knowledge_book[minecraft:recipes=["minecraft:oak_slab","minecraft:oak_stairs"]]

25. 마법이 부여된 책 전용

25.1. minecraft:stored_enchantments

<colbgcolor=#40CFFF> minecraft:stored_enchantments
[minecraft:stored_enchantments={"마법부여ID":레벨,"마법부여ID":레벨, ...}]
<colcolor=#000> 기능 마법 부여의 저장 정보를 정한다.
사용 대상 마법이 부여된 책
기본값 (비어있음)
관련 구성 요소 -
유형
마법 부여의 저장 정보. 세부 사항은 minecraft:enchantments와 같다.

26. 수상한 스튜 전용

26.1. minecraft:suspicious_stew_effects

<colbgcolor=#40CFFF> minecraft:suspicious_stew_effects
[minecraft:suspicious_stew_effects=[{id:"상태효과ID",duration:지속시간}, ...]]
<colcolor=#000> 기능 수상한 스튜의 정보를 정한다.
사용 대상 수상한 스튜
기본값 []
관련 구성 요소 -
유형
수상한 스튜의 상태 효과를 지정한다. duration을 생략하면 160(8초)로 설정한다.

27. 책과 깃펜 전용

27.1. minecraft:writable_book_content

<colbgcolor=#40CFFF> minecraft:writable_book_content
[minecraft:writable_book_content={pages:["1페이지","2페이지", ...]}]
<colcolor=#000> 기능 책과 깃펜의 내용을 설정한다.
사용 대상 책과 깃펜
기본값 (비어있음)
관련 구성 요소 -
유형
책과 깃펜의 내용을 변경한다.
파일:nbtFileIcon.svg
writable_book_content Components

28. 쓰여진 책 전용

28.1. minecraft:written_book_content

<colbgcolor=#40CFFF> minecraft:written_book_content
[minecraft:written_book_content={pages:["1페이지","2페이지", ...],title:"제목",author:"저자이름",generation:값}]
<colcolor=#000> 기능 쓰여진 책의 내용을 설정한다.
사용 대상 쓰여진 책
기본값 (비어있음)
관련 구성 요소 -
유형
쓰여진 책의 저자, 내용, 제목, 상태를 변경한다.
파일:nbtFileIcon.svg
written_book_content Components
  • "minecraft:written_book_content" < >
    • title < > - 쓰여진 책의 제목.
    • pages <
      > - 쓰여진 책의 내용.
    • author <
      > - 저자이름.
    • generation <
      > - 아이템 복제 횟수. 0은 원본, 1은 원본의 복사본, 2는 복사본의 복사본, 3은 낡음이다.
    • resolved: <
      > - (선택사항) 이 책의 텍스트 구성 요소가 이미 해결된 경우(대상 선택, 점수 등) true. false인 경우 플레이어가 열면 해결된다.
예시: written_book_content={pages:['"Hello world!"'],title:{raw:'"A delightful read"'},author:'Herobrine',generation:1,resolved:true}

29. 내부적으로만 쓰이는 components

명령어, /data 등으로 얻을 수 없고 내부적으로 사용된다.

29.1. minecraft:creative_slot_lock

만약 설정하면 크리에이티브 플레이어가 해당 아이템을 꺼낼수 없다.

단축 바 저장에 있는 종이 아이템에 사용된다.

29.2. minecraft:map_post_processing

알 수 없음.

지도 제작대를 사용할 때 결과 칸에서 사용한다.

30. 임시로 추가된 components

해당 components는 만우절 버전(24w14potato)에 등장한 components이다.

minecraft:clicks
이것이 있다면 아이템을 마우스로 올려둘 때마다(즉 아이템을 커서 잡을 때) 값이 증가한다.

minecraft:hovered
이것이 있다면 아이템을 마우스에 갖다댈 때 모델을 변경한다.

minecraft:lubrication
개체 상태의 아이템 마찰력을 조정한다.

minecraft:views
이것이 있다면 아이템을 볼 때마다(즉. 상자를 열어서 아이템을 보는 것 등) 값이 증가한다.
[방패_기본값] {"block_delay_seconds":0.25,"block_sound":"minecraft:item.shield.block","bypassed_by":"#minecraft:bypasses_shield","disabled_sound":"minecraft:item.shield.break","item_damage":{"base":1.0,"factor":1.0,"threshold":3.0} [불사의_토템_기본값] {"death_effects":[{"type":"minecraft:clear_all_effects"},{"type":"minecraft:apply_effects","effects":[{"amplifier":1,"duration":900,"id":"minecraft:regeneration","show_icon":true},{"amplifier":1,"duration":100,"id":"minecraft:absorption","show_icon":true},{"duration":800,"id":"minecraft:fire_resistance","show_icon":true}]}]} [3] 아이템 id가 minecraft:diamond라면 기본값도 minecraft:diamond가 된다.[4] minecraft:stone을 예를 들자면 minecraft는 네임스페이스, stone은 id이다. 또한 블록으로 설치가 가능하다. 따라서 minecraft:stone의 기본 값은 {translate:"block.minecraft.stone"} [item_name+lore] item_name과 lore을 같이 쓸 경우: give @p 아이템_이름[minecraft:item_name=[{text:"나무",color:"#13ad65"},{text:"위키",color:"#00a495"}]",minecraft:lore=[{text:"여러분이 가꾸어 나가는",color:"#ffffff",italic:false,extra:[{text:" 지식의 나무",color:"#00A495"}]},{text:"두번째 줄.",italic:false}]][item_name+lore]

분류