마인크래프트/NBT/몹/플레이어

※ JE의 최신버전인 1.19 기준이며, 상하위 버전에 맞지 않는 태그가 있을 수 있습니다.


{{{#!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
개발	개발 기초 · 모드 개발 · 플러그인 개발
기타
이야깃거리	여담 · 커뮤니티 · 사건 사고 · 문제점 · 용어 · 지원 언어 · 머나먼 땅 · 이미테이션 게임 · 히로빈
관련 문서	나무위키 마인크래프트 프로젝트 · 마인크래프트로 분류된 문서 · 마인크래프트의 하위 문서
* 표시는 서비스가 종료되었거나 개발이 중단되었다는 표시이다.		}}}}}}}}}

NBT 관련 문서
엔티티	몹 (ㄱ~ㅅ · ㅇ~ㅎ · 플레이어)		블록 엔티티	세계

1. 개요2. abilities3. EnderItems4. Inventory

4.1. Slot

5. recipeBook

5.1. recipes5.2. toBeDisplayed5.3. isFilteringCraftable5.4. isFurnaceFilteringCraftable5.5. isFurnaceGuiOpen5.6. isGuiOpen

6. SelectedItem7. SelectedItemSlot8. DataVersion9. Dimension10. foodExhaustionLevel11. foodLevel12. foodSaturationLevel13. foodTickTimer14. LastDeathLocation15. playerGameType16. previousPlayerGameType17. Score18. seenCredits 19. ShoulderLeft20. ShoulderRight21. SpawnDimension22. SpawnX23. SpawnY24. SpawnZ25. SleepTimer26. RootVehicle27. warden_spawn_tracker28. XpLevel29. XpP30. XpSeed31. XpTotal

1. 개요

말 그대로 플레이어 전용 NBT이다. 플레이어의 인벤토리 슬롯의 아이템을 감지하는데에 쓰기 때문에 1.13 이상은 execute, 1.13 미만은 testfor을 사용해 쓸 수 있다. NBT 수정이나 삭제, 추가는 못한다.

모든 기본 값은 서바이벌 기준이다.

플레이어 전용 NBT

< 엔티티 공통 태그 >

단 다음과 같은 태그는 존재하지 않는다.

CustomName
CustomNameVisible
id

< 몹 공통 태그 >

단 다음과 같은 태그는 존재하지 않는다.

HandItems
ArmorItems
HandDropChances
ArmorDropChances
CanPickUpLoot
PersistenceRequired
Leash
NoAI

abilities <
Compound
>

flying<
Byte
>
flySpeed <
Float
>
instabuild <
Byte
>
invulnerable <
Byte
>
mayBuild <
Byte
>
mayfly <
Byte
>
walkSpeed <
Float
>

DataVersion <
Int
>
Dimension <
String
>
EnderItems <
List
>

<
Compound
>

< 아이템 >

enteredNetherPosition <
Compound
>

x <
Double
>
y <
Double
>
z <
Double
>

foodExhaustionLevel <
Float
>
foodLevel <
Int
>
foodSaturationLevel <
Float
>
foodTickTimer <
Int
>
Inventory <
List
>

<
Compound
>

< 아이템 >

LastDeathLocation <
Compound
>

dimension <
String
>
pos <
Int Array
>

playerGameType <
Int
>
previousPlayerGameType <
Int
>
recipeBook <
Compound
>
RootVehicle <
Compound
>
Score <
Int
>
seenCredits <
Byte
>
SelectedItem <
Compound
>
SelectedItemSlot <
Int
>
ShoulderEntityLeft <
Compound
>

이하 모든 태그는 엔티티와 같다.

ShoulderEntityRight <
Compound
>

이하 모든 태그는 엔티티와 같다.

SleepTimer <
Short
>
SpawnDimension <
String
>
SpawnForced <
Byte
>
SpawnX <
Int
>
SpawnY <
Int
>
SpawnZ <
Int
>
warden_spawn_tracker <
Compound
>

cooldown_ticks <
Int
>
ticks_since_last_warning <
Int
>
warning_level <
Int
>

XpLevel <
Int
>
XpP <
Float
>
XpSeed <
Int
>
XpTotal <
Int
>

2. abilities

<colbgcolor=#40CFFF> abilities
`{abilities:{...}}`
<colcolor=#000> 기능			플레이어가 가진 속성..
사용 대상			플레이어
기본값
관련 NBT 태그			-
유형			Compound

