최근 수정 시각 : 2024-09-22 17:24:49

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

마인크래프트/NBT/아이템에서 넘어옴

파일:상위 문서 아이콘.svg   상위 문서: 마인크래프트/아이템
※ JE의 최신버전인 1.21.1 기준이며, 상하위 버전에 맞지 않는 구성 요소가 있을 수 있습니다.
파일:마인크래프트 로고.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:can_break3.3. minecraft:custom_data3.4. minecraft:custom_model_data3.5. minecraft:custom_name3.6. minecraft:enchantment_glint_override3.7. minecraft:enchantments3.8. minecraft:fire_resistant3.9. minecraft:food3.10. minecraft:hide_tooltip3.11. minecraft:item_name3.12. minecraft:jukebox_playable3.13. minecraft:lore3.14. minecraft:max_stack_size3.15. minecraft:rarity3.16. minecraft:repair_cost3.17. minecraft:tool
4. 내구도가 있는 모든 아이템
4.1. minecraft:damage4.2. minecraft:max_damage4.3. minecraft:unbreakable4.4. 갑옷 전용
4.4.1. minecraft:trim
4.5. 쇠뇌 전용
4.5.1. minecraft:charged_projectiles4.5.2. minecraft:intangible_projectile
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:hide_additional_tooltip
7. 현수막, 방패 전용
7.1. minecraft:banner_patterns
8. 방패 전용
8.1. minecraft:base_color
9. 양동이 전용
9.1. minecraft:bucket_entity_data
10. 꾸러미 전용
10.1. minecraft:bundle_contents
11. 디버그 막대기 전용
11.1. minecraft:debug_stick_state
12. 염색이 가능한 아이템 전용
12.1. minecraft:dyed_color
13. 생성 알 전용
13.1. minecraft:entity_data
14. 폭죽 탄약 전용
14.1. minecraft:firework_explosion
15. 폭죽 전용
15.1. minecraft:fireworks
16. 염소 뿔 전용
16.1. minecraft:instrument
17. 나침반 전용
17.1. minecraft:lodestone_tracker
18. 지도 전용
18.1. minecraft:map_color18.2. minecraft:map_decorations18.3. minecraft:map_id
19. 불길한 병 전용
19.1. minecraft:ominous_bottle_amplifier
20. 도자기 전용
20.1. minecraft:pot_decorations
21. 물약 전용
21.1. minecraft:potion_contents
22. 플레이어 머리 전용
22.1. minecraft:note_block_sound22.2. minecraft:profile
23. 지식의 책 전용
23.1. minecraft:recipes
24. 마법이 부여된 책 전용
24.1. minecraft:stored_enchantments
25. 수상한 스튜 전용
25.1. minecraft:suspicious_stew_effects
26. 책과 깃펜 전용
26.1. minecraft:writable_book_content
27. 쓰여진 책 전용
27.1. minecraft:written_book_content
28. 내부적으로만 쓰이는 components
28.1. minecraft:creative_slot_lock28.2. minecraft:map_post_processing
29. 추가&변경 예정
29.1. minecraft:consumable29.2. minecraft:damage_resistant29.3. minecraft:death_protection29.4. minecraft:enchantable29.5. minecraft:equippable29.6. minecraft:food　29.7. minecraft:glider29.8. minecraft:item_model29.9. minecraft:repairable29.10. minecraft:use_cooldown29.11. minecraft:use_remainder29.12. minecraft:tooltip_style
30. 임시로 추가된 components

1. 개요

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

아이템 기본 구성 요소는 다음 사이트에서 찾을 수 있다.# 참고: 최신 스냅샷(작성 당시 24w36a) 기준이라 최신 버전(작성 당시 1.21.1)과 맞지 않을 수 있다.

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={show_in_tooltip:값b,modifiers:[{추가 문장},{추가 문장 2}, ...]}]
<colcolor=#000> 기능 아이템에 속성을 부여한다.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
아이템을 착용 및 보유하고 있는 개체의 속성에 영향을 주는 수정자를 부여한다.
파일:nbtFileIcon.svg
attribute_modifiers Components
  • "minecraft:attribute_modifiers" < >
    • modifiers <
      > - 속성의 정보.
      • (하나당 속성) < >
        • type <
          > - 속성 ID.
        • id <
          > - 속성 수정자의 고유 식별자.
        • slot <
          > - 이 수정자가 적용되려면 어느 슬롯에 넣어야할지 결정한다. any, hand, armor, mainhand, offhand, head, chest, legs, feet 중 하나.
        • operation <
          > - 이 수정자의 계산 방식. add_value(덧셈), add_multiplied_base(기본값 기준 곱셈), add_multiplied_total(곱연산) 중 하나.
        • amount <
          > - 값.
    • show_in_tooltip <
      > - 속성 수정자의 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.
