가이드 / 명령어 및 데이터

블록, 아이템, 엔티티 ID: 네임스페이스, 블록 상태, 그리고 서로 다른 것들

ID가 항상 아이템의 이름과 같지는 않으며, /setblock이 받는 블록 ID는 /give가 받는 아이템 ID와 다릅니다. 이름 규칙, 오래된 명령어를 깨뜨리는 이름 변경, 상태가 어디에 들어가는지 알아봅니다.

2026-06-23

"Unknown item"이나 "Unknown block"으로 실패하는 모든 명령어는 ID 문제이며, 규칙은 "소문자에 밑줄"보다 훨씬 미묘합니다.

데이터에서 네임스페이스는 선택 사항이 아닙니다

minecraft:diamond_sword
my_pack:custom_sword

명령어에서는 minecraft:를 생략할 수 있어서 /give @s diamond_sword도 작동하고, JSON 파일에서도 마찬가지입니다. 전리품 테이블이나 제작법에서 네임스페이스 없이 diamond_sword만 쓰면 minecraft:diamond_sword로 해석됩니다. 그래도 어디서나 네임스페이스를 쓰세요. 자신의 ID가 모호하지 않게 유지되고, 네임스페이스의 오타를 쉽게 발견할 수 있습니다.

블록 ID와 아이템 ID는 다른 것입니다

아이템이 없는 블록도 있고, 다른 블록을 설치하는 아이템도 있습니다:

/setblock은 블록 ID를 받습니다. /give는 아이템 ID를 받습니다. 잘못된 것을 사용하는 것이, 분명히 존재하는 것에 대해 "그 ID는 존재하지 않습니다"가 나오는 가장 흔한 원인입니다.

블록 상태는 대괄호 안에 들어갑니다

/setblock ~ ~ ~ oak_stairs[facing=east,half=top,waterlogged=true]

상태는 아이템이 아니라 블록의 속성입니다. 일반 계단 아이템의 회전은 설치할 때 결정됩니다. 예외는 block_state 구성 요소를 가진 아이템으로, 그 속성은 설치 후에 적용됩니다. 지정하지 않은 속성은 기본값을 사용합니다.

waterlogged은 사람들을 자주 걸리게 합니다. 계단, 반 블록, 울타리 등 수십 가지에 존재하며, 이것 없이 블록을 설정하면 거기 있던 물이 제거됩니다.

오래된 명령어를 깨뜨리는 이름 변경

몇 가지 ID가 바뀌었고, 예전 것들은 이제 그냥 알 수 없는 것으로 처리됩니다:

grass이 특히 고통스러운데, grass_block은 여전히 존재하고 다른 것이기 때문입니다. 식물에 grass을 사용하던 예전 명령어는 이제 알 수 없는 블록으로 실패합니다.

엔티티 ID

대체로 예측 가능하지만 예외가 있습니다: snowman가 아니라 minecraft:snow_golem, mushroom_cow이 아니라 minecraft:mooshroom, 그리고 모든 발사체는 각자의 엔티티입니다 — minecraft:arrow, minecraft:spectral_arrow, minecraft:trident.

기술적으로 블록 엔티티인 엔티티 — 상자, 호퍼, 표지판 — 는 엔티티 목록에 나타나지 않으며 /summon할 수 없습니다. 이것들은 블록으로 설치되고 /data로 편집합니다.

목록보다 태그가 낫습니다

#minecraft:planks   #minecraft:logs   #minecraft:wool
#minecraft:doors    #minecraft:beds   #minecraft:swords

명령어나 JSON이 태그를 받는 곳이라면 어디든, 태그를 사용하면 Mojang이 새로운 나무 종류를 추가해도 살아남습니다. 열세 가지 판자 ID를 전부 하드코딩하면 그렇지 않습니다.

블록 상태와 각각이 속한 태그를 포함해 모든 블록, 아이템, 엔티티 ID를 블록, 아이템 & 엔티티 ID 브라우저에서 검색하세요.

블록·아이템·엔티티 ID 검색기 →