마인크래프트/명령어/NBT

 




JE 1.16.1 기준이며, 상하위 버전에 맞지 않은 태그가 있을 수 있습니다.

1. 개요
2. 사용 방법
5. 블록 엔티티(타일 엔티티) 전용
5.1. 표지판 전용
5.1.1. Text(n)
5.2. 신호기 전용
5.2.1. Primary
5.2.2. Secondary
5.3. 명령 블록 전용
5.3.1. Command
5.3.2. auto
5.4. 인벤토리가 있는 블록 전용
5.4.1. CustomName
5.4.2. Lock
5.4.3. Items
5.5. 몬스터 스포너 전용
5.5.1. Delay
5.5.2. EntityId
5.5.3. MaxNearbyEntities
5.5.4. MaxSpawnDelay
5.5.5. MinSpawnDelay
5.5.6. RequiredPlayerRange
5.5.7. SpawnCount
5.5.8. SpawnData
5.5.9. SpawnPotentials
5.5.10. Type
5.5.11. Properties
5.5.12. SpawnRange
7. NBT 변경 내역
8. 추가 예정 NBT


1. 개요


마인크래프트의 명령어 내에 쓰이는 NBT 태그를 나열하는 문서이다. 기본적으로 NBT 문법으로 되어 있다. 쓸 때는 JSON처럼 쓰면 된다. 단, 이름공간에는 큰따옴표(")로 감싸면 안된다. 현재 수많은 NBT가 있으며 현재까지 나무위키에 없는 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. 아이템 전용


마인크래프트/명령어/NBT/아이템 문서 참조.

4. 개체(엔티티) 전용


마인크래프트/명령어/NBT/엔티티 문서 참조.

4.1. 몹 전용


마인크래프트/명령어/NBT/몹 문서 참조.

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


블록이 가지는 블록 엔티티에 붙어있는 태그이다. setblock 명령어나 fill 명령어로 설치할 수 있는 것에 해당한다. 돌이나 판자와 같이 블록 엔티티를 가지지 않는 블록은 NBT 태그 또한 가지지 않는다.

5.1. 표지판 전용



5.1.1. Text(n)


표지판의 n번째 텍스트를 적어준다
4번까지만 가능하다
예시 :
{Text1:'{"":""}'}


5.2. 신호기 전용



5.2.1. Primary


신호기가 지급하는 효과중 첫번째 효과를 정한다. 레벨은 1로 고정
형식:
{Primary:값}

값 내에는 마인크래프트/상태 효과에서 코드 값을 넣으면 된다.
하지만 실제로 신호기에 있는 효과가 아니면 효과가 걸리지 않는다.

5.2.2. Secondary


신호기가 지급하는 효과중 두번째 효과를 정한다.
첫번째 효과와 같다면 효과의 레벨이 2로 올라가고 아니면 레벨1의 새로운 효과가 걸린다.
Primary 와 마찬가지로 신호기에 없는 효과면 효과가 걸리지 않는다.
형식:
{Secondary:값}


5.3. 명령 블록 전용



5.3.1. Command


명령 블록에 입력된 명령어를 정한다.
형식:
{Command:" 명령어 "}

보통 커맨드 타워를 세울 때 falling_block{BlockState:< Name, data >에 Command를 인수한 상태로 떨어뜨리거나, Command_block testing등에 쓰인다.}


5.3.2. auto


명령 블록을 항상 활성화가 되도록 만들어주는 태그이다.
값이 1이면 항상 활성화, 값이 0이면 레드스톤 필요이다.
형식:
{auto:1b} 또는 {auto:true}이다.


5.4. 인벤토리가 있는 블록 전용


화로, 발사기같이 블록을 우클릭하면 작업 창이 보이는 블록에 설정 가능하다. 예외적으로 제작대(작업대)[2]는 블록 엔티티가 없기 때문에 NBT설정이 불가능하다.

5.4.1. CustomName


열 시에 보이는 이름을 설정한다. JSON 문법을 사용한다.
형식:
{CustomName:'{"text":"이름"}'}


5.4.2. Lock


상자를 잠글때 사용, 올바른 이름을 가진 아이템을 가지고 우클릭하지 않으면 열리지 않는다.
형식:
{Lock:"이름"}


5.4.3. Items


블록 안의 아이템을 감지하는데에 쓰인다. 사용법은 위의 Inventory와 동일하다.
여담으로 id 안에 minecraft:를 넣지 않으면 작동하지 않는다.
형식: {Items:[{id:"minecraft:블록 ID"},{id:"minecraft:블록 ID2"}]}

5.5. 몬스터 스포너 전용


'''경고''': 몬스터 스포너 관련 NBT 태그를 잘못 사용할 경우 '''무한 게임 크래시가 일어나 해당 세계에 들어갈 수 없는 현상이 생긴다.'''[3] 내용을 잘 숙지하고, 반드시 백업 세이브를 준비하기 바란다. 따라서 오류없이 만들 자신이 없다면 커맨드 제네레이터를 쓰는 것을 강력하게 추천하고, 버전이 낮거나 오류가 있는 커맨드 제네레이터는 쓰지 않는 것이 좋다.
data get block <좌표> 명령어로 다 확인할 수 있는거라 굳이 볼 필요는 없다. 좀 헷갈린다 싶을 때 보는것을 추천.

5.5.1. Delay


플래이어가 스포너로 충분히 가까히 들어왔을 때 부터 얼마 후에 엔티티를 소환할지를 정한다. (틱)

5.5.2. EntityId


소환할 엔티티의 이름을 정한다.

5.5.3. MaxNearbyEntities


스포너 주위에 얼마나 많은 스폰된 엔티티가 존재하게 할 것인지 지정한다. (결론적으로 최대 스폰양이다)

5.5.4. MaxSpawnDelay


첫 스폰이후 최대 몇초 후 (실제로는 틱) 다시 소환할지를 정한다.

5.5.5. MinSpawnDelay


첫 스폰 이후 최소 몇 초 후 (실제로는 틱) 다시 소환할지를 정한다.

5.5.6. RequiredPlayerRange


플레이어가 몇칸내에 들어왔을 때부터 소환할지를 정한다.

5.5.7. SpawnCount


한번에 소환할 숫자를 정한다.

5.5.8. SpawnData



5.5.9. SpawnPotentials



5.5.10. Type



5.5.11. Properties



5.5.12. SpawnRange


스폰될 범위를 정한다.

6. 세계 전용


마인크래프트/명령어/NBT/세계 문서 참조.

7. NBT 변경 내역


1.17
'''추가'''
Count, TicksFrozen
'''변경'''
.
'''삭제'''
.

1.16
'''추가'''
UUID, IsImmuneToZombification, Owner, Trusted, Target, Owner, LoveCause, Fixed, Invisible
'''변경'''
Dimension[4], AttributeModifiers, Attributes
'''삭제'''
owner[5], direction, OwnerUUID[6], TrustedUUIDs, target_uuid, LoveCauseLeast[LoveCause] , LoveCauseMost[LoveCause] , UUIDMost[UUID], UUIDLeast[UUID]

1.15
'''추가'''

'''변경'''

'''삭제'''


1.14
'''추가'''

'''변경'''

'''삭제'''


1.13
'''추가'''
Enchantments
'''변경'''

'''삭제'''
ench[7], Data

???
'''추가'''

'''변경'''

'''삭제'''



8. 추가 예정 NBT


'''Count'''
{Count:갯수}
'''기능'''
경험치 구슬이 얼마나 겹처져 있는지 확인.
'''사용 대상'''
경험치 구슬
'''관련 NBT'''
-

'''TicksFrozen'''
{TicksForozen:틱}
'''기능'''
얼고 있는 틱이다. 300부터 피해를 받는다
'''사용 대상'''
몹과 갑옷 거치대.
'''관련 NBT'''
Air
'''Variant'''
{Variant:숫자}
'''기능'''
아홀로틀의 변종 ID
'''사용 대상'''
Axolotl.
'''관련 NBT'''
-
[1] 다만, Age 같은 경우는 숫자로 쓰지 않으면 인식하지 못한다.[2] 이건 상자같이 내용물이 저장되는 것이 아닌 아이템을 제작할때 일시적으로 아이템이 들어가고 창을 닫으면 아이템이 다시 플레이어에게 돌아오기 때문이다.[3] 다만 외부 맵 에디터를 통해 잘못된 NBT 몬스터 스포너를 제거하면 해결된다.[4] Int → String[5] Owner로 이동됨[6] Owner로 이동됨[LoveCause] A B LoveCause로 통합[UUID] A B UUID로 통합[7] Enchantments로 이동