예(1.21.1 이하): 공격력 10 추가 네더라이트 검: give @s minecraft:netherite_sword[minecraft:attribute_modifiers={"modifiers":[{"type":"minecraft:generic.attack_damage","amount":10.0,"id":"minecraft:base_attack_damage","operation":"add_value","slot":"mainhand"},{"type":"minecraft:generic.attack_speed","amount":-2.4000000953674316,"id":"minecraft:base_attack_speed","operation":"add_value","slot":"mainhand"}]]

예(1.21.2 이상): 공격력 10 추가 네더라이트 검: give @s minecraft:netherite_sword[minecraft:attribute_modifiers={"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:can_break

<colbgcolor=#40CFFF> minecraft:can_break
[minecraft:can_break={show_in_tooltip:값b,blocks:["블록_ID_1","블록_ID_2", ...]}]
<colcolor=#000> 기능 모험 모드에서도 부술 수 있는 블록을 지정한다.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 minecraft:can_place_on
유형
해당 아이템이 모험 모드에서도 부술 수 있는 블록을 지정한다.
파일:nbtFileIcon.svg
can_break Components
  • "minecraft:can_break" < >
    • blocks <
      > - 상호 작용이 가능한 블록 ID.
      • "블록 1"
      • "블록 2"
      • ...
    • show_in_tooltip <
      > - 상호 작용이 가능한 블록 ID의 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.

3.3. minecraft:custom_data

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

예시: give @p minecraft:stone[minecraft:custom_data={NamuByte:1b, NamuShort:32767s, NamuInt:2147483647, NamuLong:673l, NamuFloat:1.01f, NamuDouble:10.01d, NamuString:"나무위키"}]
파일:nbtFileIcon.svg
custom_data Components
  • "minecraft:custom_data" < >
    • 사용자_지정 <
      Unknown
      > - 사용자 지정
    • ...

3.4. minecraft:custom_model_data

<colbgcolor=#40CFFF> minecraft:custom_model_data
[minecraft:custom_model_data=값]
<colcolor=#000> 기능 아이템이 사용하는 모델의 값을 정한다.
사용 대상 아이템
기본값 0
관련 구성 요소 minecraft:item_model
유형

3.5. minecraft:custom_name

<colbgcolor=#40CFFF> minecraft:custom_name
[minecraft:custom_name="이름"]
<colcolor=#000> 기능 모루로 변경한 아이템 이름.
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 item_name, lore
유형
아이템의 이름을 정한다. JSON 형식으로 써야한다. 모루를 사용한 판정이므로 이름에 기울림꼴이 있다. 아이템이 기울림꼴 되는것을 원하지 않는다면 item_name를 사용한다.

3.6. minecraft:enchantment_glint_override

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

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

아래는 마법부여 아이디 목록이다. 모드, 데이터 팩으로 추가한 마법 부여는 enchant 명령어로 확인하거나, 마법이 부여된 책을 들고 data get entity @s SelectedItem.components."minecraft:stored_enchantments".levels 명령어를 입력한다.
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={"levels":{"minecraft:sharpness":6,"minecraft:unbreaking":4}}]

3.8. minecraft:fire_resistant

<colbgcolor=#40CFFF> minecraft:fire_resistant(1.21.2 제거 예정)
[minecraft:fire_resistant={}]
<colcolor=#000> 기능 아이템 화염 저항 여부.
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 -
유형
이것이 있다면 네더라이트처럼 아이템에 화염 면역이 된다.(1.21.2 제거 예정)

3.9. minecraft:food

<colbgcolor=#40CFFF> minecraft:food
[minecraft:food={nutrition:배고픔값,saturation:포만감값}]
<colcolor=#000> 기능 아이템 음식 여부.
사용 대상 아이템
기본값 (아이템 마다 다름)
관련 구성 요소 -
유형
만약 설정된다면 이 아이템은 먹을 수 있다.
파일:nbtFileIcon.svg
food Components
  • minecraft:food < > - 아이템의 음식을 정의한다.
    • nutrition <
      > - 먹으면 회복할 허기 수(1당 반칸이다.)
    • saturation <
      > - 먹으면 회복할 포만감 수
    • can_always_eat <
      > - true 이면 배가 고프지 않아도 먹을 수 있다.(기본값 false)
    • is_meat <
      > - true 이면 늑대가 먹을 수 있다.(기본값 false)
    • eat_seconds <
      > - 먹는 데 걸리는 시간(초) (기본값 1.6)
    • using_converts_to < > - 음식을 섭취하면 지정된 아이템으로 교체된다.
    • effects <
      > - 먹을 때 적용할 상태 효과 목록
      • (상태 효과 하나) < >
        • effect < > - 상태 효과를 지정한다.
          • id <
            > - 상태 효과 ID. 자세한 내용은 마인크래프트/상태 효과 문서 참고.
          • amplifier <
            > - (선택사항) 상태 효과 증폭값. 기본값은 0.
          • duration <
            > - (선택사항) 지속 시간(틱). 기본값은 1.
          • ambient <
            > - (선택사항) 신호기 효과 여부. 기본값은 false
          • show_particles <
            > - (선택사항) 입자가 방출되는지 여부. 기본값은 true
          • show_icon <
            > - (선택사항) 아이콘이 표시되는지 여부. 기본값은 true
        • probability <
          > - 이 상태 효과가 적용될 확률(0.0 ~ 1.0). 1.0이 100% 확률이다. 50%로 설정하고 싶다면 0.5로 설정한다. (기본값 1.0)
먹을 수 있는 흙: give @s minecraft:dirt[food={nutrition:0,saturation:0}]
먹으면 각각 90% 확률로 30초간 독과 시듦이 걸리는 위더 장미: give @s minecraft:wither_rose[food={nutrition:1,saturation:0.2,effects:[{effect:{id:"minecraft:poison",duration:600},probability:0.9f},{effect:{id:"minecraft:wither",duration:600},probability:0.9f}]}]
먹을 수 있는 케이크: give @s minecraft:cake[food={nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"1"},"minecraft:damage": 1,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"2"},"minecraft:damage": 2,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"3"},"minecraft:damage": 3,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"4"},"minecraft:damage": 4,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"5"},"minecraft:damage": 5,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8,using_converts_to:{id:"cake",components:{"minecraft:block_state":{bites:"6"},"minecraft:damage": 6,"minecraft:max_damage": 7,food:{nutrition:2,saturation:0.4,eat_seconds:0.8}} }} }} }} }} }} }} }} }} }}]

