최근 수정 시각 : 2024-09-13 14:06:12

마인크래프트/NBT



파일:나무위키+유도.png  
은(는) 여기로 연결됩니다.
BE의 NBT에 대한 내용은 마인크래프트/명령어 문서
를
의 번 문단을
의 give 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
, 에 대한 내용은 문서
를
의 번 문단을
의 번 문단을
의 부분을
의 부분을
참고하십시오.
파일:상위 문서 아이콘.svg   상위 문서: 마인크래프트
※ JE의 최신버전인 1.20.5 기준이며, 상하위 버전에 맞지 않는 태그가 있을 수 있습니다.

파일:마인크래프트 로고.svg
{{{#!wiki style="margin: -0px -10px -5px; min-height:calc(1.5em + 5px)"
{{{#!folding [ 펼치기 · 접기 ]
{{{#!wiki style="margin: -5px -1px -11px; word-break:keep-all"		<colbgcolor=darkgreen><colcolor=#fff> 기본 플레이
시스템세계 (시드) · 게임 모드 · 난이도 · 게임 규칙 · 엔딩 · 죽음 메시지 · 스플래시 · 명령어 · NBT · 런처
인게임아이템 · 몹 (플레이어) · 개체 · 날씨 · 차원 · 생물군계 · 구조물 · 마법 부여 · 상태 효과 · 조작법 · 피해 · 업적
도움말튜토리얼 · 팁 (탐험 · 파밍 · 회로) · 재생 가능한 자원 · 브릿징 · PVP · 파쿠르 · 스피드런 · 건축
시리즈 및 매체
출시 에디션자바 에디션 (업데이트) · 베드락 에디션 (업데이트) · 포켓 에디션* · 콘솔 에디션* · 파이 에디션*
파생 게임마인크래프트 던전스* · 마인크래프트 레전드* · 마인크래프트 에듀케이션 · 마인크래프트: 스토리 모드* · 마인크래프트 어스*
미디어OST · 관련 서적 · 레고 · 영화 · 애니메이션 · Minecraft Live · Minecraft Now · Minecraft Monthly
유저 콘텐츠
창작 요소2차 창작 · 망토 · 맵 · 모드 (개발 · 팁 · 모드팩) · 애드온 · 팩 (리소스 팩 · 데이터 팩) · 외부 프로그램 · 핵
멀티 콘텐츠멀티플레이 · 서버 · 플러그인 · Realms · EULA
개발개발 기초 · 모드 개발 · 플러그인 개발
기타
이야깃거리여담 · 커뮤니티 · 사건 사고 · 문제점 · 용어 · 지원 언어 · 머나먼 땅 · 이미테이션 게임 · 히로빈
관련 문서나무위키 마인크래프트 프로젝트 · 마인크래프트로 분류된 문서 · 마인크래프트의 하위 문서
* 표시는 서비스가 종료되었거나 개발이 중단되었다는 표시이다. }}}}}}}}}

파일:external/hydra-media.cursecdn.com/Armor_Stand.png
엔티티 		파일:minecraft Pig.png
몹
(ㄱ~ㅅ · ㅇ~ㅎ · 플레이어) 		파일:마인크래프트/상자.png
블록 엔티티 		파일:마인크래프트/신호기.png
세계

1. 개요2. 사용 방법3. 데이터 형식4. 개체(엔티티) 전용
4.1. 몹 전용
4.1.1. 플레이어 전용
5. 블록 엔티티(타일 엔티티) 전용6. 세계 전용7. NBT 변경 내역
7.1. 1.13 이후7.2. 1.12
8. 관련 문서

1. 개요