플레이어가 가진 속성.

NBT 구조

abilities - <
Compound
>

walkSpeed - <
Float
> - 걷는 속도. 기본값은 0.1이며 상태 효과, Attribute 등 속도를 늘려도 절대로 변하지 않는다.
flySpeed - <
Float
> - 비행 속도. 기본값은 0.05
mayfly - <
Byte
> - 비행 가능 여부. 1이면 날 수 있다. 기본값은 0
flying <
Byte
> - 비행 중인 여부. 1이면 현재 비행 중이다. 기본값은 0
invulnerable - <
Byte
> - 무적 여부. 공허 피해를 제외한 모든 피해와 디버프 면역이면 1이다. 기본값은 0
mayBuild - <
Byte
> - 블록 상호작용 여부. 상호작용이 가능할 경우 1이다. 기본값은 1
instabuild - <
Byte
> - 블록 즉시 파괴 여부. 블록을 즉시 파괴할 수 있는 경우 1이다. 기본값은 0

3. EnderItems

EnderItems
`{EnderItems:[{id:"<아이템 아이디>"}]}`
기능			플레이어의 엔더 상자
사용 대상			플레이어
기본값			?
관련 NBT 태그			Inventory

플레이어의 엔더 상자에 있는 아이템을 감지하는 태그이다. 세부 사항은 Inventory와 같다.

4. Inventory

Inventory
`{Inventory:[{id:"<아이템 아이디>"}]}`
기능			플레이어의 인벤토리
사용 대상			플레이어
기본값			?
관련 NBT 태그			EnderItems

플레이어의 인벤토리에 있는 아이템을 감지하는 태그이다.

쓰는 방법은 {Inventory:[{id:"minecraft:아이디"}]} 이다.
위의 Item하고 비슷한 사용방법이다.
인벤토리가 있는 블록의 경우, 이 NBT 태그가 아닌 Items 태그를 이용한다. 사용법은 Inventory 자리에 Items를 넣으면 된다.

4.1. Slot

Slot
`{Inventory:[{id:"minecraft:아이디",Slot:슬롯의 숫자b}]}`
기능			플레이어의 인벤토리
사용 대상			플레이어
기본값			?
관련 NBT 태그			EnderItems, Inventory

태그 Inventory에 딸려오는 태그.
인벤토리의 어느 슬롯에 이 아이템이 있는지 감지할 수 있다.

쓰는 방법은 {Inventory:[{id:"minecraft:아이디",Slot:슬롯의 숫자b}]} 이다.
인벤토리의 숫자는 아래의 사진을 참고하여 보면 된다.

추가로, Slot 명령어는 플레이어 전용 NBT태그에 모두 쓸 수 있는 명령어이다. 뒤에 id가 붙는다 싶으면 그 뒤에 Slot도 같이 따라서 쓸 수 있다.

5. recipeBook

5.1. recipes

5.2. toBeDisplayed

5.3. isFilteringCraftable

5.4. isFurnaceFilteringCraftable

5.5. isFurnaceGuiOpen

화로 제작법 책 연 경우 1이다.

5.6. isGuiOpen

제작 제작법 책 연 경우 1이다.

6. SelectedItem

<colbgcolor=#40CFFF> SelectedItem
`{SelectedItem:{...}}`
<colcolor=#000> 기능			현재 들고있는 아이템
사용 대상			플레이어
기본값			(비어있음)
관련 NBT 태그			`SelectedItemSlot`, `Inventory`. `HandItems`
유형			Compound

플레이어가 현재 들고있는 아이템을 감지할 수 있는 태그이다. 플레이어를 제외한 몹에겐 이 태그가 아닌 HandItems 태그가 역할을 대신한다.
예시1: {SelectedItem:{id:"minecraft:stone"}}

7. SelectedItemSlot

<colbgcolor=#40CFFF> SelectedItemSlot
`{SelectedItemSlot:{...}}`
<colcolor=#000> 기능			현재 선택한 핫바 슬롯
사용 대상			플레이어
기본값			`0`
관련 NBT 태그			`SelectedItem`
유형			Int

플레이어가 핫바 슬롯이 어디인지 감지한다. 핫바 첫번째 슬롯이면 0이다.

구문: {SelectedItemSlot:인벤토리의 숫자}

부가적인 설명이지만, 기본적으로 핫바의 첫번째 슬롯은 데이터코드가 0이다. 고로 내가 쓰고싶은 핫바 칸 수에서 1을 빼주면 데이터코드를 쉽게 찾을 수 있다.