3.10. minecraft:hide_tooltip

<colbgcolor=#40CFFF> minecraft:hide_tooltip
[minecraft:hide_tooltip={}]
<colcolor=#000> 기능 툴팁 숨김 여부
사용 대상 아이템
기본값 (비어있음)
관련 구성 요소 hide_additional_tooltip
유형
만약 설정된다면 아이템 이름과 설명 등을 완전히 숨긴다.

예시: give @s minecraft:waxed_exposed_cut_copper_slab[minecraft:hide_tooltip={}]

3.11. minecraft:item_name

<colbgcolor=#40CFFF> minecraft:item_name
[minecraft:item_name="이름"]
<colcolor=#000> 기능 아이템 기본 이름
사용 대상 아이템
기본값 "{\"translate\":\"(item|block).(네임스페이스).(id)\"}"[1]
관련 구성 요소 custom_name, lore
유형
아이템의 이름을 정한다. custom_name과 달리 모루로 이름을 수정할 수 없으며, 기울림꼴이 나타나지 않는다. 작성할땐 JSON 형식으로 써야한다. item_name와 custom_name 같이 사용하면 custom_name이 우선된다.

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

3.12. minecraft:jukebox_playable

<colbgcolor=#40CFFF> minecraft:jukebox_playable
[minecraft:jukebox_playable={song:"음악id",show_in_tooltip:값}]
<colcolor=#000> 기능 주크박스에 재생할 아이템
사용 대상 아이템
기본값 (음반의 경우 각각 다름)
관련 구성 요소 -
유형
이 구성 요소가 있다면 해당 아이템은 주크박스에 재생할 수 있게 된다.
파일:nbtFileIcon.svg
jukebox_playable Components
  • "minecraft:jukebox_playable" < >
    • song <
      > - 음악 id. data/<namespace>/jukebox_song/<id>.json에서 정의된다. 바닐라 음악 id는 아래에 후술한다.
    • show_in_tooltip <
      > - 음악의 이름 및 작곡가의 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.
음악 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: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:stand Stard - C418 3:09 #
minecraft:wait Wait - C418 3:55 #
minecraft:ward Ward - C418 4:11 #

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

