이곳은 개발을 위한 베타 사이트 입니다.
기여내역은 언제든 초기화될 수 있으며, 예기치 못한 오류가 발생할 수 있습니다.
기여내역은 언제든 초기화될 수 있으며, 예기치 못한 오류가 발생할 수 있습니다.
마인크래프트/NBT/아이템
덤프버전 :
상위 문서: 마인크래프트/NBT 
1. 개요
2. 모든 상위 태그
3. 내구도가 있는 아이템
4. 속성 수정자(Attribute Modifiers)
4.1. AttributeModifiers
5. 모든 블록
6. tag
6.1. display
6.2. Enchantments
6.2.1. StoredEnchantments
6.3. HideFlags
6.4. RepairCost
6.5. 글이 쓰인 책 전용
6.6. 폭죽 전용
6.7. 플레이어 머리 전용
6.7.1. SkullOwner
6.8. 쇠뇌 전용
6.8.1. ChargedProjectiles
6.9. 물약 전용
6.10.1. Effects
6.11. (사용자 지정 NBT)
1. 개요[편집]
아이템 관련 NBT 태그이다.
아이템과 관련한 태그는 대부분 마인크래프트 위키의 Player.dat format 문서에서 볼 수 있다.
/data get entity @s SelectedItem 명령어를 사용하면 들고 있는 아이템의 정보를 쉽게 알수 있다.DigMinecraft에서 과거 버전의 명령어도 활용할 수 있다.
2. 모든 상위 태그[편집]
2.1. Count[편집]
아이템의 갯수를 정한다. 0개 이하이면 공기(=아이템 제거)로 처리된다.
2.2. id[편집]
아이템 ID를 정한다. 아이템 ID는
F3+H를 눌러 확인할 수 있다.2.3. Slot[편집]
2.4. tag[편집]
아이템 세부 정보를 정한다. 아래 서술된 모든 NBT 태그는 이 tag의 하위 NBT이다.
3. 내구도가 있는 아이템[편집]
내구도가 있는 아이템이다.
3.1. Damage[편집]
장비의 내구도를 설정할 때 쓰이는 태그이다.
사용법은
{Damage:(숫자)}.한번 쓰고 깨지게 하고 싶다면, 그 장비의 내구도와 똑같은 숫자를 입력해주면 된다.
각 장비별 내구도 수치는 다음과 같다.
만약 어떤 도구의 내구도가 p(예: 다이아몬드 도구는 p=1561)일 때 여기에 damage를 q만큼 준다면(p>q), 해당 도구의 내구도는 p-q만큼 남는다.
예:
/give @a diamond_axe{Damage:1560} 모든 플레이어에게 내구도가 1인 다이아몬드 도끼를 1개 지급한다. 내구도가 1이 되는 이유는, 다이아몬드 도구의 기본 내구도는 1561이지만 대미지를 1560만큼 줬기 때문이다.3.2. Unbreakable[편집]
내구도가 있는 모든 아이템 한정. 이 NBT가 붙은 아이템은 더 이상 내구도가 소모되지 않는다. 아이템에 "부서지지 않음"이란 설명이 붙는다.
3.3. CanDestroy[편집]
해당 아이템으로 무엇을 부술 수 있는지 정해주는 태그다. 일반적인 상황에서는 쓰지 않으며, 모험 모드로 플레이할 때 사용한다.
형식:
{CanDestroy:[" 블록 아이디 "," 블록 아이디 ",...]} - 블록 아이디는 minecraft:stone처럼 쓰면 된다.예:
/give @a diamond_pickaxe{CanDestroy:["dirt"]} - 모든 플레이어에게 모험 모드에서 흙을 파괴할 수 있는 다이아몬드 곡괭이 1개를 지급한다.여담으로, 블록 아이디 부분에 유효하지 않은 텍스트를 넣으면 missingno가 출력된다.
3.4. CustomModelData[편집]
4. 속성 수정자(Attribute Modifiers)[편집]
모든 아이템은 아이템을 착용 및 보유하고 있는 엔티티의 다양한 속성에 영향을 주는 수정자를 부여할 수 있다.
4.1. AttributeModifiers[편집]
AttributeModifiers:[{AttributeName:" 속성 ",Name:" 이름 ",Amount:(값),Operation:(0,1,2),UUID:[I; int, int, int, int],Slot:" 슬롯 "}]의 형태로 매우 길게 나온다.이 NBT는 매우 길고 값에 따라 UUID가 달라져 명령어 제작 사이트를 통해 명령어를 만드는 것을 추천한다.[1]
- 예시
/give NamuPlayer minecraft:stone{AttributeModifiers:[{AttributeName:"generic.attack_damage",Slot:"mainhand",Amount:900,Operation:0,UUID:[I;1071272853,1047860612,1056957565,[pagecount]]}]} 14.1.1. AttributeName[편집]
모든 속성 앞에는 "generic." 을 붙여야 한다. (예) generic.max_health , generic.attack_damage 등
4.1.2. Amount[편집]
4.1.3. Name[편집]
4.1.4. Slot[편집]
슬롯은 개별 적용이라서 한 아이템을 어디 슬롯에 두었는지에 따라 효과가 다르게도 가능하다.
4.1.5. Operation[편집]
0부터 2까지의 값이 지정되어 있으며 0은 +값, 1은 퍼센테이지 값이 되며, 2로 할 시엔 곱하기 값이 된다. 3 이상의 수를 넣을 경우 속성이 정상적으로 적용되지 않는다.
4.1.6. UUID[편집]
아무 값이나 넣어도 상관 없으나 이런 사이트같이 랜덤으로 지정하는게 더 안전하다.
5. 모든 블록[편집]
블록이 아이템 상태일 때 붙는 태그다.
5.1. CanPlaceOn[편집]
해당 아이템을 어떤 블록에 올릴 수 있는지 정해주는 태그다. 위의
CanDestroy 태그처럼 모험 모드에서 발현된다.형식:
{CanPlaceOn:[" 블록 아이디 "," 블록 아이디 ",...]} 예: /give @a diamond_block{CanPlaceOn:["stone"]} = 모든 플레이어에게 돌 위에 설치할 수 있는 다이아몬드 블록을 1개 지급한다.
5.2. BlockEntityTag[편집]
현수막, 벌통, 상자 등에 붙는 태그이다.
5.2.1. Slot[편집]
상자, 셜커 상자 등에 쓸 수 있는 NBT 데이터이다. 이걸로 상자의 인벤토리를 감지할 수 있다.
응용:
/give @s chest{BlockEntityTag:{Items:[{Slot:0b,id:"minecraft:아이템",Count:개수b}]}} - 슬롯 0(상자의 맨 처음 슬롯)에 아이템이 개수만큼 들어있는 상자를 줌./execute if block 1 1 1 chest{BlockEntityTag:{Items:[{Slot:0b,id:"minecraft:아이템",Count:1b}]}} run ...이런 식으로 상자의 내용을 감지할 수 있다. 슬롯 번호는 플레이어의 인벤토리의 번호와 같다. 위 명령어처럼 execute를 쓸 땐 BlockEntityTag는 없어도 된다.
다양한 예시들:
-
/give @s chest{BlockEntityTag:{Items:[{Slot:2b,id:"minecraft:netherite_axe",Count:64b,tag:{Enchantments:[{id:"minecraft:sharpness",lvl:2147483647}]}]}}- 등급 2147483646의 날카로움 마법이 부여된 네더라이트 도끼가 2번 슬롯에 64개 들어있는 상자를 지급 -
/give @s chest{BlockEntityTag:{Items:[{Slot:4b,id:"minecraft:acacia_log",Count:1b,tag:{CanPlaceOn:[id:"minecraft:grass_block"]}}]}}- CanPlaceOn NBT가 붙은 상자 주기
5.2.2. LootTable[편집]
구조물 상자를 불러오는 태그. BlockEntityTag에 붙는다.
예)
{BlockEntityTag:{LootTable:"minecraft:chests/마크chests파일"}}ex) 엔드 도시 상자:
minecraft:chest{BlockEntityTag:{LootTable:"minecraft:chests/end_city_treasure"}}5.3. BlockStateTag[편집]
6. tag[편집]
6.1. display[편집]
다음과 같은 속성을 설정할 수 있다.
Name: 아이템의 이름 (JSON 문법을 사용해야 한다.)
Lore: 아이템의 설명 (JSON 문법을 사용해야 한다.)
형식:
{display:{Name:'{"text":"이름"}',Lore:['{"text":"아이템 설명"}']}} 또는 {display:{Name:"{\"text\":\"이름\"}",Lore:["{\"text\":\"설명\"}"]}}아이템 설명에서 줄바꿈을 하고 싶다면
{display:{Lore:['{"text":"아이템 설명"}','{"text":"아이템 설명"}']}}이런식으로 해주면 된다
위에 있는 방법이 안될 시 {display:{Lore:["\"아이템 설명\""]}} 형식으로 해보길 추천
6.1.1. color[편집]
display안에 있는 태그로 가죽 아이템들의 색깔을 정할 수 있다.
형식: {display:{color:컬러값}}
16777215[10]를 초과한 수치를 넣었을 때, 기본적인 가죽 색깔로 변한다.
마인크래프트의 색깔 코드는 16진수 형태의 색을 10진수로 바꾼 것이다. [11]
ex) FF00FF(보라색) => 16711935
6.1.2. MapColor[편집]
display안에 있는 태그로 지도아이템의 색깔을 정할수 있다.
형식: {display:{MapColor:컬러값}}
색깔은 위와 같이 16진수 형태의 색을 10진수로 바꾼것이다.
해양 탐험 지도: {display:{MapColor:3830373}}
삼림 탐험 지도: {display:{MapColor:5393476}}
6.1.3. 기타[편집]
true로 하면 적용되고, false로 하면 그대로 된다.-
Bold: 글자를 굵게 만든다. -
Italic: 글자를 이탤릭체로 만든다. -
Underlined: 글자에 밑줄을 만든다. -
Strikethrough: 글자에 취소선을 만든다. -
Obfuscated: 글자를
(으)로 바꾼다.
(으)로 바꾼다.6.2. Enchantments[편집]
특정 아이템을 마법 부여할 때 쓴다. 일반적으로 해당 마법부여를 할 수 없는 아이템도 강제로 마법부여가 가능하다. 또한 같은 마법 부여를 겹칠 수 있다.
형식:
{Enchantments:[{id:"마법부여 아이디",lvl:마법부여 레벨b},{id:"마법부여 아이디",lvl:마법부여 레벨b}, ...]}[12] 아이디는 아래에 있다. 자세한 효과는 마인크래프트/마법 부여 참조. minecraft:를 생략하면 효과는 같지만 별개로 인식된다. 레벨에는 숫자를 입력하면 된다. 입력값은 레벨에 1:1 대응한다. 음수나 0이나 255를 넘는 값을 레벨로 입력할 경우 1과 같은 효과가 나타난다.그리고
Enchantments:[{}]라고 입력하면 마법효과가 없이 마법부여된 것처럼 빛이 일렁이는 아이템을 만들 수 있다.아래는 마법부여 아이디 목록이다.
예시) 날카로움 10, 발화 10인 다이아몬드 검일 경우
give @s diamond_sword{Enchantments:[{id:"minecraft:sharpness",lvl:10b},{id:"minecraft:fire_aspect",lvl:10b}]}6.2.1. StoredEnchantments[편집]
마법이 부여된 책의 마법부여를 정할 때 쓴다. 자세한 형식은 Enchantments 문서 참조.
6.3. HideFlags[편집]
아이템의 태그를 숨길 수 있다. 마법부여, CanDestroy 등이 들어간 아이템에는 설명이 붙는데, 이것을 보이지 않게 해 준다.
형식:
{HideFlags: 수 } - 입력 방식이 조금 특이하다. 아래의 태그에 맞는 수를 모두 더해서 입력해야 한다.- 마법 부여:
1 - AttributeModifiers 태그:
2 - Unbreakable:
4 - CanDestroy:
8 - CanPlaceOn:
16 - 기타 등등:
32 - 가죽장비 염색:
64 - 갑옷 장식:
128
만약 유리를 부술 수 있고 내구도가 무한인 철 검이 있을 때 그 설명을 숨기게 하려면,
{HideFlags:12}라는 태그를 넣으면 된다.[13][14]모두 숨기게 하려면
HideFlags:255를 적으면 된다.6.4. RepairCost[편집]
6.5. 글이 쓰인 책 전용[편집]
6.5.1. author[편집]
쓴 사람을 정한다.
형식:
{author:"<쓴 사람>"}6.5.2. generation[편집]
0은 원본이며 1은 원본의 복사본, 2는 복사본의 복사본, 3은 낡음이다.
형식:
{generation:<숫자>}6.5.3. title[편집]
책의 제목을 정한다.
형식:
{title:"<제목>"}6.5.4. pages[편집]
글이 쓰인책이라는 아이템은 책과 깃펜으로 쓴 책을 말한다. 아이템 이름은 written_book.
give같은 명령어로 내용이 있는 책을 주고싶은 등의 경우에 쓰인다.
형식:
{pages:['(json 텍스트)','(두번째 페이지의 json 텍스트'... ... ],title:"제목",author:"저자이름",resolved:1b}참고로 책의 내용을 입력할때 \\n을 입력하면 줄이 바뀐다.
태그를 잘못 입력했을 때, 책의 이름이 글이 쓰인 책으로 바뀜과 동시에 내용이 *잘못된 책 태그입니다.*라고 빨간색으로 입력이 돼있다.
예시 : test라는 글이 쓰인 책을 얻을때
/give @p written_book{title:"",author:"",pages:['[{"text":"test"}]']} 16.6. 폭죽 전용[편집]
이 밑의 nbt는 {Fireworks:{<nbt>}} 의 괄호 안에 적어야한다.
ex:
{Fireworks:{Explosions:[{Type:3,Flicker:0,Trail:1,Colors:[I;5635925],FadeColors:[I;11141120]}]}}오류가 난다면 {FireworksItem:{id:firework_rocket,Count:1b,tag:{Fireworks:{Explosions:[{Type:3,Flicker:0,Trail:1,Colors:[I;5635925],FadeColors:[I;11141120]}]}}}} 이렇게 해보자. 석궁에도 이렇게 넣어보자.
6.6.1. Flight[편집]
폭죽의 활강시간을 정한다. -128에서 127 사이이며 이외에 숫자를 적을시 저 사이에 숫자가 나온다.
형식:
Flight:<value>6.6.2. Explosions[편집]
폭죽이 터질때 모양, 색깔등을 정한다.
형식:
Explosions:[{Type:3,Flicker:0,Trail:1,Colors:[I;5635925],FadeColors:[I;11141120]}]6.6.2.1. Type[편집]
폭죽이 터질때 모양을 정한다.
Explosions 괄호 안에 써야된다.
형식
Type:<value>- 0 : 작은 공모양
- 1 : 큰 공모양
- 2 : 별모양
- 3 : 크리퍼 얼굴 모양
- 4 : 삼각형으로 터지는 모양
이 표에 없는 수를 넣는다면, 타입 0으로 강제변환된다.
6.6.2.2. Colors[편집]
폭죽이 터질때 색깔을 정한다.
Explosions 괄호 안에 써야된다.
형식:
Colors:[I;<value>]<value>에는 색깔코드가 들어가는데 16진수 헥스 코드를 10진수로 변환한 값을 써야된다.
예를들어 빨간색을 넣고싶다면,
ff0000 => 16711680
6.6.2.3. FadeColors[편집]
폭죽이 터지고나서 끝날때 색깔을 정한다
Explosions 괄호 안에 써야된다.
형식
FadeColors:[I;<value>]<value>에 들어갈 값은 위의 color 태그와 같다.
6.6.2.4. Flicker[편집]
폭죽에 반짝이는 효과를 준다.
형식:
Flicker:1b6.6.2.5. Trail[편집]
폭죽에 잔상 효과를 준다.
형식:
Trail:1b6.7. 플레이어 머리 전용[편집]
6.7.1. SkullOwner[편집]
특정 플레이어의 머리를 얻을 때 사용하는 태그이다. 플레이어 머리(
player_head)만 적용된다.예:
/give @a minecraft:player_head{SkullOwner: Minecraft} 1 → 모든 플레이어에게 이름이 Minecraft인 플레이어의 머리 1개를 지급한다.재미있는 점은 해당 플레이어가 자신의 월드에 있지 않아도 명령어를 이용해 해당 플레이어의 머리를 가져올 수 있다는 것이다. 즉, 본인과 전혀 관련없는 저 멀리 해외 유저의 머리도 가져올 수 있다. 스킨 변경을 마인크래프트 런처나 공식 사이트에서만 할 수 있어서, 스킨이 마인크래프트 서버에 저장되기 때문이다.[15]
6.8. 쇠뇌 전용[편집]
6.8.1. ChargedProjectiles[편집]
쇠뇌에 장착되는 아이템을 바꿔주는 태그이다.
화살이나 폭죽을 올릴 수 있다.
사용법은
{ChargedProjectiles:[{id:"minecraft:아이템 명"}]} 이다.폭죽의 데이터태그를 바꾸려면 폭죽의 데이터태그를 그대로 가져오면 된다.
{ChargedProjectiles:[{id:"minecraft:firework_rocket",Count:3b,tag:{Fireworks:{Flight:(비행 길이)b,Explosions:[{Type:(폭발의 타입)b,Colors:[I;(색의 코드)]}]} }}],Charged:1b}}]} 이런 식으로 입력하게 되면 원하는 색과 모양의 폭죽이 장착이 된다.Type에 5 이상 넣으면 강제로 Type 0으로 변환된다.
6.9. 물약 전용[편집]
이 사이트에서 쉽게 만들 수 있다.
6.9.1. custom_potion_effects[편집]
물약의 속성을 바꿔주는 태그이다
custom_potion_effects:[{id:"포션이름"[* [[마인크래프트/상태 효과]] 참고],amplifier:포션강도,duration:지속시간}, {id:"포션이름",amplifier:포션강도,duration:지속시간}, ...] 의 꼴로 작성하며, Enchantment와 유사하게 여러 효과를 중첩시킬 수 있다.
6.9.1.1. show_particles[편집]
custom_potion_effects의 하위 태그
입자가 보일지 정한다. 1b는 보이고 0b는 보이지 않는다.
형식:
show_particles:숫자b6.9.1.2. ambient[편집]
custom_potion_effects의 하위 태그
신호기의 버프처럼 우측 상단 틀이 빛나고 깜박이지 않는다. 1b:활성화, 0b:비활성화
형식:
ambient:숫자b6.9.1.3. show_icon[편집]
custom_potion_effects의 하위 태그
현재 받고있는 효과의 아이콘이 화면에 보여지는지 설정한다. 1은 보이고 0은 보이지 않는다
형식:
show_icon:숫자(true|false)6.9.2. Custom_Potion_Cloor[편집]
포션의 색을 정하는 태그이다
형식:
{Custom_Potion_Color:색의 코드}색의 코드는 -2147483648 ~ 2147483647만 가능하다
6.10. 수상한 스튜 전용[편집]
6.10.1. Effects[편집]
수상한 스튜의 속성을 바꿔주는 태그이다.
6.11. (사용자 지정 NBT)[편집]
아이템은 사용자 지정 NBT를 추가할 수 있다. 아래는 작성 예시이다.
형식:
{NamuByte:1b, NamuShort:32767s, NamuInt:2147483647, NamuLong:673l, NamuFloat:1.01f, NamuDouble:10.01d, NamuString:"나무위키"}[1] 다만 UUID는 어느정도 마음대로 적어도(예: I; -50000,20000,10000,36500) 크게 상관없다. 위 사이트에서도 확인을 할때마다 값을 바꾸지 않아도 UUID가 계속 바뀌는 것을 확인할 수 있다.[2]
Slot:"mainhand"[3] AttributeName:"generic.attack_damage"[4] Amount:900[5] - 2^31[6] 2^31 -1[7] 0은 효과가 없고 -20 이하부터는 체력이 0이라서 대미지를 입으면 즉사다.[8] 0으로 한 경우는 몹이 플레이어를 인식할 수 없게 되어 붙어있는 것이 아니면 대미지도 주지 못한다.[9] 최대 대미지로[정보] A B 왼손 모드를 쓰면 반전된다.[10] 2^24 -1[11] 구글에서 "컬러 피커"라고 검색하면 16진수 색깔 코드를 손쉽게 얻을 수 있다. 이를 10진수로 변환하면 마인크래프트의 색깔 코드를 얻어낼 수 있다.[12] 한 번에 마법부여를 여러 개 달고 싶을 때를 감안한다. 마법부여 여러 개를 중괄호({ })로 나열한 다음 그걸 대괄호(\[ \])로 묶어서 처리하는 식. NBT에서 한 번에 다중의 태그를 달 때 쓰이는 형식이므로 기억해 두면 좋다. 참고로 태그를 하나만 달 때도 반드시 대괄호를 쳐 줘야 한다.[13] CanDestroy (8) + Unbreakable (4)[14] 이 숫자들은 2^n의 형태를 가지고 있기 때문에 가능한 모든 경우의 수에 대하여 겹치는 값이 하나도 없다.[15] 그래서 네트워크에 연결되지 않은 상태에서 가져오려고 하면 그냥 일반 머리가 불러와진다.