8. DataVersion

<colbgcolor=#40CFFF> DataVersion
`{DataVersion:값}`
<colcolor=#000> 기능			마인크래프트 버전 ID
사용 대상			플레이어
기본값			(버전에 따라 다름)
관련 NBT 태그			-
유형			Int

기본값은 현재 플레이중인 버전에 따라 다르다. 값은 다음과 같다.

버전	값
1.21.4 1.21.3 1.21.2 1.21.1 1.21	4189 4082 4080 3955 3953
1.20.6 1.20.5 1.20.4 1.20.3 1.20.2 1.20.1 1.20	3839 3837 3670 3698 3578 3465 3463
1.19.4 1.19.3 1.19.2 1.19.1 1.19	3337 3218 3120 3117 3105
1.18.2 1.18.1 1.18	2975 2865 2860
1.17.1 1.17	2730 2724
1.16.5 1.16.4 1.16.3 1.16.2 1.16.1 1.16	2586 2584 2580 2578 2567 2566
1.15.2 1.15.1 1.15	2230 2227 2225
1.14.4 1.14.3 1.14.2 1.14.1 1.14	1976 1968 1963 1957 1952
1.13.2 1.13.1 1.13	1631 1628 1519
1.12.2	1343
1.11.2	922
1.10.2	512
1.9.4	184
≤1.8.9	(없음)

9. Dimension

Dimension
`{Dimension:"문자열"}`
기능			차원 어디에 있는지 확인
사용 대상			플레이어
기본값			minecraft:overworld
관련 NBT 태그			Pos, Rotation

플레이어의 차원을 감지한다. minecraft:the_nether는 네더, minecraft:overworld는 오버월드(지상), minecraft:the_end는 엔드이다. 모드나 만우절 버전, 데이터팩 등으로 추가된 차원은 이 외의 문자열을 가진다.

형식: {Dimension:"문자열"}

10. foodExhaustionLevel

foodExhaustionLevel
`{foodExhaustionLevel:0f}`
기능			플레이어의 배고픔 최소 수치(?)
사용 대상			플레이어
기본값			0.0f
관련 NBT 태그			foodLevel, foodSaturationLevel, foodTickTimer

행동에 따라 증가하며 이 값이 4이상 될시 포만감(foodSaturationLevel) 또는 배고픔(foodLevel)이 1 줄어든다.

11. foodLevel

foodLevel
`{foodLevel:20}`
기능			플레이어의 배고픔 수치
사용 대상			플레이어
기본값			20
관련 NBT 태그			foodExhaustionLevel, foodSaturationLevel, foodTickTimer

배고픔 수치를 감지한다. 반칸당 1이다. 20은 배고픔 꽉 찬 상태.

형식:{foodLevel:숫자}

12. foodSaturationLevel

foodSaturationLevel
`{foodSaturationLevel:5.0f}`
기능			플레이어의 포만감 수치
사용 대상			플레이어
기본값			5.0f
관련 NBT 태그			foodExhaustionLevel, foodLevel, foodTickTimer

포만감 수치를 감지한다. 1 ~ 20

형식:{foodSaturationLevel:숫자}

13. foodTickTimer

foodTickTimer
`{foodTickTimer:0f}`
기능			?
사용 대상			플레이어
기본값			?
관련 NBT 태그			foodExhaustionLevel, foodLevel, foodSaturationLevel

14. LastDeathLocation

<colbgcolor=#40CFFF> LastDeathLocation
`{LastDeathLocation:{추가 문장}}`
<colcolor=#000> 기능			마지막으로 죽은 위치와 차원.
사용 대상			플레이어
기본값			없음.
관련 NBT 태그			`Pos`
유형			Compound

NBT 구조

LastDeathLocation <
Compound
>

pos <
Int Array
> - 마지막으로 죽은 위치.
dimension <
String
> - 마지막으로 죽은 차원.

마지막으로 사망한 플레이어의 위치와 차원을 확인한다. 죽은 적이 없거나 죽은 곳이 다른 차원일 경우 만회 나침반이 무작위로 회전한다.

15. playerGameType

playerGameType
`{playerGameType:0}`
기능			플레이어의 게임 모드
사용 대상			플레이어
기본값			0
관련 NBT 태그			previousPlayerGameType

플레이어의 게임모드를 확인한다. 0은 서바이벌, 1은 크리에이티브, 2는 모험 모드, 3은 관전 모드이다.