3.13. minecraft:lore

<colbgcolor=#40CFFF> minecraft:lore
[minecraft:lore=["첫번째 줄","두번째 줄", ...]]
<colcolor=#000> 기능 아이템의 설명.
사용 대상 아이템
기본값 []
관련 구성 요소 item_name, custom_name
유형
아이템의 설명을 정한다. 작성할땐 JSON 형식으로 써야한다. 최대 256줄까지 작성할 수 있다.
파일:nbtFileIcon.svg
lore Components
  • minecraft:lore <
    > - 아이템의 설명.
    • "첫번째 줄" <
      >
    • "두번째 줄" <
      >
    • ...
    • (최대 256개까지만 가능하다.)
예시: give @s minecraft:stone[minecraft:lore=["[{\"text\":\"여러분이 가꾸어 나가는\",\"color\":\"#ffffff\",\"italic\":false},{\"text\":\" 지식의 나무\",\"color\":\"#00A495\"}]","[{\"text\":\"두번째 줄.\",\"italic\":false}]"]][item_name+lore]

3.14. 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.15. minecraft:rarity

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

3.16. 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.17. 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 <
      > - 블록을 부술 때마다 내구도의 값이 내려간다. 무조건 음수가 아닌 수여야한다.
    • rule <
      > - 특정 블록에 대해 규칙을 지정한다.
      • (규칙 하나) < >
        • blocks <

          > - 이 규칙을 적용할 블록 ID 및 태그
        • speed <
          > - (선택사항) 만약 있다면 default_mining_speed를 무시하고 블록 파괴 속도를 조정한다.
        • correct_for_drops <
          > - (선택사항) ???

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

4.1. minecraft:damage

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

4.2. 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]

4.3. minecraft:unbreakable

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

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

4.4. 갑옷 전용

4.4.1. minecraft:trim

4.5. 쇠뇌 전용

4.5.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"}]]

4.5.2. minecraft:intangible_projectile

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

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={show_in_tooltip:값b,blocks:["블록_ID_1","블록_ID_2", ...]}]
<colcolor=#000> 기능 모험 모드에서도 설치할 수 있는 블록을 지정한다.
사용 대상 블록으로 설치 가능한 아이템
기본값 (비어있음)
관련 구성 요소 minecraft:can_break
유형
해당 아이템이 모험 모드에서도 설치할 수 있는 블록을 지정한다.
파일:nbtFileIcon.svg
can_place_on Components
  • "minecraft:can_place_on" < >
    • blocks <
      > - 상호 작용이 가능한 블록 ID와 블록 태그.
      • "블록 1"
      • "블록 2"
      • ...
    • show_in_tooltip <
      > - 설치 가능한 블록 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.
예시: 흙, 돌에만 설치가 가능한 다이아몬드 블록 give @p minecraft:diamond_block[minecraft:can_place_on={blocks:["minecraft:stone","minecraft:dirt"]}]

5.4. minecraft:lock

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

예: 비밀번호가 NamuWiki인 상자: give @p chest[minecraft:lock="NamuWiki"]

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 Table와 시드.
사용 대상 상자류
기본값 (비어있음)
관련 구성 요소 -
유형
상자를 열때 보상을 정한다. loot spawn ~ ~ ~ loot뒤에 나오는 값이 루트 테이블이다.
파일: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:hide_additional_tooltip

<colbgcolor=#40CFFF> minecraft:hide_additional_tooltip
[minecraft:hide_additional_tooltip={}]
<colcolor=#000> 기능 이 아이템에 대한 툴팁을 숨길지 여부.
사용 대상 마법이 부여된 책, 꾸러미, 폭죽, 지도 등.
기본값 (비어있음)
관련 구성 요소 hide_tooltip
유형
작성하면 이 아이템에 대한 대부분의 툴팁을 숨긴다. 예시: give @p 아이템_이름[minecraft:hide_additional_tooltip={}]

7. 현수막, 방패 전용

7.1. minecraft:banner_patterns

8. 방패 전용

8.1. minecraft:base_color

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

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

9. 양동이 전용

9.1. minecraft:bucket_entity_data

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

10. 꾸러미 전용

10.1. minecraft:bundle_contents

11. 디버그 막대기 전용

11.1. minecraft:debug_stick_state

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

12.1. minecraft:dyed_color

