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

※ JE의 최신버전인 1.20.5 기준이며, 상하위 버전에 맞지 않는 구성 요소가 있을 수 있습니다.

아이템 관련 문서
건축 블록	색깔 블록	자연 블록	기능 블록	레드스톤 블록
도구 및 유용한 물건	전투	음식 및 음료	재료	생성 알 & 특수 아이템
{{{#!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:lore3.13. minecraft:max_stack_size3.14. minecraft:rarity3.15. minecraft:repair_cost3.16. 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_projectiles

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:bucket_entity_data

9. 꾸러미 전용

9.1. minecraft:bundle_contents

10. 디버그 막대기 전용

10.1. minecraft:debug_stick_state

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

11.1. minecraft:dyed_color

12. 생성 알 전용

12.1. minecraft:entity_data

13. 폭죽 탄약 전용

13.1. minecraft:firework_explosion

14. 폭죽 전용

14.1. minecraft:fireworks

15. 염소 뿔 전용

15.1. minecraft:instrument

16. 나침반 전용

16.1. minecraft:lodestone_tracker

17. 지도 전용

17.1. minecraft:map_color17.2. minecraft:map_decorations17.3. minecraft:map_id

18. 불길한 병 전용

18.1. minecraft:ominous_bottle_amplifier

19. 도자기 전용

19.1. minecraft:pot_decorations

20. 물약 전용

20.1. minecraft:potion_contents

21. 플레이어 머리 전용

21.1. minecraft:note_block_sound21.2. minecraft:profile

22. 지식의 책 전용

22.1. minecraft:recipes

23. 마법이 부여된 책 전용

23.1. minecraft:stored_enchantments

24. 수상한 스튜 전용

24.1. minecraft:suspicious_stew_effects

25. 책과 깃펜 전용

25.1. minecraft:writable_book_content

26. 쓰여진 책 전용

26.1. minecraft:written_book_content

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

27.1. minecraft:creative_slot_lock27.2. minecraft:map_post_processing

28. 임시로 추가된 components

28.1. minecraft:clicks28.2. minecraft:hovered28.3. minecraft:views

1. 개요

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

NBT를 구성요소로 변경하는 사이트가 있다. 참고바람

2. 모든 상위 태그

모든 상위 태그

count <
Int
>
Slot <
Byte
>
id <
String
>
components <
Compound
>

2.1. count

<colbgcolor=#40CFFF> count
`{count:값}`
<colcolor=#000> 기능	아이템 갯수
사용 대상	아이템
기본값	1
관련 NBT 태그	-
유형	Int

아이템의 갯수를 정한다. 최대 max_stack_size의 값까지 가능하며. 0개 이하이면 공기(=아이템 제거)로 처리되어 아이템이 삭제된다.

2.2. id

<colbgcolor=#40CFFF> id
`{id:"문자열"}`
<colcolor=#000> 기능	아이템 ID
사용 대상	아이템
기본값	`minecraft:air`
관련 NBT 태그	-
유형	String

아이템 ID를 정한다. 아이템 ID는 F3+H를 눌러 확인할 수 있다.

2.3. Slot

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

2.4. components

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

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

3. 모든 아이템

아이템 구성 요소를 지정할때 아이템은 다음 명령어와 같이 지정한다. 예: give @p 아이템_이름[이름1=값1,이름2=값2, ...]

3.1. minecraft:attribute_modifiers

<colbgcolor=#40CFFF> minecraft:attribute_modifiers
`[minecraft:attribute_modifiers={show_in_tooltip:값b,modifiers:[{추가 문장},{추가 문장 2}, ...]}]`
<colcolor=#000> 기능	아이템에 속성을 부여한다.
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

아이템을 착용 및 보유하고 있는 개체의 속성에 영향을 주는 수정자를 부여한다.

attribute_modifiers Components

"minecraft:attribute_modifiers" <
Compound
>

modifiers <
List
> - 속성의 정보.

(하나당 속성) <
Compound
>

type <
String
> - 속성 ID.
name <
String
> - 속성 이름.
slot <
String
> - 이 수정자가 적용되려면 어느 슬롯에 넣어야할지 결정한다. any, hand, armor, mainhand, offhand, head, chest, legs, feet 중 하나.
operation <
Int
> - 이 수정자의 계산 방식. add_value^(덧셈), add_multiplied_base^{(기본값 기준 곱셈)}, add_multiplied_total^(곱연산) 중 하나.
amount <
Double
> - 값.
uuid <
Int Array
> - UUID. 아무 값이나 넣어도 상관 없지만, 이 사이트에서 정하는 것이 좋다.

show_in_tooltip <
Boolean
> - 속성 수정자의 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.

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
유형	Compound

해당 아이템이 모험 모드에서도 부술 수 있는 블록을 지정한다.

can_break Components

"minecraft:can_break" <
Compound
>

blocks <
Compound

List
> - 상호 작용이 가능한 블록 ID.

"블록 1"
"블록 2"
...

show_in_tooltip <
Boolean
> - 상호 작용이 가능한 블록 ID의 툴팁을 보여줄지 여부. false면 숨긴다. 기본값은 true.

3.3. minecraft:custom_data

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

이 아이템의 데이터를 저장한다.

예시:

give @p minecraft:stone[minecraft:custom_data={NamuByte:1b, NamuShort:32767s, NamuInt:2147483647, NamuLong:673l, NamuFloat:1.01f, NamuDouble:10.01d, NamuString:"나무위키"}]

custom_data Components

"minecraft:custom_data" <
Compound
>

사용자_지정 <
불명
> - 사용자 지정

3.4. minecraft:custom_model_data

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

3.5. minecraft:custom_name

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

아이템의 이름을 정한다. JSON 형식으로 써야한다. 모루를 사용한 판정이므로 이름에 기울림꼴이 있다. 아이템이 기울림꼴 되는것을 원하지 않는다면 item_name를 사용한다.

3.6. minecraft:enchantment_glint_override

<colbgcolor=#40CFFF> minecraft:enchantment_glint_override
`[minecraft:enchantment_glint_override=값]`
<colcolor=#000> 기능	마법 부여의 반짝임 표시 여부.
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	-
유형	Boolean

기존의 마법 부여의 반짝임을 무시하고, 반짝임 표시를 할지 여부. 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> 기능	마법 부여의 정보.
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

마법 부여 정보를 정한다. 자세한 효과는 마인크래프트/마법 부여 문서 참조.

아래는 마법부여 아이디 목록이다.

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^(1.21)	육중
minecraft:binding_curse	귀속 저주	minecraft:flame	화염	minecraft:breach^(1.21)	격파
minecraft:sharpness	날카로움	minecraft:infinity	무한	minecraft:wind_burst^(1.21)	돌풍
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
`[minecraft:fire_resistant={}]`
<colcolor=#000> 기능	아이템 화염 저항 여부.
사용 대상	아이템
기본값	(아이템마다 다름)
관련 구성 요소	-
유형	Compound

이것이 있다면 네더라이트처럼 아이템에 화염 면역이 된다.

3.9. minecraft:food

<colbgcolor=#40CFFF> minecraft:food
`[minecraft:food={nutrition:배고픔값,saturation:포만감값}]`
<colcolor=#000> 기능	아이템 음식 여부.
사용 대상	아이템
기본값	(아이템 마다 다름)
관련 구성 요소	-
유형	Compound

만약 설정된다면 이 아이템은 먹을 수 있다.

food Components

minecraft:food <
Compound
> - 아이템의 음식을 정의한다.

nutrition <
Int
> - 먹으면 회복할 허기 수(1당 반칸이다.)
saturation <
Float
> - 먹으면 회복할 포만감 수
can_always_eat <
Boolean
> - true 이면 배가 고프지 않아도 먹을 수 있다.(기본값 false)
is_meat <
Boolean
> - true 이면 늑대가 먹을 수 있다.(기본값 false)
eat_seconds <
Float
> - 먹는 데 걸리는 시간(초) (기본값 1.6)
effects <
List
> - 먹을 때 적용할 상태 효과 목록

(상태 효과 하나) <
Compound
>

effect <
Compound
> - 상태 효과를 지정한다.

id <
String
> - 상태 효과 ID. 자세한 내용은 마인크래프트/상태 효과 문서 참고.
amplifier <
String
> - (선택사항) 상태 효과 증폭값. 기본값은 0.
duration <
Int
> - (선택사항) 지속 시간(틱). 기본값은 1.
ambient <
Boolean
> - (선택사항) 신호기 효과 여부. 기본값은 false
show_particles <
Boolean
> - (선택사항) 입자가 방출되는지 여부. 기본값은 true
show_icon <
Boolean
> - (선택사항) 아이콘이 표시되는지 여부. 기본값은 true

probability <
Float
> - 이 상태 효과가 적용될 확률(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:0,saturation:0,effects:[{effect:{id:"minecraft:poison",duration:600},probability:0.9f},{effect:{id:"minecraft:wither",duration:600},probability:0.9f}]}]

3.10. minecraft:hide_tooltip

<colbgcolor=#40CFFF> minecraft:hide_tooltip
`[minecraft:hide_tooltip={}]`
<colcolor=#000> 기능	툴팁 숨김 여부
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	`hide_additional_tooltip`
유형	Compound

만약 설정된다면 아이템 이름과 설명 등을 완전히 숨긴다.

예시: 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> 기능	아이템 이름
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	custom_name, lore
유형	Compound

아이템의 이름을 정한다. custom_name과 달리 모루로 이름을 수정할 수 없으며, 기울림꼴이 나타나지 않는다. 작성할땐 JSON 형식으로 써야한다.

예시:

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

[item_name+lore]

3.12. minecraft:lore

<colbgcolor=#40CFFF> minecraft:lore
`[minecraft:lore=["첫번째 줄","두번째 줄", ...]]`
<colcolor=#000> 기능	아이템의 설명.
사용 대상	아이템
기본값	(비어있음)
관련 구성 요소	item_name, custom_name
유형	List

아이템의 설명을 정한다. 작성할땐 JSON 형식으로 써야한다. 최대 256줄까지 작성할 수 있다.

lore Components

minecraft:lore <
List
> - 아이템의 설명.

"첫번째 줄" <
String
>
"두번째 줄" <
String
>
...
(최대 256개까지만 가능하다.)

예시:

give @s minecraft:stone[minecraft:lore=["[{\"text\":\"여러분이 가꾸어 나가는\",\"color\":\"#ffffff\",\"italic\":false},{\"text\":\" 지식의 나무\",\"color\":\"#00A495\"}]","[{\"text\":\"두번째 줄.\",\"italic\":false}]"]]

[item_name+lore]

3.13. minecraft:max_stack_size

<colbgcolor=#40CFFF> minecraft:max_stack_size
`[minecraft:max_stack_size=값]`
<colcolor=#000> 기능	이 아이템의 최대 쌓기를 제어한다.
사용 대상	아이템
기본값	(대부분의 경우 64)
관련 구성 요소	-
유형	Int

이 아이템의 최대 쌓기를 수정한다. 1부터 99까지 가능하다. 도구는 최대 1까지 설정 가능하다.

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

3.14. minecraft:rarity

<colbgcolor=#40CFFF> minecraft:rarity
`[minecraft:rarity="문자열"]`
<colcolor=#000> 기능	아이템의 등급을 정한다.
사용 대상	아이템
기본값	(대부분의 경우 "common")
관련 구성 요소	-
유형	String

아이템의 이름 기본 색상을 정한다. common(흰색), uncommon(노랑색), rare(하늘색), epic(보라색)만 넣을 수 있다.

3.15. minecraft:repair_cost

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

모루로 수리 및 결합할 때의 요구 레벨을 정한다.

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

3.16. minecraft:tool

<colbgcolor=#40CFFF> minecraft:tool
`[minecraft:tool={추가문장}]`
<colcolor=#000> 기능	아이템 도구 여부.
사용 대상	아이템
기본값	(아이템마다 다름)
관련 구성 요소	-
유형	Compound

만약 설정된다면 해당 아이템은 도구가 된다.

tool Components

minecraft:tool <
Compound
> - 아이템의 도구를 정의한다.

default_mining_speed <
Float
> - 블록 파괴 속도를 조정한다. 기본값 1.0
damage_per_block <
Int
> - 블록을 부술 때마다 내구도의 값이 내려간다. 무조건 음수가 아닌 수여야한다.
rule <
List
> - 특정 블록에 대해 규칙을 지정한다.

(규칙 하나) <
Compound
>

blocks <
String

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

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

4.1. minecraft:damage

<colbgcolor=#40CFFF> minecraft:damage
`[minecraft:damage=값]`
<colcolor=#000> 기능	아이템 사용 횟수.
사용 대상	내구도가 있는 모든 아이템
기본값	0
관련 구성 요소	-
유형	Int

아이템 사용 횟수를 정한다. 한번 쓰고 깨지게 하고 싶다면, 그 장비의 내구도와 똑같은 숫자를 입력해주면 된다. 각 장비별 내구도 수치는 다음과 같다.

아이템	내구도	아이템	내구도	아이템	내구도
거북 등딱지	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	철퇴^(1.21)	250

1회용 네더라이트 검: give @p netherite_sword[minecraft:damage=2031]

4.2. minecraft:max_damage

<colbgcolor=#40CFFF> minecraft:max_damage
`[minecraft:max_damage=값]`
<colcolor=#000> 기능	아이템 최대 내구도.
사용 대상	아이템
기본값	(아이템마다 다름)
관련 구성 요소	-
유형	Int

이 아이템의 최대 내구도를 설정한다. 설정하지 않으면 내구도를 깎을 수 없다. 값은 양수여야 한다.

예: 내구도가 258인 금 곡괭이: give @p minecraft:golden_pickaxe[minecraft:max_damage=258]

4.3. minecraft:unbreakable

<colbgcolor=#40CFFF> minecraft:unbreakable
`[minecraft:unbreakable={}]`
<colcolor=#000> 기능	내구도 무한 여부.
사용 대상	내구도가 있는 모든 아이템
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

이 구성 요소가 있다면 해당 아이템은 더 이상 내구도가 소모되지 않는다. 아이템 툴팁에 "부셔지지 않음"이 생긴다. 이것을 숨길려면 {와 } 사이 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> 기능	장전된 쇠뇌의 발사체 정보
사용 대상	쇠뇌
기본값	(비어있음)
관련 구성 요소	-
유형	List

장전된 쇠뇌의 발사체 정보를 지정한다. 이 구성 요소가 없다면 장전되지 않은 쇠뇌이다.

charged_projectiles Components

"minecraft:charged_projectiles" <
List
>

(발사체) <
Compound
> - 발사체 하나
(발사체) <
Compound
> - 발사체 하나
...

예시: 장전된 화살이 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"}]]

5. 모든 블록

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

5.1. minecraft:block_entity_data

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

5.2. minecraft:block_state

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

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
유형	Compound

해당 아이템이 모험 모드에서도 설치할 수 있는 블록을 지정한다.

can_place_on Components

"minecraft:can_place_on" <
Compound
>

blocks <
Compound

List
> - 상호 작용이 가능한 블록 ID와 블록 태그.

"블록 1"
"블록 2"
...

show_in_tooltip <
Boolean
> - 설치 가능한 블록 툴팁을 보여줄지 여부. 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 있는 블록
기본값	(비어있음)
관련 구성 요소	-
유형	String

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와 시드.
사용 대상	상자류
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

상자를 열때 보상을 정한다. loot spawn ~ ~ ~ loot뒤에 나오는 값이 루트 테이블이다.

container_loot Components

"minecraft:container_loot" <
Compound
>

loot_table <
String
> - 루트 테이블의 ID
seed <
Long
> - 시드. 값이 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> 기능	상자의 내용물
사용 대상	상자류
기본값	(비어있음)
관련 구성 요소	-
유형	List

상자의 내용물을 확인한다.

container Components

"minecraft:container" <
List
>

Compound

item <
Compound
> - 아이템의 정보.

#모든 상위 태그와 같다. 단 Slot는 없다.

slot <
Int
> - 아이템 슬롯 위치.(0~255)

예: 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`
유형	Compound

작성하면 이 아이템에 대한 대부분의 툴팁을 숨긴다. 예시: give @p 아이템_이름[minecraft:hide_additional_tooltip={}]

7. 현수막 전용

7.1. minecraft:banner_patterns

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> 기능	담긴 양동이의 정보
사용 대상	XX이(가) 담긴 양동이
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

XX이(가) 담긴 양동이의 정보를 설정한다. 풀어줄 때 이 태그를 가진다.

bucket_entity_data Components

"minecraft:bucket_entity_data" <
Compound
> - 엔티티 NBT와 같지만 다음 태그만 가능하다.

NoAI <
Boolean
>
Silent <
Boolean
>
NoGravity <
Boolean
>
Glowing <
Boolean
>
Invulnerable <
Boolean
>
Health <
Float
>
Age <
Int
> - 아홀로틀 전용.
Variant <
Int
> - 아홀로틀 전용.
HuntingCooldown: <
Long
> - 아홀로틀 전용.
BucketVariantTag <
Int
> - 열대어 전용.

9. 꾸러미 전용

9.1. minecraft:bundle_contents

10. 디버그 막대기 전용

10.1. minecraft:debug_stick_state

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

11.1. minecraft:dyed_color

<colbgcolor=#40CFFF> minecraft:dyed_color
`[minecraft:dyed_color={rgb:값,show_in_tooltip:값}]`
<colcolor=#000> 기능	아이템 색 수정
사용 대상	염색이 가능한 아이템
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

색을 정할 수 있다. 마인크래프트의 색 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935

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

12. 생성 알 전용

12.1. minecraft:entity_data

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

생성 알의 개체 정보를 지정한다.

entity_data Components

"minecraft:entity_data" <
Compound
>

id <
String
> - 개체의 ID
그 외는 마인크래프트/NBT/엔티티 문서 참고.

13. 폭죽 탄약 전용

13.1. minecraft:firework_explosion

14. 폭죽 전용

14.1. minecraft:fireworks

15. 염소 뿔 전용

15.1. minecraft:instrument

<colbgcolor=#40CFFF> minecraft:instrument
`[minecraft:instrument="ID"]`
<colcolor=#000> 기능	염소 뿔의 고유의 음악
사용 대상	염소 뿔
기본값	?
관련 구성 요소	-
유형	String

염소 뿔의 고유의 음악 ID를 지정한다. 세부 정보는 다음과 같다.

음악	ID
고민(Ponder)	`minecraft:ponder_goat_horn`
노래(Sing)	`minecraft:sing_goat_horn`
수색(Seek)	`minecraft:seek_goat_horn`
감각(Feel)	`minecraft:feel_goat_horn`
동경(Admire)	`minecraft:admire_goat_horn`
소집(Call)	`minecraft:call_goat_horn`
갈망(Yearn)	`minecraft:yearn_goat_horn`
꿈결(Dream)	`minecraft:dream_goat_horn`

16. 나침반 전용

16.1. minecraft:lodestone_tracker

<colbgcolor=#40CFFF> minecraft:lodestone_tracker
`[minecraft:lodestone_tracker={target:{pos:[I; X,Y,Z],dimension:"차원ID"},tracked:값b}]`
<colcolor=#000> 기능	자석석 나침반 위치 정보
사용 대상	나침반
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

자석석 나침반이 가리켜야 하는 자석석 위치 정보를 저장한다.

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

17. 지도 전용

17.1. minecraft:map_color

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

지도의 색을 정한다. 마인크래프트의 색 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935

17.2. minecraft:map_decorations

17.3. minecraft:map_id

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

지도의 ID를 정한다.

18. 불길한 병 전용

18.1. minecraft:ominous_bottle_amplifier

<colbgcolor=#40CFFF> minecraft:ominous_bottle_amplifier
`[minecraft:ominous_bottle_amplifier=값]`
<colcolor=#000> 기능	불길한 병 등급
사용 대상	불길한 병
기본값	0
관련 구성 요소	-
유형	Int

불길한 병의 흉조 효과의 증폭량. 0 ~ 4 사이의 정수만 가능하다.

19. 도자기 전용

19.1. minecraft:pot_decorations

20. 물약 전용

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

20.1. minecraft:potion_contents

<colbgcolor=#40CFFF> minecraft:potion_contents
`[minecraft:potion_contents={potion:"문자열",custom_color:색상,custom_effects:[{물약 정보 1},{물약 정보 2}, ...]}]`
<colcolor=#000> 기능	물약의 정보
사용 대상	물약
기본값	?
관련 구성 요소	-
유형	Compound

물약의 정보를 정한다.

potion_contents Components

"minecraft:potion_contents" <
Compound
>

potion <
String
> - (선택사항)
custom_color <
Int
> - 물약이 표시되는 색깔. 마인크래프트의 색깔 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. 예: #FF00FF → 16711935
custom_effects <
List
> - 속성의 정보.

(상태 효과 하나) <
Compound
>

id <
String
> - 상태 효과 ID. 자세한 내용은 마인크래프트/상태 효과 문서 참고.
amplifier <
String
> - (선택사항) 상태 효과 증폭값. 기본값은 0.
duration <
Int
> - (선택사항) 지속 시간(틱). 기본값은 1.
ambient <
Boolean
> - (선택사항) 신호기 효과 여부. 기본값은 false
show_particles <
Boolean
> - (선택사항) 입자가 방출되는지 여부. 기본값은 true
show_icon <
Boolean
> - (선택사항) 아이콘이 표시되는지 여부. 기본값은 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}]}]

21. 플레이어 머리 전용

21.1. minecraft:note_block_sound

<colbgcolor=#40CFFF> minecraft:note_block_sound
`[minecraft:note_block_sound="소리ID"]`
<colcolor=#000> 기능	소리 블록 아래의 소리 ID
사용 대상	소리 블록
기본값	(비어있음)
관련 구성 요소	-
유형	String

플레이어 머리 아래에 소리 블록이 레드스톤 신호를 받으면 그 소리를 재생한다. playsound 뒤에 나올 값을 정하면 된다.

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

21.2. minecraft:profile

<colbgcolor=#40CFFF> minecraft:profile
`[minecraft:profile="플레이어이름"]`
<colcolor=#000> 기능	플레이어 머리의 정보
사용 대상	플레이어 머리
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

플레이어 머리 설정한다.

profile Components

"minecraft:profile" <
Compound
>
String
으로 쓸 경우 데이터가 자동으로 불러와진다.

name <
List
> - 플레이어 이름.
id <
Int Array
> - (선택사항) 플레이어 머리의 UUID.
properties <
List
>

Compound

name <
String
> - ???
value <
String
> - 플레이어 머리 데이터. base64로 인코딩되었다.
signature <
String
> - (선택사항) 서명.

예: 이름이 jeb_인 플레이어 머리 소환: give @p minecraft:player_head[minecraft:profile="jeb_"]

22. 지식의 책 전용

22.1. minecraft:recipes

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

지식의 책 사용시 잠금 해제할 아이템을 정한다.

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

23. 마법이 부여된 책 전용

23.1. minecraft:stored_enchantments

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

마법 부여의 저장 정보. 세부 사항은 enchantments와 같다.

24. 수상한 스튜 전용

24.1. minecraft:suspicious_stew_effects

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

수상한 스튜의 상태 효과를 지정한다.

25. 책과 깃펜 전용

25.1. minecraft:writable_book_content

<colbgcolor=#40CFFF> minecraft:writable_book_content
`[minecraft:writable_book_content={pages:["1페이지","2페이지", ...]}]`
<colcolor=#000> 기능	책과 깃펜의 정보.
사용 대상	책과 깃펜
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

책과 깃펜의 내용을 변경한다.

profile Components

"minecraft:written_book_content" <
Compound
>

pages <
List
> - 책과 깃펜의 내용.

(한 페이지) <
Compound
>

raw <
String
> - 내용. JSON으로 작성해야 한다.
filtered <
String
> - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.

26. 쓰여진 책 전용

26.1. minecraft:written_book_content

<colbgcolor=#40CFFF> minecraft:written_book_content
`[minecraft:written_book_content={pages:["1페이지","2페이지", ...],title:"제목",author:"저자이름",generation:값}]`
<colcolor=#000> 기능	쓰여진 책의 정보.
사용 대상	쓰여진 책
기본값	(비어있음)
관련 구성 요소	-
유형	Compound

쓰여진 책의 저자, 내용, 제목, 상태를 변경한다.

profile Components

"minecraft:written_book_content" <
Compound
>

title <
Compound
> - 쓰여진 책의 제목.

raw <
String
> - 제목.
filtered <
String
> - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.

pages <
List
> - 쓰여진 책의 내용.

(한 페이지) <
Compound
>

raw <
String
> - 내용. JSON으로 작성해야 한다.
filtered <
String
> - (선택사항) 플레이어가 대화 필터 켜져있다면 raw 대신 표시한다.

author <
String
> - 저자이름.
generation <
Int
> - 아이템 복제 횟수. 0은 원본, 1은 원본의 복사본, 2는 복사본의 복사본, 3은 낡음이다.
resolved

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

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

27.1. minecraft:creative_slot_lock

크리에이티브 인벤토리의 슬롯을 잠그는 데 내부적으로만 사용된다. 설정하면 해당 아이템을 슬롯에서 꺼낼 수 없다.

핫바 저장에 쓰일때 종이가 꺼내지지 않는 것이 이 components가 사용된 것이다.

27.2. minecraft:map_post_processing

28. 임시로 추가된 components

해당 components는 만우절 버전(24w14potato)으로 추가된 components이다.

28.1. minecraft:clicks

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

28.2. minecraft:hovered

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

28.3. minecraft:views

이것이 있다면 아이템을 볼때마다(즉. 상자를 열어서 아이템을 보는 것 등) 값이 증가한다.

[item_name+lore] item_name과 lore을 같이 쓸 경우: give @p 아이템_이름[minecraft:item_name="이름",minecraft:lore=["설명1","설명2", ...]][item_name+lore]