16. previousPlayerGameType

previousPlayerGameType
`{previousPlayerGameType:0}`
기능			플레이어의 이전 게임 모드
사용 대상			플레이어
기본값			?
관련 NBT 태그			playerGameType

플레이어의 이전 게임 모드. 설명은 playerGameType와 같다.

17. Score

사망시 표시되는 점수

18. seenCredits

seenCredits
`{seenCredits:0b}`
기능			플레이어 엔딩 여부
사용 대상			플레이어
기본값			0b
관련 NBT 태그			-

엔딩을 봤는지 여부. 봤다면 1이다.

19. ShoulderLeft

앵무새가 플레이어의 왼쪽 어깨에 앉았을 때 그 앵무새의 NBT

20. ShoulderRight

앵무새가 플레이어의 오른쪽 어깨에 앉았을 때 그 앵무새의 NBT

21. SpawnDimension

SpawnDimension
`{SpawnDimension:"<차원>"}`
기능			부활하는 차원 위치?
사용 대상			플레이어
기본값			<비어 있음>
관련 NBT 태그			SpawnX, SpawnY, SpawnZ

플레이어의 침대 또는 리스폰 정박기의 차원이다. 존재하지 않을 수 있다.

22. SpawnX

SpawnX
`{SpawnX:0}`
기능			부활하는 X 좌표
사용 대상			플레이어
기본값			<비어 있음>
관련 NBT 태그			SpawnDimension, SpawnY, SpawnZ

플레이어의 침대 또는 리스폰 정박기의 X 좌표이다. 존재하지 않을 수 있다.

23. SpawnY

SpawnY
`{SpawnY:0}`
기능			부활하는 Y 좌표
사용 대상			플레이어
기본값			<비어 있음>
관련 NBT 태그			SpawnDimension, SpawnX, SpawnZ

24. SpawnZ

SpawnZ
`{SpawnZ:0}`
기능			부활하는 Z 좌표
사용 대상			플레이어
기본값			<비어 있음>
관련 NBT 태그			SpawnDimension, SpawnX, SpawnY

25. SleepTimer

SleepTimer
`{SleepTimer:0s}`
기능			플레이어가 잠을 잔 시간.
사용 대상			플레이어
기본값			0s
관련 NBT 태그			-

플레이어가 잠을 잔 시간.

26. RootVehicle

플레이어가 타고있는 엔티티를 감지한다.

형식:{RootVehicle:{Entity:{id:"minecraft:엔티티"}}}

27. warden_spawn_tracker

warden_spawn_tracker
`{warden_spawn_tracker: 값}`
기능			플레이어를 대상으로 한 워든 스폰에 대한 데이터를 갖고 있다.
사용 대상			플레이어
기본값			{ }
관련 NBT 태그			-

NBT 구조

* warden_spawn_tracker <

Compound

cooldown_ticks <
Int
>
ticks_since_last_warning <
Int
>
warning_level <
Int
>

28. XpLevel

경험치 레벨을 확인한다. 32비트 변수이므로 2147483647가 최대 값이다.

29. XpP

경험치 막대에서 다음 레벨 진행률 / 백분율. 65.2%이면 0.652이다.

30. XpSeed

마법부여대에 사용되는 시드이다.

여담으로 1.14 이하 버전은 이 값이 0으로 고정되어 첫번째 마법 부여는 무조건 정해져 있다. 두번째부터는 랜덤이다.

마인크래프트/NBT/몹/플레이어

1. 개요

2. abilities

3. EnderItems

4. Inventory

4.1. Slot

5. recipeBook

5.1. recipes

5.2. toBeDisplayed

5.3. isFilteringCraftable

5.4. isFurnaceFilteringCraftable

5.5. isFurnaceGuiOpen

5.6. isGuiOpen

6. SelectedItem

7. SelectedItemSlot

8. DataVersion

9. Dimension

10. foodExhaustionLevel

11. foodLevel

12. foodSaturationLevel

13. foodTickTimer

14. LastDeathLocation

15. playerGameType

16. previousPlayerGameType

17. Score

18. seenCredits

19. ShoulderLeft

20. ShoulderRight

21. SpawnDimension

22. SpawnX

23. SpawnY

24. SpawnZ

25. SleepTimer

26. RootVehicle

27. warden_spawn_tracker

28. XpLevel

29. XpP

30. XpSeed

31. XpTotal

분류