<colbgcolor=#40CFFF> minecraft:dyed_color
[minecraft:dyed_color={rgb:값,show_in_tooltip:값}]
<colcolor=#000> 기능 아이템 색 수정
사용 대상 염색이 가능한 아이템
기본값 (비어있음)
관련 구성 요소 -
유형
색을 정할 수 있다. 마인크래프트의 색 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935

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

13. 생성 알 전용

13.1. minecraft:entity_data

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

14. 폭죽 탄약 전용

14.1. minecraft:firework_explosion

15. 폭죽 전용

15.1. minecraft:fireworks

16. 염소 뿔 전용

16.1. minecraft:instrument

<colbgcolor=#40CFFF> minecraft:instrument
[minecraft:instrument="ID"]
<colcolor=#000> 기능 염소 뿔의 고유의 음악
사용 대상 염소 뿔
기본값 ?
관련 구성 요소 -
유형
1.21.1 이하: 염소 뿔의 고유의 음악 ID를 지정한다. 세부 정보는 다음과 같다.

1.21.2 이상: 염소 뿔의 고유의 음악. 고유 음악은 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

17. 나침반 전용

17.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}]

18. 지도 전용

18.1. minecraft:map_color

<colbgcolor=#40CFFF> minecraft:map_color
[minecraft:map_id=값]
<colcolor=#000> 기능 지도의 색
사용 대상 지도
기본값 (비어있음)
관련 구성 요소 -
유형
지도의 색을 정한다. 마인크래프트의 색 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935

18.2. minecraft:map_decorations

18.3. minecraft:map_id

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

19. 불길한 병 전용

19.1. minecraft:ominous_bottle_amplifier

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

20. 도자기 전용

20.1. minecraft:pot_decorations

21. 물약 전용

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

21.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 <
      > - 물약이 표시되는 색깔. 마인크래프트의 색깔 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935
    • 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:16711680,custom_effects:[{id:"minecraft:speed",duration:400},{id:"minecraft:resistance",amplifier:3,duration:60},{id:"minecraft:fire_resistance",duration:600}]}]

22. 플레이어 머리 전용

22.1. minecraft:note_block_sound

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

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

22.2. minecraft:profile

<colbgcolor=#40CFFF> minecraft:profile
[minecraft:profile="플레이어이름"]
<colcolor=#000> 기능 플레이어 머리의 정보
사용 대상 플레이어 머리
기본값 (비어있음)
관련 구성 요소 -
유형
플레이어 머리 설정한다.
파일:nbtFileIcon.svg
profile Components
  • "minecraft:profile" < >
    으로 쓸 경우 데이터가 자동으로 불러와진다.
    • name <
      > - 플레이어 이름.
    • id <
      > - (선택사항) 플레이어 머리의 UUID.
    • properties <
      >
        • name <
          > - ???
        • value <
          > - 플레이어 머리 데이터. base64로 인코딩되었다.
        • signature <
          > - (선택사항) 서명.
예: 이름이 jeb_인 플레이어 머리 소환: give @p minecraft:player_head[minecraft:profile="jeb_"]

23. 지식의 책 전용

23.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"]]

24. 마법이 부여된 책 전용

24.1. minecraft:stored_enchantments

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

25. 수상한 스튜 전용

25.1. minecraft:suspicious_stew_effects

<colbgcolor=#40CFFF> minecraft:suspicious_stew_effects
[minecraft:suspicious_stew_effects=[id:"상태효과ID",duration:지속시간]]
<colcolor=#000> 기능 수상한 스튜의 정보.
사용 대상 수상한 스튜
기본값 ???
관련 구성 요소 -
유형
수상한 스튜의 상태 효과를 지정한다.

26. 책과 깃펜 전용

26.1. minecraft:writable_book_content

<colbgcolor=#40CFFF> minecraft:writable_book_content
[minecraft:writable_book_content={pages:["1페이지","2페이지", ...]}]
<colcolor=#000> 기능 책과 깃펜의 정보.
사용 대상 책과 깃펜
기본값 (비어있음)
관련 구성 요소 -
유형
책과 깃펜의 내용을 변경한다.
파일:nbtFileIcon.svg
profile Components
  • "minecraft:written_book_content" < >
    • pages <
      > - 책과 깃펜의 내용.
      • (한 페이지) < >
        • raw <
          > - 내용. JSON으로 작성해야 한다.
        • filtered <
          > - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.

27. 쓰여진 책 전용

