최근 수정 시각 : 2024-04-03 21:49:32

마인크래프트/NBT



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

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

NBT 관련 문서
파일:마크 도구&전투 탭2.png
아이템
파일:external/hydra-media.cursecdn.com/Armor_Stand.png
엔티티
파일:minecraft Pig.png

( ㄱ~ㅅ · ㅇ~ㅎ · 플레이어)
파일:마인크래프트/상자.png
블록 엔티티
파일:마인크래프트/신호기.png
세계

1. 개요

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

참고로, 'NBT 태그'는 겹말이다. "Named Binary Tag 태그'가 되기 때문. 따라서 부를 때에는 LPG의 예처럼 NBT라고 부르거나 NB 태그라고 불러야 한다. 원칙은 그렇지만, 'NBT 태그'라고 부르는 게 관용어처럼 되어서 사실상 외국인들을 포함한 많은 사람들이 이렇게 부른다.

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/아이템 문서
번 문단을
부분을
참고하십시오.

5. 개체(엔티티) 전용

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

5.1. 몹 전용

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

5.1.1. 플레이어 전용

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

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

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

7. 세계 전용

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

8. NBT 변경 내역

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

8.1. 1.13 이후

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

8.2. 1.12

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

9. 관련 문서


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