NBT는 Named Binary Tag의 약자로, 마인크래프트 내의 각종 데이터를 저장하는데 쓰이는 형식이다. 이 문서는 마인크래프트의 명령어에서 쓰이는 NBT 태그를 나열하는 문서이다. 기본적으로 NBT 문법으로 되어 있다. 쓸 때는 JSON 문법처럼 쓰면 된다. 단, 이름 공간에는 큰따옴표(")로 감싸면 안 된다. 현재 수많은 NBT가 있으며, 아직까지 나무위키에 기록되지 않은 NBT도 있다.

참고로, 'NBT 태그'는 겹말이다. "Named Binary Tag 태그'가 되기 때문. 따라서 부를 때에는 LPG의 예처럼 NBT라고 부르거나 NB 태그라고 불러야 한다. 원칙은 그렇지만, 'NBT 태그'라고 부르는 게 관용어처럼 되어서 사실상 외국인들을 포함한 많은 사람들이 이렇게 부른다.
베드락 에디션에는 거의 없다는 잘못된 정보가 있는데,이는, 구성 요소에 대한 정보로,아이템 NBT는 Data와 component론 나뉘어저 있고,블록 개체 NBT는 수정 불능이고,몹 NBT는 대부분이 수정불능이지만 spawn event가 된 것들이 있는데 여전히 많디... 수정 블능은 어디까지나 애드온 또는 앱으로만 가능하다는 뜻이고 진짜 수정불능은 기반암 드롭 불가능 등이다. 툴박스라는 핵앱으로만 가능하다.툴박스는 모바일전용.

2. 사용 방법

  • 명령어 내의 아이템 아이디에 붙여서 JSON 리터럴(중괄호 { } ) 내에 쓰면 된다.
  • 몇몇 명령어에 따로 있는 데이터 태그 입력 칸에 JSON 리터럴(중괄호 { } ) 내에 쓰면 된다.
  • 배열 및 태그 구분자는 ' , '(쉼표)이다.
  • @p 등의 선택자는 [nbt={ 태그 }]와 같이 쓰면 된다.
  • 태그는 기본적으로 대소문자를 구분한다. 예를 들어 Unbreakable 태그를 unbreakable이라고 치면 게임에서 인식을 하지 못한다.
  • Unbreakable 같은 태그에 붙는 숫자는 true, false로 적어도 가능하다. 0은 false, 0이 아니면 true이기 때문이다. [1]
  • 마인크래프트에서 시간을 쓸때 틱 단위를 쓰는데 이것은 마인크래프트의 기본 시간 단위이다. 모든 상호작용과 모든 블록의 변화와 모든 반복 명령어가 1틱에 한 번씩 일어난다. 1틱=0.05초이다. 즉 1초는 20틱. 다만 온라인 플레이 시 인터넷 연결 상태, 서버 상태 또는 PC 상태가 좋지 않다면 0.05초보다 길어질 수 있다.

3. 데이터 형식

<rowcolor=#000> 형식 설명 포맷 예시

-128 ~ 127(포함) 범위의 부호 있는 8비트 정수 <숫자>b 또는 <숫자>B 54B, -10b

-32,768 ~ 32,767(포함) 범위의 부호 있는 16비트 정수 <숫자>s 또는 <숫자>S 31523S, -13243s

-2,147,483,648 ~ 2,147,483,647(포함) 범위의 부호 있는 32비트 정수 <정수형 숫자>[2] 31415926

-9,223,372,036,854,775,808 ~ 9,223,372,036,854,775,807(포함) 범위의 부호 있는 64비트 정수 <숫자>l 또는<숫자>L 31415926l

-3.4E+38 ~ +3.4E+38 범위의 32비트 단정밀도 부동소수점 <숫자>f 또는<숫자>F 3.1415926f

-1.7E+308 ~ +1.7E+308 범위의 64비트 배정밀도 부동소수점 <Double형 숫자>[3], <숫자>d 또는<숫자>D 3.1415926

큰 따옴표로 묶인 문자. 쉼표, 대괄호, 중괄호 또는 공백이 없는 문자열의 경우 따옴표로 묶지 않아도 된다. 만약 문자열 안에 '나 "가 들어간다면, \'같이 앞에 를 붙여 표현해야 한다. "<문자열>" "나무위키 마인크래프트", "나무위키 \'마인크래프트\'", "나무위키 \"마인크래프트\""

대괄호로 묶여 쉼표로 구분되어 정렬된 태그 목록. 리스트에 소속된 태그는 모두 첫 번째 태그의 형식과 같아야 한다.[4] [값, 값, ...] [3.2, 64.5, 129.5]
중괄호로 묶여 쉼표로 구분되어 속성-값 쌍을 갖는 정렬된 목록. 각 소속 태그는 모든 유형이 가능하다. 참고로 <태그 이름>이 여기서 서술하는 NBT이다. {태그 이름:값, 태그 이름:값, ...} {X:3, Y:64, Z:129}

B; 그리고 그 뒤에 쉼표로 구분되어 8비트 정수(Byte 형식)가 오는 정렬된 목록. 태그는 대괄호로 묶는다. [B;<숫자>b, <숫자>B, ...] [B;1b,2b,3b]

I; 그리고 그 뒤에 쉼표로 구분되어 32비트 정수(Int 형식)가 오는 정렬된 목록. 태그는 대괄호로 묶는다. [I;<정수형 숫자>, <정수형 숫자>, ...] [I;1,2,3]

L; 그리고 그 뒤에 쉼표로 구분되어 64비트 정수(Long 형식)가 오는 정렬된 목록. 태그는 대괄호로 묶는다. [L;<숫자>l, <숫자>L, ...] [L;1l,2l,3l]

true 또는 false로 유무를 나타냄. Byte 태그로 변환이 가능하다. 0b(false), 1b(true) true, false 또는 0b, 1b {NamuTag:true}, {NamuTag:1b}

한 NBT 쌍{키: 값}의 값에는 형식에 맞는 값을 입력해야 한다.

4. 개체(엔티티) 전용

파일:상세 내용 아이콘.svg   자세한 내용은 마인크래프트/NBT/엔티티 문서
를
의 번 문단을
의 부분을
참고하십시오.

4.1. 몹 전용

파일:상세 내용 아이콘.svg   자세한 내용은 마인크래프트/NBT/몹 문서
를
의 번 문단을
의 부분을
참고하십시오.

4.1.1. 플레이어 전용

파일:상세 내용 아이콘.svg   자세한 내용은 마인크래프트/NBT/몹/플레이어 문서
를
의 번 문단을
의 부분을
참고하십시오.

5. 블록 엔티티(타일 엔티티) 전용

파일:상세 내용 아이콘.svg   자세한 내용은 마인크래프트/NBT/블록 엔티티 문서
를
의 번 문단을
의 부분을
참고하십시오.

6. 세계 전용

파일:상세 내용 아이콘.svg   자세한 내용은 마인크래프트/NBT/세계 문서
를
의 번 문단을
의 부분을
참고하십시오.

7. NBT 변경 내역

Breaking Changes은 [B]로 표시한다.

7.1. 1.13 이후

1.13 이후 내용은 데이터 팩 문서 참고.

7.2. 1.12

  • 추가
    • LastExecution
    • LoveCauseLeast - 번식할 수 있는 몹 전용 NBT. 몹을 번식시킨 플레이어의 UUID 뒷자리.
    • LoveCauseMost - 번식할 수 있는 몹 전용 NBT. 몹을 번식시킨 플레이어의 UUID 앞자리.
    • recipeBook[A], Recipes[A], enteredNetherPosition, seenCredits, ShoulderEntityLeft, ShoulderEntityRight, UpdateLastExecution
  • 변경
  • 삭제

8. 관련 문서

[1] 다만, Age 같은 경우는 숫자로 쓰지 않으면 인식하지 못한다.[2] 뒤에 아무것도 붙지 않는다.[3] 뒤에 아무것도 붙지 않는다.[4] 예를 들어 첫번째가 Byte형일 경우 → [1b, 3b, 7b, 2b][A] 1.12에 새로 추가된 레시피북 대응[A] 1.12에 새로 추가된 레시피북 대응

분류