27.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
profile Components
  • "minecraft:written_book_content" < >
    • title < > - 쓰여진 책의 제목.
      • raw <
        > - 제목.
      • filtered <
        > - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.
    • pages <
      > - 쓰여진 책의 내용.
      • (한 페이지) < >
        • raw <
          > - 내용. JSON으로 작성해야 한다.
        • filtered <
          > - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.
    • author <
      > - 저자이름.
    • generation <
      > - 아이템 복제 횟수. 0은 원본, 1은 원본의 복사본, 2는 복사본의 복사본, 3은 낡음이다.
    • resolved

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

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

28.1. minecraft:creative_slot_lock

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

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

28.2. minecraft:map_post_processing

알 수 없음.

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

29. 추가&변경 예정

업데이트로 추가&변경될 예정인 컨텐츠이다. 스냅샷, 실험적 데이터 팩, 행사 등에는 공개되었지만 아직 정식 버전에 추가되지 않았다. 그러므로 변경 사항이 자주 발생할 수 있다.

29.1. minecraft:consumable

<colbgcolor=#40CFFF> minecraft:consumable
[minecraft:consumable={consume_seconds:초,...}]
<colcolor=#000> 기능 아이템 소모 여부
사용 대상 아이템
기본값 (아이템마다 다름)
관련 구성 요소 food, use_remainder, use_cooldown, ominous_bottle_amplifier, potion_contents, suspicious_stew_contents
유형
이것이 있다면 해당 아이템은 소모될 수 있다. 다른 구성 요소와 연계가 가능하다.
파일: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
    • 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일 경우...

먹을 수 있는 흙: give @s minecraft:dirt[minecraft:consumable={}]
먹으면 90% 확률로 10초동안 독과 시듦이 걸리는 위더 장미: give @s minecraft:wither_rose[minecraft:consumable={"on_consume_effects":[{"type":"minecraft:clear_all_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'}]}]
다이아몬드 검을 막는 애니메이션: give @s minecraft:diamond_sword[minecraft:consumable={"animation":"block","consume_seconds":1000000000.0,"has_consume_particles":false}]

29.2. minecraft:damage_resistant

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

29.3. 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"}]}]}]

29.4. minecraft:enchantable

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

예: 마법 부여가 불가능한 금 곡괭이: give @s golden_pickaxe[!minecraft:enchantable]

29.5. 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
    • equip_sound <
      > - (선택 사항) 아이템이 장착될 때 재생할 소리. 지정하지 않으면 기본 방어구 장착 사운드가 재생된다.
    • model <
      > - (선택 사항) 장착 시 모델 네임스페이스 ID. 모델은 리소스 팩에서 정의된다. 지정하지 않으면 머리에 있을 때 아이템 자체로 렌더링이 된다.
    • allowed_entities <
      > - (선택 사항)
    • dispensable <
      > - (선택 사항) 발사기를 사용하여 아이템을 장착 가능한지 여부. (기본값 true)
    • swappable <
      > - (선택 사항) 마우스 오른쪽 버튼을 클릭하여 해당 슬롯에 아이템을 장착할 수 있는지 여부.(기본값 true)
    • damage_on_hurt <
      > - (선택 사항) 착용한 개체가 피해를 입을 때 이 아이템이 손상되는지 여부. (기본값 true)
예: 발에 장착이 가능한 네더라이트 주괴: give @s netherite_ingot[minecraft:equippable={"slot":"feet"}]

29.6. 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}} }} }} }} }} }}]

29.7. minecraft:glider

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

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

29.8. minecraft:item_model

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

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

예: 네더의 별 모델을 가진 구운 토끼고기: give @s minecraft:cooked_rabbit[minecraft:item_model="minecraft:nether_star"]
예2: 에메랄드 검: give @s minecraft:potion[minecraft:item_model="minecraft:iron_sword",minecraft:potion_contents={custom_color:8453888}]

29.9. 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"]}]

29.10. minecraft:use_cooldown

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

29.11. 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={}]

29.12. minecraft:tooltip_style

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

30. 임시로 추가된 components

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

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

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

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

minecraft:views
이것이 있다면 아이템을 볼때마다(즉. 상자를 열어서 아이템을 보는 것 등) 값이 증가한다.
[1] 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},{\"text\":\" 지식의 나무\",\"color\":\"#00A495\"}]","[{\"text\":\"두번째 줄.\",\"italic\":false}]"][item_name+lore] [불사의_토템_기본값] 24w37a 기준. minecraft:death_protection={"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}]}]} [5] 아이템 id가 minecraft:diamond라면 기본값도 minecraft:diamond가 된다.

분류