Potan의 게임블로그

마인크래프트 JE 26.1 기술적 업데이트 정리

Potan — Sun, 29 Mar 2026 15:15:45 +0900

마인크래프트 자바에디션 26.1 "Tiny Takeover" - 기술적 업데이트 정리

마인크래프트가 2026년 3월 24일, 새로운 연도 기반 버전 관리 시스템이 적용된 26.1 "Tiny Takeover" (타이니 테이크오버) 업데이트를 정식 출시했습니다.

이 글의 작성에는 AI가 사용되었습니다.

1. 코어 시스템 및 엔진 업데이트

마인크래프트의 기반이 되는 실행 환경과 내부 렌더링 엔진이 대대적으로 개편되었습니다.

1.1 Java 런타임 및 메모리

Java 25 요구: 이제 게임 실행을 위해 Java 25가 필수적입니다.
메모리 할당량 및 GC: 런처 기본 RAM 할당량이 4GB로 상향되었으며, 호환 기기에서 Generational ZGC를 기본 가비지 컬렉터로 채택하였습니다.

1.2 공식 난독화 해제

배포되는 마인크래프트의 jar 파일이 난독화되지 않은 상태로 제공됩니다. 기존의 난독화 해제 과정이 제거되어 접근성이 향상되었습니다.

1.3 시스템 상태 알림

디스크 용량 경고: 월드 저장 중 디스크 용량이 부족할 경우 우측 상단에 알림이 표시됩니다.

1.4 입력기(IME) 후보창 인게임 렌더링

한국어 등 조합형 문자를 위한 IME 후보창이 게임 UI 내부에서 직접 렌더링됩니다. 창 모드나 전체 화면 모두에서 깔끔한 입력 환경을 제공합니다.

2. 월드 저장 구조 및 NBT 개편

월드 파일이 루트 폴더에 무분별하게 혼재되던 방식을 탈피하여, 네임스페이스(Namespace) 기반의 폴더 구조로 완전히 재조정되었습니다.

2.1 파일 및 폴더 경로 변경 상세

경로 변경 내역 전체 보기

데이터 유형	기존 경로	신규 경로	비고
오버월드 청크	`region/`	`dimensions/minecraft/overworld/region/`	루트에서 차원 폴더 내부로 이동
네더 차원	`DIM-1/`	`dimensions/minecraft/the_nether/`	차원 전체 데이터 이동
엔드 차원	`DIM1/`	`dimensions/minecraft/the_end/`
플레이어 데이터	`playerdata/`	`players/data/`	`players/` 하위로 통합 관리
발전과제/통계	`advancements/`, `stats/`	`players/advancements/`, `players/stats/`
지도 데이터	`data/map_*.dat`	`data/minecraft/maps/*.dat`	파일명에서 `map_` 접두사 제거 (예: 1.dat)
ID 카운트	`idcounts.dat`	`last_id.dat`	명칭 직관성 강화
청크 티켓	`chunks.dat`	`chunk_tickets.dat`	파일명 변경
구조물 데이터	`generated/namespace/structures/`	`generated/namespace/structure/`	단수형으로 통일

2.2 `level.dat` NBT 구조 개편 및 데이터 분리

전방위적 데이터 파일 분리: 기존에 level.dat 하나에 담겨있던 방대한 데이터들이 관리 편의를 위해 별도 파일로 분리되었습니다.
- 엔드 드래곤 전투: dimensions/minecraft/the_end/data/minecraft/ender_dragon_fight.dat
- 떠돌이 상인 데이터: data/minecraft/wandering_trader.dat
- 날씨 데이터: data/minecraft/weather.dat
- 게임 규칙 (Gamerules): data/minecraft/game_rules.dat
- 월드 시계: data/minecraft/world_clocks.dat
singleplayer_uuid (String): 기존의 Player 컴파운드 태그가 삭제되고, 단일 플레이어의 UUID를 저장하는 문자열 태그로 대체되었습니다.
난이도 (Difficulty): 정수형(0~3)에서 문자열("peaceful", "easy", "normal", "hard")로 변경되었습니다.
difficulty_settings (Compound): 난이도 잠금(locked) 상태 등이 이 컴파운드 내부에 저장됩니다.

3. 데이터 팩 개편 (Data Packs - v101.1)

데이터 팩 포맷 버전이 101.1로 업데이트되었습니다.

3.1 주민 거래 시스템 (Data-Driven Villager Trades)

주민(Villager)과 떠돌이 상인(Wandering Trader)의 거래가 완전히 데이터 팩으로 분리되었습니다.

villager_trade (개별 거래) JSON 사양 및 예시

거래의 기본 단위를 정의하며 data/<namespace>/villager_trade/ 경로에 저장됩니다.

wants (필수): 플레이어가 지불해야 할 첫 번째 아이템. (아이템 정보 id, count, components 포함 가능)
additional_wants (선택): 플레이어가 지불해야 할 두 번째 아이템.
gives (필수): 플레이어가 받을 아이템.
given_item_modifiers (선택): 결과 아이템에 적용할 전리품 함수 (Loot Functions) 배열. (예: 인챈트 적용, 이름 변경 등)
max_uses (필수): 거래 비활성화 전까지 가능한 최대 횟수.
experience (필수): 거래 성사 시 주민이 얻는 경험치.
price_multiplier (필수): 수요에 따른 가격 변동 계수 (Float).
demand (선택): 초기 수요 값.
merchant_predicate (선택): 이 거래를 제안할 수 있는 주민의 특정 조건(타입, 생물군계 등).

[예시] 30레벨 인챈트 책을 파는 커스텀 사서 거래

{
  "wants": { "id": "minecraft:emerald", "count": 64 },
  "additional_wants": { "id": "minecraft:book", "count": 1 },
  "gives": { "id": "minecraft:enchanted_book", "count": 1 },
  "given_item_modifiers": [
    {
      "function": "minecraft:enchant_with_levels",
      "levels": 30,
      "treasure": true
    }
  ],
  "max_uses": 3,
  "experience": 20,
  "price_multiplier": 0.2
}

trade_set (거래 풀 구성) JSON 사양 및 예시

주민이 특정 레벨 도달 시 제안할 거래들의 목록(Pool)을 정의합니다. data/<namespace>/trade_set/ 경로에 저장됩니다.

amount: 세트 내에서 무작위로 선택할 거래의 개수 (Number Provider 지원).
trades: 선택 후보가 될 거래 ID 리스트, 단일 ID, 혹은 태그(# 접두사).
allow_duplicates (Boolean): 동일한 거래가 중복 등장할 수 있는지 여부.
random_sequence: 시드 기반의 결정론적 난수 생성을 위한 식별자 ID.
replace (Boolean): 기존 세트를 덮어쓸지 여부.

[예시] 초보 사서의 거래 세트 묶음

{
  "amount": 2,
  "trades": "#minecraft:librarian/level_1",
  "allow_duplicates": false,
  "random_sequence": "minecraft:trade_set/librarian/level_1",
  "replace": false
}

3.2 시간 시스템 (World Clock & Timeline)

월드 내 시간의 흐름을 차원별로 독립적으로 관리하고, 특정 틱(Tick)마다 이벤트를 유도할 수 있는 새로운 시스템입니다.

world_clock 및 timeline JSON 사양

world_clock 레지스트리 (data/<namespace>/world_clock/)
- 시간을 추적하는 독립된 객체를 생성합니다. JSON 파일은 {}처럼 비어있어도 무방합니다.
- 이후 dimension_type JSON에서 clock 필드로 참조하여 해당 차원의 시계를 지정합니다.
timeline 레지스트리 (data/<namespace>/timeline/)
- clock: 연동할 world_clock 식별자.
- time_markers: 시간 마커 정의. 명령어에서 /time set <마커> 형태로 쓰입니다.
  - ticks: 마커가 위치한 정확한 틱 수 (예: 6000).
  - show_in_commands (Boolean): 자동완성 UI에 노출할지 여부.

[예시] 커스텀 타임라인 마커 정의

{
  "clock": "minecraft:overworld",
  "time_markers": {
    "my_mod:witching_hour": {
      "ticks": 18000,
      "show_in_commands": true
    }
  }
}

3.3 환경 속성 시스템 (Environment Attributes)

게임 내 물리적, 시각적 상태를 데이터 팩의 전리품(Loot) 조건이나 발전과제에서 체크할 수 있게 되었습니다.

신규 술어 (Predicate): minecraft:environment_attribute_check
- attribute: 확인할 환경 속성.
- value: 일치해야 하는 정확한 값.
주요 환경 속성 ID:
- minecraft:gameplay/is_day (Boolean)
- minecraft:gameplay/is_raining (Boolean)
- minecraft:gameplay/is_thundering (Boolean)
- minecraft:gameplay/sky_light_level (Integer, 0~15)
- minecraft:gameplay/block_light_level (Integer, 0~15)
- minecraft:visual/sky_color, fog_color (RGB Array)

환경 속성 활용 예시 보기

비가 올 때만 특정 행동이 가능하도록 제한하는 전리품 테이블 조건:

{
  "condition": "minecraft:environment_attribute_check",
  "attribute": "minecraft:gameplay/is_raining",
  "value": true
}

숫자 범위를 확인할 때는 value_check와 숫자 공급자(number_provider)를 조합합니다:

{
  "condition": "minecraft:value_check",
  "value": {
    "type": "minecraft:environment_attribute",
    "attribute": "minecraft:gameplay/block_light_level"
  },
  "range": { "min": 8, "max": 15 }
}

3.4 데이터 기반 동물 변종 (Mob Sound Variants)

성체 동물의 울음소리와 행동 패턴이 고정되지 않고, 소리 변종을 통해 개체마다 달라집니다.

신규 레지스트리 경로:
- data/<namespace>/cat_sound_variant/
- data/<namespace>/pig_sound_variant/
- data/<namespace>/cow_sound_variant/
- data/<namespace>/chicken_sound_variant/
JSON 구조: sounds 객체 내에 ambient, hurt, death 등의 상황에 맞는 커스텀 사운드 이벤트를 맵핑합니다.

3.5 데이터 기반 특수 조합법 (Data-Driven Special Recipes)

기존에 하드코딩되어 수정이 불가능했던 특수 조합 로직들이 데이터 팩으로 개방되었습니다. 이제 재료와 결과 아이템을 자유롭게 커스텀할 수 있습니다.

minecraft:crafting_dye: 가죽 갑옷이나 도구의 색상을 혼합하여 염색하는 로직.
minecraft:crafting_imbue: 잔류형 물약을 사용해 팁 화살(Tipped Arrow)을 만드는 로직.
minecraft:crafting_special_bannerduplicate: 현수막 패턴을 복사하는 로직.
minecraft:crafting_special_bookcloning: 서명된 책을 복사하는 로직 (복사본의 세대 제어 가능).
minecraft:crafting_decorated_pot: 도자기 파편으로 장식된 도자기를 만드는 로직.
기타: 폭죽 로켓, 폭죽 별, 지도 확장 및 복사 조합법 등이 모두 데이터화되었습니다.

3.6 추가 데이터 팩 변경 사항

발전과제 조건 확장: player 서브 술어에 food 필드가 추가되어 배고픔 수치(level)와 포만감(saturation)을 체크할 수 있습니다.
전리품 함수: minecraft:set_random_dyes (랜덤 염색 적용), minecraft:set_random_potion (랜덤 물약 효과 적용) 함수가 추가되었습니다.

4. 리소스 팩 및 시각 효과 (Resource Packs - v84)

리소스 팩 형식이 84로 업데이트되었으며, 모델링과 렌더링에 큰 변화가 생겼습니다.

4.1 조명 엔진 개편에 따른 셰이더(Shader) 변경

lightmap.fsh 수정:
- 더 이상 AmbientLightFactor 유니폼을 사용하지 않고 제거되었습니다.
- BlockLightTint (vec3): 블록 광원의 틴트 색상을 전역적으로 제어하는 유니폼이 추가되었습니다.
- NightVisionColor (float): 야간 투시 효과의 강도 및 색상 맵핑을 보정하는 유니폼이 추가되었습니다.

4.2 아기 몹 (Baby Mobs) 모델 오버홀

단순히 성인 모델의 크기(Scale)를 줄이던 방식에서 벗어나, 고유한 뼈대(Bone)와 UV 맵을 가집니다.

고유 모델링: 머리 비율이 크고 다리가 짧은 아기 전용 모델(baby_cow.json, baby_wolf.json 등)이 리소스 팩 모델 디렉토리에 대거 추가되었습니다.
렌더링 예외: 아기 늑대, 아기 돼지, 아기 낙타 등 특정 아기 몹은 갑옷(Armor)이나 안장(Saddle) 텍스처를 렌더링하지 않습니다.
고유 사운드: 고음의 전용 아기 사운드가 추가되었습니다.

4.3 아이템 모델 변환 (Transformation) 지원

아이템 모델 JSON(minecraft:model, minecraft:special 등)에 transformation 필드가 추가되었습니다. (디스플레이의 transformation과 동일) 16개의 숫자로 이루어진 매트릭스(Matrix) 배열이나 평행 이동, 크기 조절, 회전 값을 직접 정의할 수 있습니다.

5. 데이터 구성 요소 변경 (Data Components)

NBT를 대체하는 아이템 데이터 구성 요소(Components)의 기능이 확장되었습니다.

minecraft:object: 텍스트 컴포넌트 내에 머리(Head) 등 오브젝트를 렌더링할 때, 서버 환경이나 클라이언트 한계로 렌더링이 실패할 경우 표시할 fallback (String) 필드가 추가되었습니다.
minecraft:provides_banner_patterns: 기존에는 태그만 허용했으나, 이제 단일 패턴 ID 혹은 패턴 ID의 리스트 형식도 허용합니다.
minecraft:blocks_attacks / minecraft:damage_resistant: 피해 유형을 지정하는 bypassed_by와 types 필드에서 태그 외에도 ID 리스트(Array)를 지원하여 정의가 직관적여졌습니다.
minecraft:dyed_color 연동: 아이템이 #minecraft:dyeable 태그를 가지고 있을 경우, 신규 전리품 함수인 minecraft:set_dyed_color를 사용해 가죽 갑옷처럼 누적 방식으로 염료 색상을 추가할 수 있습니다.
minecraft:additional_trade_cost (Integer): 주민 거래 시 특정 아이템의 요구 수량을 일시적으로 조작하는 컴포넌트입니다. 거래 생성 시에만 사용되고 이후 삭제됩니다.
minecraft:dye (Enum): 아이템에 염료 색상 정보(16색)를 직접 부여합니다.

6. 명령어 및 게임플레이 로직 (Commands & Gameplay)

6.1 명령어 업데이트

/time [of <clock>] rate <rate>: 시각적인 낮과 밤의 흐름만 조절합니다. (0.0~1000.0)
/time 반환값 변경: /time set 또는 add 명령어 성공 시, 기존에는 하루 중 시간(0~24000)을 반환했으나 이제 해당 클럭의 총 경과 틱(Total Elapsed Ticks)을 반환합니다.
신규 명령어 /fetchprofile entity <대상>: 엔티티(플레이어, 마네킹 등)의 프로필 정보를 출력합니다.
신규 명령어 /swing <대상> [hand]: 엔티티의 휘두르기 애니메이션을 강제 실행합니다.

6.2 게임플레이/아이템 변경점

황금 민들레 (Golden Dandelion): 민들레 1개 + 금 조각 8개로 조합.
- 성장 제어: 아기 몹에게 우클릭 시 AgeLocked (NBT 속성)가 1로 설정되어 성장이 영구적으로 정지하며, 다시 클릭 시 0으로 초기화되어 성장이 재개됩니다. (단, 아기 주민과 언데드 계열에게는 사용 불가)
- 피글린 상호작용: 피글린은 황금 민들레에 매우 큰 관심을 보입니다. 바닥에 떨어져 있으면 주워서 수 초간 관찰하며, 이때 피글린은 공격성을 보이지 않습니다.
- 양봉 환경 개선: 황금 민들레 주변 2블록 이내에서 나무가 자랄 경우, 해당 나무에 벌집(Bee Nest)이 생성될 확률이 5% 추가됩니다.
이름표 (Name Tag) 조합: 종이 1개 + 금속 조각(철/금) 1개로 크래프팅이 가능해졌습니다. 이에 따라 고대 도시, 삼림 대저택 전리품에서 제거되었습니다.
석재 절단기 (Stonecutter) 확장: 이제 심층암류 블록을 직접 가공할 수 있습니다. 돌을 바로 조약돌로 바꿀 수 있습니다.
번들 (Bundle) 용량 개선: bundle_contents 컴포넌트의 무게 한계가 정수 최대치까지 확장되었습니다.
트럼펫 소리 (Trumpet): 소리 블록을 구리 블록 위에 배치하면 트럼펫 소리가 납니다. 구리의 산화도뿐만 아니라 깎인 구리(Cut Copper) 등 블록의 가공 형태에 따라서도 미세한 음색(Timbre) 차이가 발생합니다.

7. 신규 태그 (Tags) 목록

7.1 블록 및 아이템 태그

#minecraft:prevents_nearby_leaf_decay (Block): 이 태그를 가진 블록 주변의 나뭇잎은 나무가 없어도 자연 소멸(Decay)하지 않습니다. 건축용 인공 기둥 등에 사용됩니다.
#minecraft:baby_mob_interactable (Block): 아기 몹만 통과하거나 상호작용할 수 있는 전용 블록 태그입니다.
#minecraft:baby_food (Item): 아기 몹의 성장을 촉진시키거나, 황금 민들레처럼 상태를 제어할 수 있는 아이템 그룹입니다.
#minecraft:dyeable (Item): dyed_color 컴포넌트를 통해 색을 입힐 수 있는 모든 장비 및 아이템 목록입니다.

7.2 엔티티 및 파티클 태그

#minecraft:baby_mobs (Entity): 전용 모델링과 로직을 적용받는 모든 아기 개체 목록.
#minecraft:immune_to_aging (Entity): 황금 민들레의 효과를 받지 않는 몹들. (예: 아기 주민, 아기 좀비 계열 등)
minecraft:pause_mob_growth (Particle): 성장이 멈출 때 아래로 떨어지는 파티클.
minecraft:reset_mob_growth (Particle): 성장이 재개될 때 위로 솟아오르는 파티클.

작성 참고 자료:

Minecraft Wiki - Java Edition 26.1 (Tiny Takeover) Release Notes
Snapshot Data structures & Official Datapack references.

Map Maker's Utils 마인크래프트 Fabric 모드

Potan — Mon, 5 Jan 2026 00:11:45 +0900

https://modrinth.com/mod/map-maker-utils

Map Maker Utils - Minecraft Mod

Utility commands for Map Makers and Data Pack developers.

modrinth.com

마인크래프 Fabric 모드입니다.

버전은 26.1 - 1.21.11 을 지원합니다.

마인크래프트 데이터팩 개발과 맵 제작에 편리한 기능들을 모아놓았습니다.

기능은 다음과 같습니다.

1. 간단한 좌표, 회전값 복사 명령어

현재 좌표를 내림한 정수로 복사하거나 회전값을 복사해주는 명령어입니다.

2. 데이터팩 폴더 열기 (싱글 전용)

해당하는 세이브 폴더의 datapacks 폴더를 열어줍니다.

3. 레지스트리 reload 하기 (싱글 전용)

타이틀 메뉴 -> 맵 접속 과정을 자동화 해줍니다.

맵을 자동으로 재접속하는거라 실험적 세계 설정 경고가 발생합니다.

하지만 4번 기능을 사용하면 경고창을 무시할 수 있을겁니다.

4. 실험적 세계 경고창 무시하기 (싱글 전용)

하단에 새로운 버튼을 추가합니다.

이 버튼을 누른 뒤부터는 게임을 재부팅하기 전까지 해당하는 맵에서는 경고창이 뜨지 않고 바로 맵에 진입할 수 있습니다.

5. 레지스트리 깨짐 경고 보기

레지스트리 작성에 오류가 있어 안전모드로 진입해야할 때 경고 로그를 일부 노출합니다.

이를 통해 어떤 파일에 오류가 있는 지 찾는 데에 도움이 될 수 있을 것입니다.

마인크래프트 JE 1.21.11 기술적 업데이트 정리

Potan — Thu, 18 Dec 2025 16:09:07 +0900

마인크래프트 자바에디션 1.21.11 - 기술적 업데이트 정리

해당 글은 마인크래프트 1.21.11 업데이트의 주요 기술적 변경 사항, 특히 새롭게 도입된 환경 속성(Environment Attributes) 시스템을 중심으로 자세히 정리한 것입니다.

이 글의 작성에는 AI가 사용되었습니다.

환경 속성 (Environment Attributes)

다양한 시각 및 게임플레이 시스템을 데이터 기반으로 제어하는 새로운 방법입니다. 각 환경 속성은 특정 시각적 또는 게임플레이 효과를 제어합니다.

(예: minecraft:visual/sky_color는 하늘색을, minecraft:gameplay/water_evaporates는 특정 위치에 물을 놓을 수 있는지 여부를 제어합니다.)

환경 속성 소스

환경 속성 값은 다음 소스에 의해 제공될 수 있으며, 우선순위는 낮은 순서부터 나열됩니다.

차원 (Dimensions)
생물군계 (Biomes)
타임라인 (Timelines)
날씨 (Weather) (데이터 기반 아님)
보간 (Interpolation)

가장 높은 우선순위의 소스가 이전 소스의 값을 덮어쓰거나 수정합니다. 예를 들어, 오버월드 차원이 녹색 하늘을 지정하고 평원 생물군계가 빨간색 하늘을 지정하면, 플레이어가 평원에 있을 때는 빨간 하늘이 보이고 다른 곳에서는 녹색 하늘이 보입니다.

환경 속성 맵 (Environment Attribute Map)

차원 유형 및 생물군계 정의에 새로운 attributes 필드가 추가되었습니다. 이 맵은 환경 속성 ID와 해당 값을 매핑하는 객체 형태입니다.

"attributes": {
  "minecraft:visual/fog_color": "#ffaa00",
  "minecraft:gameplay/water_evaporates": true
}

기본적으로 override 수정자를 사용하지만, 다른 수정자를 명시적으로 지정할 수 있습니다.

"attributes": {
  "minecraft:visual/water_fog_radius": {
    "modifier": "multiply",
    "argument": 0.85
  }
}

수정자 (Modifiers)

환경 속성 소스는 값을 단순히 덮어쓰는 대신, 낮은 우선순위의 소스가 제공한 값에 수정자를 적용할 수 있습니다. 사용 가능한 수정자는 속성의 데이터 유형에 따라 다릅니다.

공통 데이터 유형

RGB 색상: #rrggbb 형태의 16진수 문자열, [r, g, b] 형태의 부동 소수점 배열, 또는 정수.
ARGB 색상: #aarrggbb 형태의 16진수 문자열, [a, r, g, b] 형태의 부동 소수점 배열, 또는 정수.
파티클 옵션: /particle 명령어와 동일한 형식의 전체 파티클 정의.

수정자 종류

불리언(Boolean) 값 수정자: override, and, nand, or, nor, xor, xnor.
실수(Float) 값 수정자: override, add, subtract, multiply, minimum, maximum.
RGB 색상 값 수정자: override, add, subtract, multiply, alpha_blend, blend_to_gray.
ARGB 색상 값 수정자: override, add, subtract, multiply, alpha_blend, blend_to_gray.

보간 (Interpolation)

일부 환경 속성은 두 개 이상의 값 사이를 부드럽게 전환하는 보간을 지원합니다. 예를 들어, 생물군계 사이를 이동할 때 하늘색이 점진적으로 변하는 것이 이에 해당합니다.

보간은 카메라 주변 8블록 반경 내의 생물군계를 기반으로 수행됩니다.
water_evaporates와 같은 불연속적인 값은 부드럽게 전환되지 않습니다.

새로운 환경 속성 전체 목록

각 속성의 상세 정보는 다음과 같습니다.

시각 (Visual)

minecraft:visual/fog_color: 안개가 다른 물질에 잠기지 않았을 때의 색상.
- 값 유형: RGB 색상
- 기본값: #000000
- 수정자: 색상 수정자
- 보간: 예
minecraft:visual/fog_start_distance: 안개가 효과를 나타내기 시작하는 카메라로부터의 거리(블록).
- 값 유형: float
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/fog_end_distance: 안개가 최대 밀도에 도달하는 카메라로부터의 거리(블록).
- 값 유형: 음이 아닌 float
- 기본값: 1024.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/water_fog_color: 물에 잠겼을 때의 안개 색상.
- 값 유형: RGB 색상
- 기본값: #050533
- 수정자: 색상 수정자
- 보간: 예
minecraft:visual/water_fog_start_distance: 물 속 안개가 효과를 나타내기 시작하는 거리.
- 값 유형: float
- 기본값: -8.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/water_fog_end_distance: 물 속 안개가 최대 밀도에 도달하는 거리.
- 값 유형: 음이 아닌 float
- 기본값: 96.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/sky_fog_end_distance: 하늘에 영향을 미치는 안개가 최대 밀도에 도달하는 거리.
- 값 유형: 음이 아닌 float
- 기본값: 512.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/cloud_fog_end_distance: 구름에 영향을 미치는 안개가 최대 밀도에 도달하는 거리.
- 값 유형: 음이 아닌 float
- 기본값: 2048.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/sky_color: 하늘의 색상 (오버월드 하늘에서만 보임).
- 값 유형: RGB 색상
- 기본값: #000000
- 수정자: 색상 수정자
- 보간: 예
minecraft:visual/sky_light_color: 하늘 빛의 시각적 색상.
- 값 유형: RGB 색상
- 기본값: #ffffff
- 수정자: RGB 색상 수정자
- 보간: 예
minecraft:visual/sky_light_factor: 하늘 빛의 시각적 밝기.
- 값 유형: float
- 기본값: 1.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/cloud_color: 구름의 색상. 완전히 투명하면 구름이 비활성화됩니다.
- 값 유형: ARGB 색상
- 기본값: #00000000
- 수정자: ARGB 색상 수정자
- 보간: 예
minecraft:visual/cloud_height: 모든 구름이 나타나는 높이.
- 값 유형: float
- 기본값: 192.33
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/default_dripstone_particle: 위에 유체가 없을 때 점적석 블록에서 떨어지는 기본 파티클.
- 값 유형: 파티클 옵션
- 기본값: {type:"minecraft:dripping_dripstone_water"}
- 수정자: override
- 보간: 아니요
minecraft:visual/ambient_particles: 카메라 주위에 무작위로 스폰되는 주변 파티클을 제어합니다.
- 값 유형: particle과 probability 필드를 가진 객체 목록
- 기본값: []
- 수정자: override
- 보간: 아니요
minecraft:visual/sunrise_sunset_color: 일출 및 일몰 효과의 색상과 강도를 제어합니다.
- 값 유형: ARGB 색상
- 기본값: #00000000
- 수정자: ARGB 색상 수정자
- 보간: 예
minecraft:visual/sun_angle: 태양의 각도 (도 단위).
- 값 유형: float (도)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/moon_angle: 달의 각도 (도 단위).
- 값 유형: float (도)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/moon_phase: 달의 위상.
- 값 유형: 문자열 ID (full_moon, waning_gibbous 등)
- 기본값: "full_moon"
- 수정자: override
- 보간: 아니요
minecraft:visual/star_angle: 별의 각도 (도 단위).
- 값 유형: float (도)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:visual/star_brightness: 하늘에 있는 별의 밝기 (0.0 ~ 1.0).
- 값 유형: float (0과 1 사이)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예

오디오 (Audio)

minecraft:audio/background_music: 배경 음악 재생 방식과 종류를 제어합니다.
- 값 유형: default, underwater, creative 필드를 포함하는 객체
- 기본값: {}
- 수정자: override
- 보간: 아니요
minecraft:audio/music_volume: 음악이 재생될 볼륨.
- 값 유형: float (0과 1 사이)
- 기본값: 1.0
- 수정자: 실수 수정자
- 보간: 아니요
minecraft:audio/ambient_sounds: 카메라 주변에서 재생되는 주변 소리를 제어합니다.
- 값 유형: loop, mood, additions 필드를 포함하는 객체
- 기본값: {}
- 수정자: override
- 보간: 아니요
minecraft:audio/firefly_bush_sounds: true이면 반딧불 덤불이 소리를 냅니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요

게임플레이 (Gameplay)

minecraft:gameplay/water_evaporates: 물 양동이 사용, 얼음 녹기 등을 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/bed_rule: 침대 사용 규칙(수면, 스폰 설정, 폭발)을 제어합니다.
- 값 유형: can_sleep, can_set_spawn, explodes, error_message 필드를 가진 객체
- 기본값: {type:"can_sleep_when_dark",error_message:{translate:"block.minecraft.bed.no_sleep"}}
- 수정자: override
- 보간: 아니요
minecraft:gameplay/respawn_anchor_works: 리스폰 정박기 사용 가능 여부를 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/nether_portal_spawns_piglin: 네더 포탈 블록에서 피글린 스폰 여부를 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/fast_lava: 용암이 더 빠르고 멀리 퍼지는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/increased_fire_burnout: 불 블록이 더 빨리 타서 없어지는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/piglins_zombify: 피글린과 호글린이 좀비화되는지 제어합니다.
- 값 유형: boolean
- 기본값: true
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/monsters_burn: 몬스터가 하늘에 노출되었을 때 타는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/snow_golem_melts: 눈 골렘이 피해를 입는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/sky_light_level: 몹 스폰이나 햇빛 감지기 같은 메커니즘에서 사용되는 하늘의 유효 광원 레벨.
- 값 유형: float
- 기본값: 15.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:gameplay/eyeblossom_open: 닫힌 아이블로섬이 열리는지, 열린 아이블로섬이 닫히는지 제어합니다.
- 값 유형: true, false, 또는 "default"
- 기본값: "default"
- 수정자: override
- 보간: 아니요
minecraft:gameplay/turtle_egg_hatch_chance: 거북 알 블록이 다음 부화 상태로 전환될 확률.
- 값 유형: float (0과 1 사이)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:gameplay/creaking_active: 크리킹 심장 블록이 활성화되는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/surface_slime_spawn_chance: #allows_surface_slime_spawns 태그가 있는 생물군계에서 슬라임 스폰 시 추가 확률.
- 값 유형: float (0과 1 사이)
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:gameplay/cat_waking_up_gift_chance: 플레이어가 일어났을 때 고양이가 선물을 떨어뜨릴 확률.
- 값 유형: float
- 기본값: 0.0
- 수정자: 실수 수정자
- 보간: 예
minecraft:gameplay/bees_stay_in_hive: 벌이 벌집으로 돌아가 나오지 않는지 제어합니다.
- 값 유형: boolean
- 기본값: false
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/can_pillager_patrol_spawn: 약탈자 순찰대가 스폰될 수 있는지 제어합니다.
- 값 유형: boolean
- 기본값: true
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/can_start_raid: 플레이어가 흉조 효과를 가졌을 때 습격을 시작할 수 있는지 제어합니다.
- 값 유형: boolean
- 기본값: true
- 수정자: 불리언 수정자
- 보간: 아니요
minecraft:gameplay/villager_activity: 성인 주민의 기본 AI 활동을 제어합니다.
- 값 유형: 몹 활동 ID
- 기본값: "minecraft:idle"
- 수정자: override
- 보간: 아니요
minecraft:gameplay/baby_villager_activity: 아기 주민의 기본 AI 활동을 제어합니다.
- 값 유형: 몹 활동 ID
- 기본값: "minecraft:idle"
- 수정자: override
- 보간: 아니요

명령어 변경 사항

/stopwatch (신규):
- 실시간을 추적하는 스톱워치를 생성할 수 있는 새로운 명령어입니다.
- 스톱워치는 게임 틱에 의존하지 않습니다.
- 서버/월드가 실행 중일 때만 작동하며, 일시 중지된 경우에도 작동합니다.
- 구문:
  - /stopwatch create <id>: 주어진 네임스페이스 ID로 스톱워치를 생성합니다.
  - /stopwatch query <id> [scale]: 쿼리된 값을 반환하며, 새로운 scale 인수를 받습니다. 반환된 값은 scale에 따라 조정되고 잘립니다. scale은 선택 사항이며 생략하면 기본값은 1입니다.
    - 예시: /stopwatch query foo:bar 20 (경과 시간을 틱 단위로 가져옵니다.)
  - /stopwatch restart <id>: 주어진 스톱워치를 재시작합니다.
  - /stopwatch remove <id>: 주어진 스톱워치를 제거합니다.
/execute:
- 새로운 구문 추가: /execute (if|unless) stopwatch <id> <range>
- 스톱워치의 경과 시간(초 단위, 밀리초 정확도)을 부동 소수점 값 범위와 비교합니다.
- 예시: /execute if stopwatch foo:bar ..10 run say Stopwatch foo:bar has not reached 10 seconds yet.
/worldborder:
- 시간 인수가 초 대신 틱 단위로 변경되었습니다. s 또는 d 접미사를 사용하여 초 또는 게임 내 날짜를 지정할 수 있습니다.

게임 규칙 (Game Rules)

규칙 ID 변경:
- 모든 게임 규칙이 camelCase에서 snake_case 형식의 리소스 위치로 이름이 변경되었습니다.
- 예: announceAdvancements -> minecraft:show_advancement_messages
- 예: doFireTick -> minecraft:do_fire_tick
minecraft:fire_spread_radius_around_player (신규):
- 플레이어 주변에서 불이 확산될 수 있는 최대 거리(블록)를 제어합니다.
- 기존의 doFireTick과 allowFireTicksAwayFromPlayer 규칙을 대체합니다.
- 0: 불 확산 비활성화.
- -1: 플레이어 존재 여부와 상관없이 불 확산 허용 (기존 바닐라 동작).
- 최소값: -1
값 제한 적용:
- 다음 게임 규칙에 최소/최대값 제한이 적용되었습니다.
- minecraft:max_block_modifications: 최소 1
- minecraft:max_command_forks: 최소 1
- minecraft:max_command_sequence_length: 최소 0
- minecraft:max_entity_cramming: 최소 0
- minecraft:max_snow_accumulation_height: 최소 0, 최대 8
- minecraft:players_nether_portal_creative_delay: 최소 0
- minecraft:players_nether_portal_default_delay: 최소 0
- minecraft:players_sleeping_percentage: 최소 0
- minecraft:random_tick_speed: 최소 0
- minecraft:respawn_radius: 최소 0

아이템 구성요소 (Item Components)

신규 구성요소

minecraft:attack_range: 아이템 사용 시 사용자 지정 공격 범위를 활성화합니다.
- 플레이어의 일반적인 엔티티 상호작용 범위를 재정의합니다.
- 몹의 일반적인 근접 공격 범위는 대상 히트박스와 자신의 히트박스 간의 거리를 기반으로 계산됩니다. 이 구성요소는 공격 히트박스에 대한 최소 및 최대 패딩을 조정하여 거리 확인을 수정합니다.
- minecraft:kinetic_weapon을 사용하는 몹은 플레이어에게 적용되는 것과 동일한 방식으로 공격 범위가 적용됩니다.
- 형식: 필드를 가진 객체
  - min_reach: float, 공격자가 대상을 공격할 수 있는 최소 거리(블록). (이보다 낮으면 공격X)
    - 기본값: 0.0, 유효 범위: 0.0 ~ 64.0
  - max_reach: float, 공격자가 대상을 공격할 수 있는 최대 거리(블록). (이보다 높으면 공격X)
    - 기본값: 3.0, 유효 범위: 0.0 ~ 64.0
  - min_creative_reach: float, 크리에이티브 모드 공격자가 대상을 공격할 수 있는 최소 거리(블록).
    - 기본값: 0.0, 유효 범위: 0.0 ~ 64.0
  - max_creative_reach: float, 크리에이티브 모드 공격자가 대상을 공격할 수 있는 최대 거리(블록).
    - 기본값: 5.0, 유효 범위: 0.0 ~ 64.0
  - hitbox_margin: float, 유효한 히트박스 충돌을 확인할 때 대상 히트박스에 추가되는 여유 공간.
    - 기본값: 0.3, 유효 범위: 0.0 ~ 1.0
  - mob_factor: float, 몹이 아이템을 사용할 때 유효한 거리를 확인할 때 min_range 및 max_range에 적용되는 배수.
    - 기본값: 1.0, 유효 범위: 0.0 ~ 2.0

minecraft:damage_type: 이 아이템이 가하는 피해 유형을 지정합니다.
- 형식: 문자열, 피해 유형 식별자.
- 예시: damage_type='minecraft:spear'

minecraft:kinetic_weapon: 아이템 사용 시 차지형 공격을 활성화합니다 (주로 창에 사용). 사용 중일 때, 엔티티의 상대 속도를 기반으로 매 틱 시점을 따라 피해를 줍니다.
- 형식: 필드를 가진 객체.
  - delay_ticks: integer, 무기가 효과를 발휘하기 전에 필요한 시간(틱).
    - 기본값: 0
  - dismount_conditions: 하차 공격의 조건을 나타냅니다. 필드를 가진 객체:
    - max_duration_ticks: integer, 조건 작동이 중지되는 틱 수. delay가 경과한 후 시작됩니다.
    - min_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 이 속도보다 높아야 하차 공격이 가능합니다.
      - 선택 사항, 기본값: 0.0
    - min_relative_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 공격자와 대상 사이의 상대 속도가 이 속도보다 높아야 하차 공격이 가능합니다.
      - 선택 사항, 기본값: 0.0
  - knockback_conditions: 밀치기 조건을 나타냅니다. 필드를 가진 객체:
    - max_duration_ticks: integer, 조건 작동이 중지되는 틱 수. delay가 경과한 후 시작됩니다.
    - min_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 이 속도보다 높아야 밀치기가 가능합니다.
      - 선택 사항, 기본값: 0.0
    - min_relative_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 공격자와 대상 사이의 상대 속도가 이 속도보다 높아야 밀치기가 가능합니다.
      - 선택 사항, 기본값: 0.0
  - damage_conditions: 피해를 가할 수 있는 조건을 나타냅니다. 필드를 가진 객체:
    - max_duration_ticks: integer, 조건 작동이 중지되는 틱 수. delay가 경과한 후 시작됩니다.
    - min_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 이 속도보다 높아야 피해를 가할 수 있습니다.
      - 선택 사항, 기본값: 0.0
    - min_relative_speed: float, 공격자가 바라보는 방향의 초당 블록 속력으로 공격자와 대상 사이의 상대 속도가 이 속도보다 높아야 피해를 가할 수 있습니다.
      - 선택 사항, 기본값: 0.0
  - forward_movement: float, 애니메이션 중 아이템이 손에서 움직이는 거리.
    - 기본값: 0.0
  - damage_multiplier: float, 상대 속도로 인한 최종 피해에 대한 배수.
    - 기본값: 1.0
  - sound: 선택 사항, 무기가 작동할 때 재생될 사운드 이벤트.
  - hit_sound: 선택 사항, 무기가 엔티티를 때릴 때 재생될 사운드 이벤트.
  - contact_cooldown_ticks: integer, 엔티티를 공격한 후 벗어난 뒤에 다시 공격을 할 수 있기까지의 틱 단위 쿨다운.
    - 기본값: 10
  - 예시: kinetic_weapon={max_reach:5.0,forward_movement:1.0,delay:20,damage_conditions:{max_duration_ticks:60},knockback_conditions:{max_duration_ticks:40},dismount_conditions:{max_duration_ticks:20}}
  - 가해지는 피해는 floor(relative_speed * velocity_multiplier)로 계산됩니다. 여기서 relative_speed는 공격자의 시야 벡터 축에 투영된 공격자와 대상의 속도 벡터 차이입니다.
  - 마법 부여 또는 속성 수정자로 인한 추가 피해는 이 계산 후에 적용됩니다.

minecraft:minimum_attack_charge: 이 아이템으로 공격하는 데 필요한 쿨타임의 최소 비율을 지정합니다.
- 형식: float (0.0 ~ 1.0).
  - 0.0: 쿨타임 필요 없음.
  - 1.0: 전체 쿨타임 필요.

minecraft:piercing_weapon: 시점을 따라 여러 엔티티에 피해를 주는 빠른 공격을 활성화합니다 (주로 창에 사용).
- 형식: 필드를 가진 객체.
  - deals_knockback: boolean, 공격이 밀치기를 가하는지 여부.
    - 기본값: true
  - dismounts: boolean, 공격이 대상을 하차시키는지 여부.
    - 기본값: false
  - sound: 선택 사항, 플레이어가 무기로 공격할 때 재생될 사운드 이벤트.
  - hit_sound: 선택 사항, 무기가 엔티티를 때릴 때 재생될 사운드 이벤트.
  - 예시: piercing_weapon={min_reach:0,max_reach:4,dismounts:true}

minecraft:swing_animation: 이 아이템을 사용하여 공격하거나 상호작용할 때 재생할 휘두르기 애니메이션을 지정합니다.
- 형식: 필드를 가진 객체.
  - type: 문자열, 애니메이션 식별자 (none, whack, stab).
    - 기본값: whack
  - duration: integer, 지속 시간(틱).
    - 기본값: 6
  - 예시: swing_animation={type:'stab',duration:20}

minecraft:use_effects: 아이템 사용 시 플레이어의 행동을 제어합니다 (마우스 오른쪽 클릭).
- 형식: 필드를 가진 객체.
  - can_sprint: boolean, 플레이어가 이 아이템을 사용하는 동안 달릴 수 있는지 여부.
    - 기본값: false
  - speed_multiplier: float (0 ~ 1), 이 아이템을 사용하는 동안 플레이어에게 적용되는 속도 배수.
    - 기본값: 0.2
  - interact_vibrations: boolean, 이 아이템을 사용할 때 minecraft:item_interact_start 및 minecraft:item_interact_finish 게임 이벤트를 내보내는지 여부.
    - 기본값: true
  - 예시: use_effects={can_sprint:true,speed_multiplier:1.0}

변경된 구성요소

minecraft:consumable: 애니메이션 필드가 업데이트되었습니다.
- spear가 trident로 이름이 변경되었으며, 새로운 spear 애니메이션이 추가되었습니다.
minecraft:intangible: 이 구성요소를 가진 아이템은 툴팁에 관련 정보를 표시합니다.
물고기 양동이 아이템: minecraft:cod_bucket, minecraft:salmon_bucket, minecraft:pufferfish_bucket, minecraft:tropical_fish_bucket에 음식 속성이 추가되었습니다.

전리품 및 슬롯

전리품 함수 (Loot Functions):
- minecraft:discard: 아이템 스택을 빈칸으로 바꿉니다.
- minecraft:filtered: modifier 필드가 on_pass와 on_fail로 대체되었습니다.
전리품 테이블 (Loot Tables):
- 새로운 minecraft:slots 전리품 풀 항목이 추가되어, 선택된 슬롯에 포함된 아이템을 전리품 테이블에 제공합니다.
슬롯 소스 (Slot Sources): 데이터팩 내에서 인벤토리 슬롯의 위치를 지정할 수 있도록 슬롯 소스가 추가되었습니다.
- 형식: 필드를 가진 객체.
  - type: 슬롯 소스 유형.
  - <type-specific>: 유형에 따라 추가 필드.
- minecraft:empty 유형:
  - 슬롯을 포함하지 않는 빈 선택.
- minecraft:group 유형:
  - 여러 슬롯 소스를 하나로 병합하며, 결과 선택에는 제공된 각 슬롯 소스의 모든 슬롯이 포함됩니다.
  - 하나 이상의 슬롯 소스에 슬롯이 포함된 경우, 결과 슬롯 소스에서 반복됩니다.
  - 예시: [a, b] + [c, a] -> [a, b, c, a]
  - 형식:
    - terms: 결합할 슬롯 소스 목록.
    - 인라인으로 슬롯 소스 목록으로 작성할 수도 있습니다.
- minecraft:slot_range 유형:
  - 엔티티 또는 블록 엔티티의 인벤토리에서 슬롯 범위 내의 슬롯을 선택합니다.
  - /item 명령어의 from 인수의 동작을 미러링합니다.
  - 형식:
    - source: 슬롯이 제공될 엔티티 또는 블록 엔티티 (전리품 컨텍스트에서). block_entity, this, attacking_entity, last_damage_player, direct_attacker, target_entity, 또는 interacting_entity가 될 수 있습니다.
    - slots: <slot_type> 또는 <slot_type>.<slot_number> 형식의 슬롯 범위 (예: armor.chest 또는 container.*).
- minecraft:contents 유형:
  - 하나 이상의 아이템의 인벤토리 구성요소에서 비어있지 않은 모든 슬롯을 선택합니다.
  - 해당 구성요소 내에 아이템이 저장되어 있지 않으면 결과 선택은 비어 있습니다.
  - 인벤토리 구성요소를 사용할 아이템의 위치는 다른 슬롯 소스에 의해 지정됩니다.
  - 슬롯 소스에 해당 구성요소를 가진 아이템이 두 개 이상 포함된 경우, 결과 선택은 minecraft:group 유형과 동일하게 병합됩니다.
  - 예시: 번들 [a, b] + 셜커 상자 [c, d] -> [a, b, c, d]
  - 형식:
    - component: 대상이 될 인벤토리 구성요소. 허용되는 값은 minecraft:bundle_contents, minecraft:charged_projectiles, 및 minecraft:container입니다.
    - slot_source: 대상이 될 아이템을 가진 슬롯을 포함하는 슬롯 소스.
- minecraft:filtered 유형:
  - 선택된 슬롯에 필터를 적용하여, 일치하지 않는 슬롯을 결과 선택에서 제외합니다.
  - 형식:
    - item_filter: 각 슬롯의 아이템과 일치시킬 아이템 술어.
    - slot_source: 필터링할 슬롯 소스.
- minecraft:limit_slots 유형:
  - 제공되는 슬롯 수를 제한하며, 결과 선택에는 최대 해당 수의 슬롯이 포함됩니다.
  - 해당 제한을 초과하는 슬롯은 포함 순서대로 제외됩니다.
  - 예시: [a, b, c, d] -> [a, b, c] (제한이 3으로 설정된 경우)
  - 형식:
    - limit: integer, 결과 선택에 포함할 최대 슬롯 수.
    - slot_source: 제한할 슬롯 소스.
- 예시: 엔티티의 핫바 및 갑옷 슬롯에서 16개 이상의 아이템을 가진 모든 슬롯을 선택하는 슬롯 소스:

{
    "type": "minecraft:filtered",
    "item_filter": {
        "count": {
            "min": 16
        }
    },
    "slot_source": [
        {
            "type": "minecraft:slot_range",
            "source": "this",
            "slots": "hotbar.*"
        },
        {
            "type": "minecraft:slot_range",
            "source": "this",
            "slots": "armor.*"
        }
    ]
}

타임라인 (Timelines)

타임라인은 데이터팩의 timeline 레지스트리(data/<namespace>/timeline/<id>.json 경로)에 정의되는 새로운 실험적 개념입니다.

기능: 절대적인 낮 시간(/time set으로 설정되는 시간)을 기반으로 게임 동작을 지정합니다.
반복 주기: 타임라인은 선택적으로 반복 주기를 지정할 수 있습니다.
환경 속성 수정: 환경 속성 소스로 작동하여 환경 속성 수정자를 적용함으로써 게임 동작이나 시각 효과를 수정할 수 있습니다.
환경 속성 소스 처리 순서: 타임라인이 포함됨에 따라 환경 속성 소스는 다음 순서(낮은 우선순위에서 높은 우선순위)로 처리됩니다.
1. 차원 (Dimensions)
2. 생물군계 (Biomes)
3. 타임라인 (Timelines)
4. 날씨 (Weather) (데이터 기반 아님)
5. 보간 (Interpolation)

속성 트랙 (Attribute Tracks)

타임라인은 속성 트랙을 정의할 수 있습니다. 이는 키프레임을 정의하여 특정 환경 속성에 대한 수정자가 시간이 지남에 따라 어떻게 변하는지 지정합니다.

속성에 따라 각 키프레임 사이에 보간이 사용될 수 있습니다. 보간이 사용되지 않으면 이전 키프레임 값이 항상 선택됩니다.
예시: period_ticks가 24000인 타임라인은 다음과 같이 설정될 수 있습니다.
- 시간 = 0일 때, sky_color = #ff0000 (빨간색)
- 시간 = 1000일 때, sky_color = #ff0000 (빨간색)
- 시간 = 6000일 때, sky_color = #ff00ff (자홍색)
- 시간 0에서 1000 사이에는 하늘색이 빨간색입니다. 1000에서 6000 사이에는 빨간색에서 자홍색으로 점진적으로 변합니다. 그런 다음 6000부터 타임라인이 반복되어 다시 시간 0에 도달할 때까지 색상은 천천히 빨간색으로 돌아갑니다.
생물군계와 달리, 타임라인이 override 대신 수정자를 사용하는 경우, 보간은 최종 수정된 값 대신 수정자 인수에 적용됩니다.

속성 트랙 형식

타임라인 내에 지정된 속성 트랙은 다음 필드를 가진 객체 형식입니다.

ease (선택 사항): 키프레임 간 값의 보간을 완화하는 데 사용되는 이징 유형 (아래 참조).
- 기본값: linear
- 대상 속성이 보간을 지원하지 않으면 이징 모드는 효과가 없습니다.
keyframes: 키프레임 객체 목록. ticks 필드에 따라 정렬되어야 합니다.
- ticks: integer, 0에서 period_ticks (지정된 경우) 사이의 값. 이 키프레임의 값이 활성화될 틱을 정의합니다.
- value: 수정자 인수 (선택된 수정자에 따라 형식 다름).
  - 수정자가 지정되지 않았거나 override가 사용된 경우, 이 필드의 유형은 환경 속성 자체와 동일합니다.
  - 이 값이 사용되는 방식은 수정자 유형에 따라 다릅니다.
  - 참고: 최대 두 개의 키프레임이 동일한 틱에 배치될 수 있으며, 즉각적인 전환을 생성합니다.
modifier (선택 사항): 문자열 수정자 ID (속성 유형에 따라 다름).
- 기본값: override
예시: 다음 타임라인은 period_ticks가 24000이며, minecraft:gameplay/cat_waking_up_gift_chance만 수정하는 속성 트랙을 가집니다. 이징이 constant이므로 틱 362에서 23667 사이에는 값이 0.0이고, 틱 23667에서 362 사이에는 0.7입니다.다른 환경 속성 소스와 마찬가지로, 지정된 값은 지정된 수정자의 인수로 사용됩니다. 그런 다음 낮은 우선순위의 소스 위에 적용됩니다. 이 경우 수정자는 maximum이므로, 이 타임라인은 cat_waking_up_gift_chance의 값을 트랙에 지정된 값으로만 증가시킵니다.
{ "period_ticks": 24000, "tracks": { "minecraft:gameplay/cat_waking_up_gift_chance": { "ease": "constant", "modifier": "maximum", "keyframes": [ { "ticks": 362, "value": 0.0 }, { "ticks": 23667, "value": 0.7 } ] } } }

이징 유형 (Easing Types)

이징 유형은 곡선을 적용하여 두 키프레임 간의 보간을 제어합니다. 다음 내장 이징 유형이 제공됩니다.

constant – 항상 이전 키프레임을 선택합니다.
linear
in_back, in_bounce, in_circ, in_cubic, in_elastic, in_expo, in_quad, in_quart, in_quint, in_sine
in_out_back, in_out_bounce, in_out_circ, in_out_cubic, in_out_elastic, in_out_expo, in_out_quad, in_out_quart, in_out_quint, in_out_sine
out_back, out_bounce, out_circ, out_cubic, out_elastic, out_expo, out_quad, out_quart, out_quint, out_sine
이징 유형은 {"cubic_bezier": [x1, y1, x2, y2]} 형식의 큐빅 베지어 곡선으로도 지정할 수 있습니다.
- x1: float, 0과 1 사이의 값, 첫 번째 제어점의 x 좌표.
- y1: float, 첫 번째 제어점의 y 좌표.
- x2: float, 0과 1 사이의 값, 두 번째 제어점의 x 좌표.
- y2: float, 두 번째 제어점의 y 좌표.

공통 데이터 유형

몹 활동 (Mob Activity): minecraft:activity 내장 레지스트리의 문자열 ID. 다음 중 하나:
- minecraft:core, minecraft:idle, minecraft:work, minecraft:play, minecraft:rest, minecraft:meet, minecraft:panic, minecraft:raid, minecraft:pre_raid, minecraft:hide, minecraft:fight, minecraft:celebrate, minecraft:admire_item, minecraft:avoid, minecraft:ride, minecraft:play_dead, minecraft:long_jump, minecraft:ram, minecraft:tongue, minecraft:swim, minecraft:lay_spawn, minecraft:sniff, minecraft:investigate, minecraft:roar, minecraft:emerge, minecraft:dig

수정자 (Modifiers)

blend_to_gray RGB/ARGB 수정자: 색상을 회색조 형태로 변환하고, 밝기 수정자를 적용한 다음, 특정 요소를 사용하여 혼합하여 색상을 수정합니다.
- gray = brightness * (0.3 * red + 0.59 * green + 0.11 * blue), result = lerp(factor, subject, [gray, gray, gray])
- 인수 형식: 필드를 가진 객체
  - brightness: float, 0과 1 사이의 값, 회색조 값에 적용할 배수.
  - factor: float, 0과 1 사이의 값, 혼합할 요소.

리소스 팩 (Resource Packs)

팩 버전: 리소스 팩 버전은 이제 75.0입니다.

블록 모델 (Block models)

블록 모델 요소는 이제 여러 축을 중심으로 회전할 수 있습니다.
- 모델은 먼저 X축, 그 다음 Y축, 마지막으로 Z축을 중심으로 회전합니다.
- 새로운 필드:
  - x: X축 주위의 회전 각도(도), float, 기본값 0.0
  - y: Y축 주위의 회전 각도(도), float, 기본값 0.0
  - z: Z축 주위의 회전 각도(도), float, 기본값 0.0
- 기존의 axis와 angle 항목도 계속 사용할 수 있습니다.
- 두 표기법이 모두 있는 경우, 이전 표기법이 우선합니다.
- angle 값에 대한 기존 제한([-45, 45])이 제거되었습니다.
- 참고: 면의 이름은 회전에 영향을 받지 않습니다. 컬링과 같이 면에 의존하는 기능은 항상 원래 방향을 사용합니다.

블록 상태 정의 (Blockstates definition)

블록 상태 정의 파일(assets/minecraft/blockstates/에 정의됨)의 변형(variants)은 이제 Z축을 중심으로도 회전할 수 있습니다.
- 새로운 선택적 필드 z는 기존 x 및 y 필드와 동일한 형식을 가집니다: 허용되는 값이 0(기본값), 90, 180, 270인 정수.
- Z축 주위의 회전은 X와 Y축 다음으로 적용됩니다.

아이템 모델 (Item models)

모든 아이템 모델에 새로운 옵션이 추가되었습니다.
- swap_animation_scale: 기본값 1.0. 핫바에서 아이템을 교체할 때 아이템이 위아래로 움직이는 속도를 나타냅니다. 큰 속도는 아이템이 다음 아이템으로 교체되기 전에 화면 밖으로 완전히 내려가게 할 수 있습니다.
새로운 아이템 모델 추가:
- spear_in_hand: 손에 창을 들고 있을 때의 모델.

셰이더 및 후처리 효과 (Shaders & Post-process Effects)

block.vsh/fsh는 terrain.vsh/fsh를 복사하고 임시 블록(예: 엔티티가 들고 있는 블록)을 처리합니다.
terrain.vsh에서 사용되는 ChunkSection 유니폼이 추가되었습니다 (DynamicTransforms 대체).
GPU 기반 스프라이트 애니메이션을 수행하기 위한 새로운 셰이더가 도입되었습니다.
Globals 유니폼은 이제 카메라 좌표를 가집니다.
terrain 코어 셰이더는 이제 블록 아틀라스 텍스처를 가장 가까운 이웃(nearest neighbour) 대신 선형(linearly)으로 샘플링합니다.

스프라이트 애니메이션 (Sprite Animations)

스프라이트(더 큰 아틀라스의 일부인 텍스처)는 이제 CPU에서 틱당 처리되는 대신 GPU에서 애니메이션됩니다.
일반 프레임 기반 애니메이션의 경우, animate_sprite.vsh 및 animate_sprite_blit.fsh가 사용됩니다.
보간된 애니메이션의 경우, animate_sprite.vsh 및 animate_sprite_interpolate.fsh가 사용됩니다.
UBO SpriteAnimationInfo는 더 큰 텍스처 아틀라스 내에서 스프라이트를 어디에 그려야 하는지에 대한 정보를 포함합니다.

텍스처 아틀라스 (Texture atlases)

아이템 텍스처가 블록 아틀라스에서 분리되어 밉맵이 없는 새로운 items 아틀라스로 분리되었습니다.
- 아이템 모델에 사용된 모든 텍스처는 동일한 아틀라스(items 또는 blocks)에서 와야 합니다.
- 블록 모델에 사용된 모든 텍스처는 blocks 아틀라스에서 와야 합니다.
- 블록 아틀라스의 아이템 텍스처를 참조하던 명령은 이제 아이템 아틀라스를 참조해야 합니다.
정의된 아틀라스에서 스프라이트 이름이 공유되면 게임에서 경고를 출력합니다.
celestials.png-atlas:
- 태양, 달과 같이 하늘에 렌더링되는 객체에 대한 스프라이트를 포함하는 새로운 celestials 아틀라스가 도입되었습니다.
- <namespace>:textures/environment/celestial/<path>.png의 스프라이트를 포함합니다.
- textures/environment/sun.png -> sun
- textures/environment/end_flash.png -> end_flash
- textures/environment/moon_phases -> moon/full_moon, moon/waning_gibbous, moon/third_quarter, moon/waning_crescent, moon/new_moon, moon/waxing_crescent, moon/first_quarter, moon/waxing_gibbous로 이동되었습니다.

텍스처 (Textures)

월드의 모든 블록은 이제 비디오 설정에서 활성화된 경우 밉맵이 적용됩니다.
이전에는 밉맵이 없었던 덩굴, 레일, 잎사귀(나뭇잎 제외) 등과 같은 블록이 더 먼 거리에서 더 잘 보입니다.
블록 애니메이션 텍스처의 경우 밉맵 레벨 0과 1만 애니메이션됩니다.
유리 및 유리판은 이제 반투명 텍스처를 지원합니다.
모든 밉맵 레벨이 블록 애니메이션 텍스처에 대해 다시 애니메이션됩니다.
신호기 및 레드스톤 가루는 이제 반투명 텍스처를 지원합니다.
정지된 물과 용암에 사용되는 텍스처는 이제 minecraft:block/water_still 및 minecraft:block/lava_still로 하드코딩됩니다.
*.mcmeta 파일의 texture 섹션에 새로운 필드 mipmap_strategy가 추가되었습니다.
- mean: 대부분의 단색 또는 반투명 전체 블록 텍스처의 기본 전략. 색상과 알파를 평균화합니다.
- dark_cutout: 나뭇잎과 맹그로브 뿌리에 대한 전략. 컷아웃 픽셀과 인접한 픽셀을 어둡게 블렌딩합니다.
- cutout: 이번 버전에 밉맵이 적용된 대부분의 컷아웃 블록에 사용되는 새로운 전략. 이전 밉맵 대신 원본 텍스처를 기반으로 생성합니다.
- strict_cutout: 더 엄격한 알파 컷오프 값을 사용하는 cutout의 변형. 높은 밉맵 레벨에서 텍스처가 사라질 수 있으며, 꽃 등에 사용됩니다.
- auto: 기본값이며, 투명 픽셀이 없는 텍스처에는 mean을, 있는 텍스처에는 cutout을 선택합니다.
*.mcmeta 파일의 texture 섹션에 alpha_cutoff_bias 필드가 추가되어 컷아웃 텍스처의 알파 바이어스를 제어합니다.
- 기본값은 0.0입니다. 값이 클수록 멀리서 텍스처가 얇아/투명해지고, 작을수록 불투명해집니다.

UI

메뉴 슬라이더는 이제 마우스로 드래그한 후 놓을 때 가장 가까운 사용 가능한 값에 "고정"됩니다.
키보드를 사용하여 슬라이더 값을 변경할 때 화살표 키는 이제 슬라이더를 1픽셀이 아닌 다음 사용 가능한 값으로 이동합니다.
언어 선택 화면에 언어를 필터링하기 위한 검색 상자가 추가되었습니다.
UI 스프라이트:
- 새로운 UI 스프라이트 추가: container/slot/nautilus_armor, container/slot/nautilus_armor_inventory, container/slot/spear.
- 새로운 나인-슬라이스 스프라이트 추가: container/inventory/effect_background, container/inventory/effect_background_ambient.
- 제거된 스프라이트: container/inventory/effect_background_large, container/inventory/effect_background_small.

사운드 (Sounds)

모루 파괴, 착지, 설치 및 사용 소리가 약간 낮은 볼륨으로 재생됩니다.

데이터 팩 (Data Packs)

데이터 팩 버전은 이제 94.1입니다.

태그 (Tags)

새로운 태그 목록

바이옴 태그:
- #spawns_coral_variant_zombie_nautilus: 산호 변종 좀비 노틸러스가 스폰되는 생물군계.
- #snow_golem_melts, #increased_fire_burnout, #plays_underwater_music, #has_closer_water_fog, #without_patrol_spawns 태그는 삭제되고 환경 속성으로 대체되었습니다.
블록 태그:
- #can_glide_through: 타고 오를 수 있는 블록 중 겉날개 활공 시 멈추지 않고 통과할 수 있는 블록.
엔티티 태그:
- #burn_in_daylight: 햇빛에 타는 엔티티.
- #can_float_while_ridden: 탑승 상태로 물에 뜨는 엔티티.
- #can_wear_nautilus_armor: 노틸러스 갑옷을 입을 수 있는 엔티티.
- #nautilus_hostiles: 노틸러스가 길들여지지 않았을 때 적대하는 엔티티.
- #can_equip_saddle: 안장을 장착할 수 있는 엔티티(카멜 허스크, 노틸러스, 좀비 노틸러스 추가).
- #can_breathe_under_water: 물속에서 숨쉴 수 있는 엔티티(노틸러스 추가).
- #aquatic, #cannot_be_pushed_onto_boats, #not_scary_for_pufferfish에 노틸러스 및 좀비 노틸러스 추가.
- #can_wear_horse_armor에 좀비 말 추가.
- #skeletons에 parched 추가.
- #zombies에 카멜 허스크, 좀비 노틸러스 추가.
아이템 태그:
- #camel_husk_food: 카멜 허스크에게 먹일 수 있는 아이템.
- #enchantable/lunge: 런지 마법 부여가 가능한 아이템.
- #enchantable/melee_weapon: 검과 창을 포함한 모든 주요 근접 무기.
- #nautilus_bucket_food: 길들인 노틸러스와 좀비 노틸러스에게 먹일 수 있는 물고기 양동이 아이템.
- #nautilus_food: 길들인 노틸러스와 좀비 노틸러스에게 먹일 수 있는 아이템.
- #nautilus_taming_items: 노틸러스와 좀비 노틸러스를 길들일 수 있는 아이템.
- #spears: 모든 창 무기.
- #zombie_horse_food: 길들인 좀비 말에게 먹일 수 있는 아이템.
- #piglin_loved: 황금 노틸러스 갑옷, 황금 창 추가.
- #piglin_preferred_weapons: 황금 창 추가.
- #enchantable/durability에 #spears 추가.
- #enchantable/sword는 #enchantable/sweeping으로 이름 변경.
- #enchantable/fire_aspect, #enchantable/sharp_weapon의 기존 #enchantable/sword 태그는 #enchantable/melee_weapon으로 변경.
타임라인 태그:
- #universal: 모든 차원에서 활성화되는 타임라인.
- #in_overworld: 오버월드에서 활성화되는 타임라인.
- #in_nether: 네더에서 활성화되는 타임라인.
- #in_end: 엔드에서 활성화되는 타임라인.
데미지 태그:
- #is_player_attack, #no_knockback에 spear 추가.
마법 부여 태그:
- #non_treasure, tooltip_order에 lunge 추가.

마법 부여 (Enchantment)

정의: exponent 필드가 추가되었습니다.
- base: 지수의 밑이 되는 레벨 기반 값.
- power: 지수의 거듭제곱이 되는 레벨 기반 값.

마법 부여 효과 구성요소:
- minecraft:post_piercing_attack: 아이템으로 관통 공격 후 적용되는 효과.

엔티티 효과:
- minecraft:apply_exhaustion: 대상 엔티티에게 피로도(허기 소모)를 적용합니다. amount 필드로 양을 조절하며 플레이어에게만 효과가 있습니다.
- minecraft:apply_impulse: 대상 엔티티에게 물리적 힘을 가합니다.
  - direction: 로컬 좌표 벡터(엔티티가 보는 방향 기준).
  - coordinate_scale: 월드 공간의 각 축(X, Y, Z)에 대해 결과 벡터를 스케일링.
  - magnitude: 최종 벡터 크기를 조절하는 레벨 기반 값.
사운드: minecraft:play_sound가 이제 사운드 이벤트 식별자 목록을 지원합니다. 마법 부여 레벨에 따라 목록의 해당 인덱스에 있는 소리를 재생하며, 레벨이 더 높으면 마지막 소리를 재생합니다.

술어 (Predicates)

구성요소 존재 확인: 모든 구성요소 유형에 대해 빈 객체 {}를 사용하여 값에 상관없이 해당 구성요소가 존재하는지 확인할 수 있습니다.
- 예: {predicates:{written_book_content:{}} (내용 상관없이 책이 쓰여졌는지 확인)
- 예: {predicates:{instrument:{}} (악기 구성요소 존재 확인)
엔티티 술어 (Entity Predicates):
- flags 필드에 새로운 플래그 추가:
  - is_in_water: 엔티티가 물이나 거품 기둥에 닿아 있는지 확인.
  - is_fall_flying: 엔티티가 겉날개로 활공 중인지 확인.
아이템 술어 (Item Predicates):
- 명령어 형식의 아이템 술어에서도 빈 객체 {}를 사용하여 구성요소 존재 여부를 확인할 수 있습니다.
- *[instrument]와 *[instrument={}]는 동일하게 취급됩니다.

기타 주요 변경 사항

피해 유형 (Damage Types)

새로운 minecraft:spear 피해 유형이 추가되었습니다.

차원 유형

effects 필드가 skybox와 cardinal_light로 대체되는 등 많은 필드가 환경 속성으로 이전되었습니다. timelines 필드가 추가되었습니다.
- skybox: none, overworld, end 중 하나.
- cardinal_light: default, nether 중 하나.
- fixed_time 필드가 has_fixed_time 불리언 필드로 대체되었습니다.

엔티티 데이터

AngryAt 필드가 angry_at으로 이름이 변경되고, AngerTime이 anger_end_time으로 대체되었습니다.

몹 변종

좀비 노틸러스 변종이 추가되었습니다. (minecraft:zombie_nautilus)
- data/<namespace>/zombie_nautilus_variant/<id>.json 경로에 정의됩니다.
- spawn_conditions 필드에 minecraft:biome, minecraft:moon_brightness, minecraft:structures 등의 조건을 사용할 수 있습니다.

그 외

청크 로딩: 이제 청크가 갑자기 나타나는 대신 서서히 페이드 인(fade in) 됩니다. 이 페이드 인 시간은 비디오 설정에서 조절할 수 있습니다.
탑승물: 플레이어가 탑승했을 때 말, 당나귀, 노새, 낙타가 더 이상 물에 가라앉지 않습니다. (#can_float_while_ridden 태그 관련)
발전과제:
- 새로운 몹(카멜 허스크, 노틸러스 등) 및 효과와 관련하여 "How Did We Get Here?", "Two by Two", "Monster Hunter", "A Throwaway Joke" 등 여러 발전과제가 업데이트되었습니다.
- 새로운 spear_mobs 발전과제 트리거가 추가되었습니다.
  - player: 선택적 엔티티 술어, 운동학적 무기를 사용하는 플레이어.
  - count: 선택적 정수, 운동학적 무기를 한 번 사용하여 맞춘 몹의 수.
설정: 그래픽 설정이 "사전 설정"으로 개편되었고, 비디오 설정 화면이 재구성되었습니다.
- 사전 설정: "Fast", "Fancy", "Fabulous!", "Custom"
- "See-Through Leaves", "Weather Effect Radius", "Improved Transparency" 등이 독립적인 설정으로 분리되었습니다.
통계: minecraft:nautilus_one_cm (노틸러스 이동 거리) 통계가 추가되었습니다.
서버: Minecraft Server Management Protocol 버전이 2.0.0으로 업데이트되었습니다. ClientFps JFR 이벤트가 추가되었습니다.

마인크래프트 JE 1.21.9 기술적 업데이트 정리

Potan — Sat, 4 Oct 2025 17:32:23 +0900

마인크래프트 자바에디션 1.21.9 – 기술적 업데이트 정리

해당 글은 마인크래프트 위키(Minecraft Wiki)의 내용을 바탕으로 작성되었습니다.

이 글의 작성에는 AI가 사용되었습니다.

일반

데이터 팩 버전이 88.0으로 업데이트되었습니다.
리소스팩 버전이 69.0으로 업데이트 되었습니다.
- pack.mcmeta 의 작성 방식이 변경되었으니 하단의 pack.mcmeta를 확인해주시기 바랍니다.

이제 세계의 경계는 차원별로 다르게 설정됩니다.
구성요소의 플레이어 프로필은 이제 자동으로 변경되었는지 확인하지 않습니다.
사슬의 id가 변경되었습니다. (chain -> iron_chain)

파티클

새로운 파티클 copper_fire_flame이 추가되었습니다.
dragon_breath
- 새로운 선택사항 항목 power (기본값 1.0)
  - 랜덤 생성 이후 속도에 곱해집니다.
instant_effect, effect
- 새로운 선택사항 항목 power (기본값 1.0), color (기본값 0xFFFFFF)이 추가되었습니다.
flash
- 이제 color 항목을 요구합니다.

명령어 (Commands)

/fetchprofile (신규)

마인크래프트 서버에서 플레이어 프로필 정보를 가져오는 새로운 명령어입니다. 이 명령어는 비동기 방식으로 작동하여, 실행 중에도 게임이 멈추지 않고 완료 시점에 결과가 출력됩니다.

성공 시 출력 내용:
- minecraft:profile 구성 요소를 복사할 수 있는 메시지.
- 해당 구성 요소가 적용된 플레이어 머리를 얻는 /give 명령어 실행하기
- 해당 프로필이 적용된 마네킹을 소환하기
- 해당 머리를 출력할 수 있는 텍스트 구성요소 복사하기
문법:
- /fetchprofile name <플레이어 이름>:
  - 플레이어 이름으로 프로필을 찾습니다 (대소문자 무관).
- /fetchprofile id <UUID>:
  - 플레이어의 UUID로 프로필을 찾습니다.

예시: /fetchprofile name Potan7

기타 명령어 변경 사항

/setworldspawn, /spawnpoint:
- 기존의 angle 입력이 삭제되었습니다.
- 대신 yaw와 pitch를 입력받는 rotation 입력이 추가되었습니다.

/setworldspawn은 이제 오버월드로 한정되지 않고 다른 차원도 설정 가능합니다. (지옥에 정박이 없이 리스폰하기 등)
서버 명령어: 이제 서버 명령어는 항상 오버월드에서 실행되는 대신, 리스폰 차원에서 실행되는 것을 기본으로 합니다.
/summon: 난이도가 '평화로움'일 때 몬스터를 소환하려고 하면 이제 실패합니다.

엔티티 (Entities)

플레이어 (minecraft:player)

플레이어의 리스폰 관련 데이터 구조가 변경되었습니다.

respawn 객체 내부의 필드 변경점:
- angle 필드의 이름이 yaw로 변경되었으며, 이제 필수 항목입니다.
- pitch 필드가 새롭게 추가되었으며, 이 또한 필수 항목입니다.
- dimension 필드가 필수 항목으로 변경되었습니다.

마네킹 (minecraft:mannequin)

summon 명령어로만 소환할 수 있는 새로운 기술적 엔티티 '마네킹'이 추가되었습니다.

마네킹은 연결된 플레이어가 없는 플레이어 아바타로, 평범한 엔티티처럼 기능합니다.

장비를 착용하고, 속성 및 효과를 가지며, 피해를 입을 수 있습니다.

전용 NBT 데이터:
- profile (기본값: 알렉스):
  - 엔티티에 표시할 플레이어 프로필입니다. minecraft:profile 구성 요소와 동일한 형식을 사용합니다.
- hidden_layers (선택사항):
  - 숨길 외부 스킨 레이어 목록입니다
    - cape, jacket, left_sleeve, right_sleeve, left_pants_leg, right_pants_leg, hat 등을 넣을 수 있습니다.
- pose: (기본값: standing)
  - 마네킹의 자세를 설정합니다
  - standing, crouching, swimming, fall_flying, sleeping가 가능합니다.
- main_hand (기본값: right)
  - 마네킹이 주로 사용할 손을 선택합니다.
  - right, left 가 가능합니다.
- immovable (기본값: false)
  - true로 설정 시 마네킹은 그 자리에 고정되서 움직이지 않습니다.
- description (기본값: "NPC"):
  - 스코어보드 below_score시 플레이어의 점수가 표시되는 위치에 생성되는 텍스트 컴포넌트입니다.
  - 생략 시 기본 텍스트 (entity.minecraft.mannequin.label -> "NPC") 가 설정됩니다.
- hide_description (기본값: false)
  - false로 설정 시 description이 표시됩니다.
  - 단, CustomNameVisible 설정이 true여야 표시됩니다.

게임 규칙 (Game Rules)

서버 설정 파일(server.properties)에 있던 일부 옵션이 게임 규칙으로 이전되어, 이제 서버 실행 중에도 변경할 수 있게 되었습니다.

allowEnteringNetherUsingPortals: 네더 포탈을 통한 네더 입장을 제어합니다 (기본값: true).
commandBlocksEnabled: 명령어 블록의 활성화 여부를 제어합니다 (기본값: true).
pvp: 플레이어 간의 피해를 허용할지 제어합니다 (기본값: true).
spawnMonsters: 몬스터의 자연 스폰 여부를 제어합니다 (기본값: true).
spawnerBlocksEnabled: 스포너 블록의 활성화 여부를 제어합니다 (기본값: true).
spawnChunkRadius 규칙이 삭제되었습니다.

아이템 구성요소, 블록 엔티티 데이터

minecraft:profile

이전에는 스킨이 변경되면 이를 반영해 프로필 정보가 영구적으로 변경되었습니다 예상하지 못한 문제를 방지하기 위해 이제 두 가지 동작 방식으로 나뉩니다.

정적(Static) 프로필: properties 필드가 있을 때 또는 name과 id가 모두 있거나 모두 없을 때 적용됩니다.
- 이 상태의 프로필은 항상 주어진 정보 그대로 렌더링되며, 스킨은 컴포넌트가 생성된 시점에 고정됩니다. 장식용으로 사용하는 데 적합합니다.
동적(Dynamic) 프로필: name 또는 id 중 하나만 있을 때 적용됩니다.
- 이 아이템이 렌더링될 때마다 프로필이 최신 값으로 업데이트됩니다. 즉, 대상 플레이어의 현재 스킨을 항상 표시합니다.
- 스킨 변경 사항을 보려면 클라이언트를 재시작해야 할 수 있습니다.

동일한 스킨 파일을 참조하는 프로필이여도 동적 프로필과 정적 프로필 아이템은 서로 합쳐지지 않습니다.

이전 버전의 플레이어 머리들은 일반적으로 동적 프로필로 변환됩니다.

스킨 재정의

이제 프로필 구성요소에는 기존 스킨 값을 대체하는 추가 필드를 넣을 수 있습니다.

새로운 재정의 필드:
- texture
  - 적용할 스킨의 네임스페이스 ID입니다.
  - textures 폴더에 .png 접미사를 붙여 설정합니다.
  - 만약 올바르지 않을 경우 기본 스킨이 아닌 미싱 텍스쳐가 설정됩니다.
- cape (선택사항)
  - 적용할 망토 텍스쳐의 네임스페이스 ID입니다.
  - texture 항목과 동일한 형식을 사용하며 올바르지 않을 경우 미싱 텍스쳐가 설정됩니다.
  - 설정되지 않을 경우 망토는 표시되지 않습니다.
- elytra (선택사항)
  - 적용할 겉날개 텍스쳐의 네임스페이스 ID입니다.
  - texture 항목과 동일한 형식을 사용하며 올바르지 않을 경우 미싱 텍스쳐가 설정됩니다.
  - 설정되지 않을 경우 망토 텍스쳐를 쓰거나 기본 겉날개 텍스쳐를 사용합니다.
- model (기본값 "slim")
  - wide, slime 중 하나로 스킨의 클래식, 슬림 설정과 같습니다.

minecraft:block_attacks 구성요소

만약 감소되는 데미지가 0일 경우 공격으로 인해 비활성 되지 않으며 차단으로 인한 넉백을 발생시키지 않습니다.

예시: 각도 제한 밖에서 들어오는 도끼 공격에 의해 방패가 비활성화되지 않음

해골 (minecraft:skull)

profile 필드가 아이템의 minecraft:profile 구성 요소와 동일한 형식으로 변경되었습니다.
- 이에 따라 이제 profile 필드는 변경 불가능하며, 필요한 경우에만 정보가 해석됩니다

텍스트 구성 요소 (Text Component)

object 구성 요소

object라는 새로운 유형의 텍스트 구성 요소가 추가되었습니다. 이 구성 요소를 사용하면 스프라이트 아틀라스에 있는 단일 스프라이트를 텍스트의 일부처럼 표시할 수 있습니다. 이제 문자 외의 다른 객체도 텍스트의 일부로 표시할 수 있도록 업데이트되었습니다.
형식
- type: "object" : 해당 구성요소가 object임을 설정합니다. nbt 구성요소처럼 생략이 가능하나 적는 것을 추천합니다.
- <표시할 오브젝트>

아틀라스
- 스프라이트 아틀라스에 있는 단일 스프라이트를 표시합니다.
- 리소스팩의 assets/minecraft/atlases에 아틀라스가 있습니다.
- 형식
  - atlas (기본값: minecraft:blocks)
    - 스프라이트 아틀라스의 네임스페이스 ID입니다.
  - sprite
    - 아틀라스 속 스프라이트의 네임스페이스 ID입니다.

플레이어
- 플레이어 머리를 표시합니다.
- 일부 프로필 항목만 제공될 경우 플레이어 머리의 profile 구성요소와 동일하게 처리합니다.
- 형식
  - player
    - name (선택사항)
      - 플레이어의 닉네임입니다.
    - id (선택사항)
      - 플레이어의 uuid 입니다.
    - properties (선택사항)
      - 프로필 속성 오브젝트입니다.
  - hat (기본값: true)
    - 모자 레이어를 표시할 지 여부입니다.

run_command 클릭 이벤트:

이전에는 서명이 필요한 명령어가 발동하면 조용히 무시되었지만 (/say, /me, /msg, /tell, /w, /teammsg, /tm 등)
이제는 해당 명령어를 채팅창에 입력하거나 클립보드에 복사할 수 있는 확인 화면을 표시합니다

pack.mcmeta

팩 버전에 마이너 버전이 추가되었습니다.(.x)
- 마이너 버전이 달라도 메이저 버전이 같으면 호환됩니다.
pack.mcmeta 형식이 변경되었습니다:
- supported_formats 필드가 제거되었습니다.
- pack_format 필드는 이제 선택 사항입니다.
  - 단, 데이터팩 82 버전 미만, 리소스팩 65버전 미만의 버전을 지원하는 팩에는 필수입니다.
- min_format (필수):
  - 지원하는 최소 팩 버전을 지정합니다.
  - 두개의 정수 목록 (메이저, 마이너)으로 이루어집니다. (예: [74, 1]).
  - 하나의 정수나 단일 정수 목록으로 입력 시 마이너는 0으로 처리됩니다. (예: 74 = [74] = [74, 0])
- max_format (필수): 지원하는 최대 팩 버전을 지정합니다.
  - 지원하는 최대 팩 버전을 지정합니다.
  - 두개의 정수 목록 (메이저, 마이너)으로 이루어집니다. (예: 74, 5])
  - 하나의 정수나 단일 정수 목록으로 입력 시 마이너는 int 최대치로 처리됩니다. (예: 74 = [74] = [74, 0x7fffffff)
- overlays
  - formats 항목이 삭제되고 min_format, max_format 항목이 새로 추가되었습니다.
    - formats 항목은 pack_format 처럼 구 팩을 지원시 추가되어야 합니다.
    - min_format, max_format은 위의 항목과 동일한 형식을 사용합니다.

/datapack create 명령어를 사용해서 제작한 데이터팩의 pack.mcmeta

전리품 테이블 (Loot Tables)

신규 전리품 테이블 유형

상호작용에 따른 전리품을 설정할 수 있는 새로운 유형들이 추가되었습니다.

minecraft:entity_interact: 엔티티와 상호작용 시 작동하는 새로운 전리품 테이블 유형입니다.
- target_entity: 상호작용의 대상이 되는 엔티티.
- interacting_entity: target entity와 상호작용하는 엔티티 (선택 사항).
- tool: 상호작용에 사용된 도구.
minecraft:block_interact: 블록과 상호작용 시 작동하는 새로운 전리품 테이블 유형입니다.
- block_state: 상호작용 대상 블록의 상태.
- block_entity: 상호작용 대상 블록의 블록 엔티티 (선택 사항).
- interacting_entity: block entity와 상호작용하는 엔티티 (선택 사항).
- tool: 상호작용에 사용된 도구 (선택 사항).
entity_properties.entity와 같이 대상을 지정하는 필드에서 target_entity와 interacting_entity를 사용할 수 있습니다.

신규 전리품 테이블 목록

충전된 크리퍼에게 죽은 몹들이 드랍하는 아이템을 결정하는 charged_creeper/root 전리품 테이블이 추가되었습니다.
- 이 전리품 테이블은 충전된 크리퍼에게 몹이 죽을 때 해당하는 전리품 테이블에 전달됩니다.
  - charged_creeper/piglin, charged_creeper/creeper, charged_creeper/skeleton, charged_creeper/wither_skeleton, charged_creeper/zombie
- 만약 이 전리품 테이블을 통해 아이템이 드랍했을 경우 동일한 크리퍼에게 죽은 다른 몹들은 이 전리품 테이블을 통해 아이템을 드랍하지 않습니다.

brush/armadillo: 아르마딜로를 솔질했을 때의 드롭을 결정합니다.
gameplay/turtle_grow: 아기 거북이 성체로 자랄 때의 드롭을 결정합니다.
harvest/beehive: 벌집이나 벌통에서 가위로 수확했을 때의 드롭을 결정합니다.
harvest/cave_vine: 발광 열매가 달린 동굴 덩굴과 상호작용하여 수확했을 때의 드롭을 결정합니다.
harvest/sweet_berry_bush: 달콤한 열매가 달린 덤불과 상호작용하여 수확했을 때의 드롭을 결정합니다.
carve/pumpkin: 호박을 가위로 조각했을 때의 드롭을 결정합니다.

전리품 함수 및 조건자 (Loot Functions & Predicates)

전리품 함수 (Loot Functions)
- minecraft:fill_player_head:
  - entity 필드가 새로운 엔티티 값을 받습니다.
    - target_entity, interacting_entity
- minecraft:set_lore:
  - entity 필드가 새로운 엔티티 값을 받습니다.
    - target_entity ,interacting_entity
- minecraft:copy_custom_data:
  - source필드가 새로운 엔티티 값을 받습니다.
    - target_entity, interacting_entity
- minecraft:copy_name:
  - source 필드가 새로운 엔티티 값을 받습니다.
    - direct_attacker, target_entity, interacting_entity
- minecraft:copy_components:
  - source 필드가 새로운 엔티티 값을 받습니다.
    - this, attacker, direct_attacker, attacking_player, target_entity, interacting_entity, tool
조건자 (Predicates)
- minecraft:entity_scores:
  - entity 필드가 새로운 엔티티 값을 받습니다.
    - target_entity, interacting_entity
- minecraft:entity_properties:
  - entity 필드가 새로운 엔티티 값을 받습니다.
    - target_entity, interacting_entity

인챈트 (Enchantments)

폭발 (explode) 효과

block_particles 라는 새로운 필드가 추가되어, 폭발 시 블록별로 생성될 파티클을 지정할 수 있습니다.
형식: 항목들의 리스트
- weight: (음이 아닌 정수)
  - 해당 파티클이 선택될 무작위 가중치
- particle:
  - 생성할 파티클.
- scaling: (기본값 1.0)
  - 폭발 중심과 블록 위치 사이에 적용될 크기 배율
- speed: (기본값 1.0)
  - 파티클 속도에 적용될 배율

태그 (Tags)

블록 태그

#copper_chests: 모든 구리 상자 블록을 포함합니다.
#copper: 모든 구리 블록을 포함합니다.
#incorrect_for_copper_tool: 구리 도구로 채광 시 아이템이 드롭되지 않는 모든 블록을 포함합니다.
#copper_golem_statues: 모든 구리 골렘 조각상 블록을 포함합니다.
#chains: 모든 사슬 블록을 포함합니다.
#lanterns: 모든 랜턴 블록을 포함합니다.
#bars: 모든 막대 블록을 포함합니다.

아이템 태그

#copper_chests: 모든 구리 상자 블록 아이템을 포함합니다.
#copper: 모든 구리 블록 아이템을 포함합니다.
#copper_tool_materials: 모든 구리 도구 재료를 포함합니다.
#repairs_copper_armor: 구리 갑옷을 수리하는 모든 아이템을 포함합니다.
#copper_golem_statues: 모든 구리 골렘 조각상 블록 아이템을 포함합니다.
#chains: 모든 사슬 블록 아이템을 포함합니다.
#lanterns: 모든 랜턴 블록 아이템을 포함합니다.
#bars: 모든 막대 블록 아이템을 포함합니다.
#shearable_from_copper_golem: 가위로 구리 골렘의 안장 슬롯에서 제거할 수 있는 모든 아이템을 포함합니다.

엔티티 유형 태그

#cannot_be_pushed_onto_boats: 보트로 밀어 넣을 수 없는 몹들을 포함합니다. Creaking, 플레이어, 그리고 양서류가 아닌 모든 수중 몹이 여기에 해당합니다.
#accepts_iron_golem_gift: 철 골렘이 주는 아이템을 받고 수락하는 몹들을 포함합니다.
#candidate_for_iron_golem_gift: 철 골렘이 아이템을 주려고 시도하지만, 반드시 수락하지는 않을 수 있는 몹들을 포함합니다 (#accepts_iron_golem_gift 태그도 확인해보세요).

[BlockBench Plugin][Animated Java] -3- Locator & Camera

Potan — Mon, 4 Aug 2025 23:27:14 +0900

이 글은 블록 벤치 자체에 대한 내용은 다루지 않습니다.

이 글은 마인크래프트 기초 지식을 다루지 않습니다.

개요

Locator는 별도의 큐브, 디스플레이 없이 해당 위치에서 명령어를 실행시킬 수 있는 객체입니다.

애니메이션의 특정 프레임에 명령어를 실행시키는 기능을 가지고 있습니다.

Camera는 큐브처럼 애니메이션 조작이 가능한 객체로 기본으로 있는 Locator와 달리 별도의 카메라 플러그인을 설치해주어야 합니다.

카메라는 별도의 시점이 존재하며 마인크래프트 내에서 카메라에 플레이어를 관전시켜 컷신같은 카메라 무빙을 만들어낼 수 있습니다.

생성하기

로케이터의 경우 생성 버튼 중 닻 모양 버튼을 누르면 생성할 수 있고 카메라의 경우 외곽선(Outliner)에 우클릭 후 Add Camera 버튼을 클릭합니다.

Locator Config

생성된 로케이터를 우클릭해보면 Locator Config를 열 수 있습니다.

Use Entity
- 체크 시 로케이터 역할을 하는 엔티티를 소환해서 움직입니다.

Entity Type
- Locator 역할을 할 엔티티입니다. 디스플레이나 marker를 추천합니다.
Sync Passenger
- 상위 그룹 엔티티의 회전과 자동으로 일치시킬지 여부입니다.
On-Summon Commands
- 해당 엔티티를 소환할 때 해당 엔티티 기준으로 실행될 명령어입니다.
- mcfunction의 구문과 동일하며 MC-Build 문법을 지원합니다.

Ticking Commands
- 틱마다 로케이터의 위치에서 실행할 명령어입니다.
- mcfunction의 구문과 동일하며 MC-Build 문법을 지원합니다.

배치하기

로케이터는 애니메이션 창에서 커맨드만 가능하므로 머리에 붙여서 머리를 따라 움직이도록 해주었습니다.

카메라는 적당히 뒷통수를 바라보도록 해주었습니다.

또한 로케이터는 Ticking Commands로 파티클을 계속 보여주도록 해주었습니다.

애니메이션 창

로케이터는 특정 프레임에 명령어를 실행시킬 수 있고 카메라는 큐브처럼 위치와 회전을 조작할 수 있습니다.

Fov의 경우 카메라 플러그인이 외부 플러그인이라 있는거고 AJ에서는 반영되지 않습니다.

마찬가지로 회전도 Z축은 제대로 반영되지 않습니다.

일단 카메라는 기존의 애니메이션과 동일하므로 적당히 조절해보겠습니다.

로케이터 키프레임

로케이터의 키프레임입니다. 해당 프레임에 도달했을 때 조건에 맞으면 명령어를 실행합니다.

Commands
- 실행할 명령어입니다. 위와 마찬가지로 mcfunction의 구문, MC-Build의 구문을 사용할 수 있습니다.
Repeat?
- 해당 프레임에 도달한 뒤 계속해서 반복할 지 여부입니다.
Repeat Frequency
- 반복이 시작되면 몇 틱마다 반복할 지 여부입니다. (1: 매 틱마다, 2: 2틱마다)
Execute Condition
- 해당 명령어를 실행할 조건입니다. /execute 명령어의 하위 구문을 사용합니다.

해당 틱에 도달하면 say 명령어를 실행하도록 해주었습니다.

마인크래프트에서 사용하기

내보내기 후 소환을 시켜보면 로케이터의 위치에서 파티클 명령어가 계속해서 작동하는 모습을 볼 수 있습니다.

Idle 애니메이션을 재생해보니 애니메이션에서 설정한대로 say test 명령어가 주기적으로 작동하는 모습을 볼 수 있습니다.

카메라의 경우 Axiom 모드의 엔티티 표시 기능을 통해 뒤에 존재하는 걸 확인할 수 있습니다.

카메라로써 역할을 할 수 있도록 관전 명령어를 사용해보겠습니다.

카메라 엔티티의 전용 태그는 다음과 같습니다.

aj.<네임스페이스>.camera.<카메라 이름>

이 프로젝트에서 카메라 이름이 mycamera이므로 관전 명령어는 다음과 같이 치면 됩니다.

사진으로는 확인이 잘 안되지만 제대로 관전에 들어간 모습입니다.

idle 애니메이션에서 카메라 회전을 넣어주었더니 아주 격렬하게 움직이는 모습입니다.

as_locator, as_camera, at_locator 함수

as ~ 함수는 해당 로케이터 / 카메라를 as한 상태에서 명령어를 실행해주는 함수입니다. (at~ 은 at만)

단, as~ 함수는 로케이터가 use entity를 체크한 상태여야 하며 at_camera 함수는 생성되지 않습니다.

사용하는 방법은 root 를 as로 설정한 상태로 함수를 인수와 함께 주면 됩니다.

인수는 다음과 같습니다.

name	명령어를 실행할 locator / 카메라의 이름입니다.
command	실행할 명령어입니다.

다만 as_camera의 경우 생성된 함수가 제대로 매크로 처리가 안되어있는 등 버그가 있어서 제대로 작동하지 않습니다.

만약 고쳐졌다면 위 명령어를 통해서도 관전을 시킬 수 있습니다.

마찬가지로 all_locator 함수들도 인수를 command만 받는데 제대로 작동하지 않았습니다.

이점 참고해주시기 바랍니다.

[BlockBench Plugin][Animated Java] -2- variants

Potan — Wed, 30 Jul 2025 01:06:30 +0900

이 글은 블록 벤치 자체에 대한 내용은 다루지 않습니다.
이 글은 마인크래프트 기초 지식을 다루지 않습니다.

개요

variant(변종)는 animated java에서 지원하는 텍스쳐, NBT 변경 기능입니다.

이 기능을 사용해 모델은 그대로 유지한 채 다양한 텍스쳐를 가진 엔티티를 만들 수 있습니다.

마인크래프트 바닐라에 추가된 돼지, 소, 개구리 변종을 생각하면 됩니다.

생성하기

1강에서 사용한 모델을 그대로 사용하겠습니다. 다만 색 조합이 좀 바뀌긴 했습니다.

좌측하단을 보면 VARIANTS라는 창이 존재합니다. 최소화되어있을 경우 위 화살표를 눌러서 보이게 할 수 있습니다.

새로운 변종을 생성해보겠습니다.

즉시 New Variant로 새로운 변종이 생성됩니다. 연필 모양을 눌러 수정할 수 있습니다.

이때 Default 변종은 수정이 불가능하며 모든 변종의 기본값입니다.

Display Name
- 변종의 이름입니다.
Name
- 변종의 ID로 커맨드에서 해당 변종을 참조할 때 사용합니다.
Generate Name from Display Name
- 체크하면 Display Name을 바탕으로 Name을 생성합니다.
Texture Map
- 해당 변종에서 텍스쳐를 어떻게 변경할지 설정합니다.
Included / Excluded Nodes
- excluded nodes에 있는 노드들은 텍스쳐를 변경하지 않습니다. (Map에 넣어놓아도 무시합니다)

그럼 이제 Texture Map을 직접 설정해봅시다

우선 어떤 텍스쳐를 교체할지 생성합니다. 저는 sad 변종일 경우 face -> sad_face로 바뀌도록 할겁니다.

Map을 설정하는 방법은 간단합니다. + 버튼을 누른 후 원하는 텍스쳐를 선택해줍니다.

이제 sad를 누를 때와 Default를 누를 때, 각각 표정이 달라지는 모습을 볼 수 있습니다.

적용하기

자 이제 적용을 해봅시다. 일단 1강에서 하듯이 소환하면 Default 변종으로 소환이 됩니다.

이 상태에서 변종을 적용하려면 function animated_java/<네임스페이스>/variants/<변종 이름>/apply 함수를 root 기준으로 실행시키면 됩니다.

그럼 텍스쳐가 바뀌는 것을 볼 수 있습니다.

마찬가지로 기본 모습으로 돌리고 싶다면 변종 이름을 default 로 설정하면 됩니다.

변종을 적용하는 방법은 이것말고도 하나 더 있습니다. 바로 소환할 때 준 args 를 사용하면 됩니다.

제가 만든 변종은 이름이 sad이니 variant:"sad"를 주면 될거같습니다.

그러면 바로 sad 변종을 가진 모델이 생성됩니다.

NBT 수정하기

변종은 각 그룹의 NBT도 별개로 처리합니다.

그룹을 마우스 우클릭하고 보면 Bone Config라는 칸이 존재합니다.

눌러보면 해당 그룹의 NBT를 설정할 수 있는 창이 뜹니다.

Inherit Settings
- 해당 그룹의 상위 그룹에서 NBT 정보를 똑같이 받아올지 여부입니다.
Use NBT
- 미리 제공되는 NBT 설정 기능이 아닌 직접 NBT를 작성해서 수정할 수 있게 합니다.

위 2개를 제외하고는 NBT를 간단하게 설정할 수 있는 기능들을 제공합니다.

그리고 맨 위를 보면 선택된 변종이 나오는데 이는 변종마다 이 NBT 값을 따로따로 지정할 수 있기 때문입니다.

SNBT 오류때문에 이렇게 적어야 그나마 잘 적힙니다

그래서 두 변종별로 값을 다르게 설정해보았습니다.

변종에 따라 NBT 데이터가 잘 바뀌는 모습입니다.

다만 생각한 모습과 다르게 이름이 좀 밑에서 나옵니다. Head에 해당하는 엔티티가 밑에 있어서 그런 것 같습니다.

이로서 변종에 대해 사용하는 법을 확인해보았습니다.

[BlockBench Plugin][Animated Java] -1- 기초

Potan — Thu, 24 Jul 2025 22:30:29 +0900

이 글은 블록 벤치 자체에 대한 내용은 다루지 않습니다.

이 글은 마인크래프트 기초 지식을 다루지 않습니다.

설치하기

Animated Java (AJ)는 블록벤치의 플러그인입니다. 따라서 간단히 플러그인 스토어 메뉴에서 설치할 수 있습니다.

설치한 뒤에는 새로 만들기에 Blueprint를 선택할 수 있습니다.

설정

처음 Animated Java Blueprint를 생성하면 설정창이 뜨게 됩니다.

많은 내용의 설정이 있고 모든 스크롤을 사진에 담을 수 없으니 간단히 필요한 내용만 글로 설명하고 넘어가겠습니다.

기본

Blueprint Name
- 블루프린트의 이름입니다.
- 블록벤치에서 블루프린트를 구별하고, 저장할 때 파일의 이름으로 사용됩니다.

Texture Size
- 프로젝트에서 가장 큰 텍스쳐의 크기입니다.
- 만약 큰 텍스쳐가 바뀐다면 그에 맞추어 설정을 바꿔주어야 UV 편집기가 제대로 작동합니다.

Show Bounding Box
- 모델의 바운딩 박스 표시 여부입니다.
- 모델의 바운딩 박스가 화면 밖에 있을 경우 물체는 렌더링되지 않습니다.
  - 모델의 크기가 크면 바운딩 박스를 그만큼 맞춰줘야 모델이 갑자기 화면에서 보이지 않는 현상을 방지할 수 있습니다.
  - 단, 너무 넉넉하게 하면 보이지 않아야할 때도 렌더링하므로 성능에 악영향을 줍니다.

Auto Bounding Box
- 모델의 바운딩 박스를 모델의 모양에 맞춰 자동으로 맞춰줍니다.
- 애니메이션에는 반영되지 않으므로 애니메이션이 크게 움직인다면 바운딩 박스를 수동으로 조절해줘야합니다.

내보내기

Export Namespace
- 내보내기했을 때 리소스팩과 데이터팩에 설정될 네임스페이스입니다.

Target Minecraft Version
- 대상으로 하는 마인크래프트 버전입니다.

리소스팩 설정

Display Item
- 모델을 적용할 아이템입니다.
- 아이템 디스플레이 소환 -> 커스텀 모델 적용 형태라 원본을 해치지 않습니다.
- 수정하지 않아도 되는 설정이나 설명을 위해 추가했습니다.

Resource Pack
- 내보내기 시 파일을 적용할 리소스팩 경로입니다.
- pack.mcmeta가 존재하는 곳을 지정하면 됩니다.

데이터팩 설정

Data Pack
- 내보내기 시 파일을 적용할 데이터팩 경로입니다.
- pack.mcmeta가 존재하는 곳을 지정하면 됩니다.

On-Summon Commands
- summon 함수에 들어갈 추가 명령어들입니다.
- 루트 엔티티 기준으로 실행됩니다.
On-Remove Commands
- 모든 remove 함수에 들어갈 추가 명령어들입니다.
- 루트 엔티티 기준으로 실행됩니다.
Ticking Comamnds
- 매 틱마다 루트 엔티티의 위치에서 애니메이션 로직 이후 실행될 추가 명령어들입니다.

애니메이션 만들어보기

앞으로 이 강좌에서는 tuto_namespace를 Export Namespace로 사용하겠습니다.

모델 만들기

이제 모델을 생성하고 애니메이션을 만들 시간입니다.

Show Bounding Box를 체크할 경우 저렇게 주황색 큐브가 나타나 박스가 어떻게 생겼는지 알려줍니다.

간단히 애니메이션을 적용할 모델을 만들기 전에 생성 버튼이 상당히 많아졌습니다만

순서대로 블록 디스플레이, 텍스트 디스플레이, 아이템 디스플레이, 로케이터, 큐브, 그룹 추가, 추가옵션 전환이라서 쉽게 알 수 있습니다. 로케이터는 나중에 다루겠습니다.

디스플레이의 경우 위에 뜨는 Displayed Block 을 수정해서 설정할 수 있습니다.

대충 큐브 3개랑 텍스쳐 2개로 만든 캐릭터입니다. 귀엽죠?

이때 AJ 에서는 모든 요소가 그룹에 속해야만 하며 애니메이션에서는 그룹만 제어가 가능합니다. 따라서 애니메이션을 넣을 파츠별로 그룹을 설정해두시길 바랍니다.

애니메이션 만들기

이제 오른쪽 위 버튼을 통해 애니메이션 창으로 이동합니다.

이곳에서는 애니메이션을 직접 만들고 관리할 수 있습니다.

왼쪽 상단의 애니메이션 창을 통해 애니메이션을 추가해봅시다.

Animation Name
- 애니메이션의 이름입니다.
Loop Mode
- 애니메이션이 종료된 뒤 어떻게 할지 설정합니다.
- Once : 한번 재생 된 뒤 처음으로 돌아가서 멈춥니다.
- Hold : 한번 재생 된 뒤 마지막 프레임 상태에서 중지됩니다.
- Loop : 애니메이션을 무한 반복합니다.
Loop Delay
- Loop 모드일 때 다시 Loop하기까지 걸리는 딜레이입니다.
Nodes
- Excluded Nodes에 있는 노드들은 애니메이션에서 관여하지 않습니다.
- 예를 들어 걷기에는 다리만 Includeed에 넣고 공격에는 팔만 넣어놓으면 두 애니메이션을 동시에 실행할 수 있습니다.

이번엔 Idle, Move 2개의 애니메이션을 만들어보겠습니다. 둘다 Loop로 지정합니다.

이때 저장을 누르면 저장 창이 2번 뜰 텐데 당황하지 말고 같은 파일로 저장하면 됩니다.

만약 다른 파일로 저장하면 Idle과 Move가 분할됩니다.

자 이제 애니메이션을 만들어야 합니다.

수정할 애니메이션을 선택한 채로 노드를 움직이면 해당 시간에 키프레임이 기록됩니다.

시간을 바꿔가면서 모델을 조작해 애니메이션을 제작해줍니다.

녹화 후 모델이 수정되어서 노드가 살짝 다릅니다

자 그러면 이제 마인크래프트에서 확인해봅시다

위 탭 중 Animated Java - Export 버튼을 통해 내보내기를 할 수 있습니다.

그러면 이제 데이터팩에 엄청나게 많은 함수가 나타날 것입니다.

이제 간단히 소환하고, 애니메이션을 재생하고, 제거해보겠습니다.

마인크래프트에서 다뤄보기

우선 가장 먼저 소환을 시켜봅시다. animated_java:<네임스페이스>/summon 함수로 소환할 수 있습니다.

하지만 위 커맨드로 소환 시 인수가 누락되었다면서 오류가 발생합니다.

따라서 인수를 넘겨주어야하는데

args 를 통해 넘겨주면 됩니다. 기본적인 소환이며 추가할 수 있는 인수의 목록은 다음과 같습니다.

이름	타입	설명
variant	문자열	소환할 모델 변형입니다. 없으면 기본 변형이 사용됩니다.
animation	문자열	소환시 모델의 포즈로 사용할 애니메이션의 이름입니다. 없으면 기본 포즈로 설정됩니다.
frame	정수	애니메이션의 어떤 프레임을 기본 포즈로 사용할 시 설정합니다. 없으면 첫번째 프레임이 설정됩니다. animation 인수가 존재해야합니다.
start_animation	불린	애니메이션을 재생하면서 소환할지 설정합니다. animation 인수가 존재해야합니다.

이때 플레이어의 방향을 따라가며 소환되므로 밑 사진처럼 이상한 방향을 바라보며 소환할 수 있으니 주의하시기 바랍니다.

삭제의 경우 생성과 다르게 3가지의 함수가 있습니다.

remove/all은 모든 모델을 제거합니다.

remove/entities는 모든 모델 관련 엔티티를 제거합니다.

remove/this는 execute as 로 루트 엔티티를 설정 후 함수를 작동시키면 해당 엔티티가 제거됩니다.

루트 엔티티의 태그는 aj.<네임스페이스>.root 입니다. (내보내기 네임스페이스)

따라서 remove/this를 사용할 때는 이런 식으로 사용합니다.

그 외에도 aj.global.root 태그를 통해 모든 animated_java로 생성한 모델들을 선택할 수 있습니다.

이제 애니메이션을 재생하고 정지시켜봅시다.

애니메이션은 animated_java:<네임스페이스>/animations/<애니메이션 이름>/ 경로로 여러 함수가 생성됩니다.

또한 remove/this와 마찬가지로 root를 통해 실행시켜야 합니다.

함수 사용 예시

사용자가 주로 사용할 함수들은 다음과 같습니다.

play
- 애니메이션을 처음부터 시작합니다.
pause
- 애니메이션을 일시 중지 시킵니다.
resume
- 애니메이션을 재개합니다.
stop
- 애니메이션을 중단하고 리셋합니다.
apply_frame
- 애니메이션을 특정 프레임으로 보간합니다.
- 인수:
  - frame(정수) - 설정할 프레임입니다.

사용 예시

set_frame
- 애니메이션을 특정 프레임으로 보간 없이 설정합니다.
- 인수:
  - frame(정수) - 설정할 프레임입니다.
tween
- 현재 재생중인 애니메이션을 중지하고 이 애니메이션의 특정 프레임으로 지속시간동안 부드럽게 변환한 뒤에 해당 프레임부터 애니메이션을 재생합니다.
- 인수
  - to_frame (정수) - 설정할 프레임입니다.
  - duration (정수) - 전환에 사용할 지속시간입니다. (tick)

주의해야할 점은 A 애니메이션 진행 중 B 애니메이션의 Play 함수를 실행해도 A 애니메이션은 계속해서 진행합니다.

만약 두 애니메이션이 충돌나지 않을 경우 잘 진행되긴 하나 만약 같은 파츠를 수정할 경우 애니메이션이 꼬이는 등 문제가 발생하므로 동시 재생을 염두하고 만들지 않았을 경우 pause 후 play 하거나 tween 함수를 이용하시기 바랍니다.

이로서 간단하게 AJ를 사용한 애니메이션을 만들어보았습니다.

마인크래프트 JE 1.21.6 대화 상자(Dialog) 가이드

Potan — Thu, 5 Jun 2025 01:04:22 +0900

마인크래프트 자바에디션 1.21.6 대화 상자(Dialog) 가이드

이 글은 마인크래프트 위키의 dialog 항목을 바탕으로 작성되었습니다.

이 글은 마인크래프트 자바에디션 1.21.6 버전에 새롭게 추가된 기능인 대화 상자(Dialog)에 대한 모든 것을 다룹니다. 대화 상자가 무엇인지, 어떻게 사용하는지, 그리고 어떤 종류가 있는지 자세히 알아보겠습니다.

해당 글에는 AI가 사용되었습니다.

대화 상자(Dialog)란?

대화 상자는 플레이어에게 정보를 표시하고 입력을 받을 수 있는 간단한 모달 창입니다. 게임플레이 중 서버 관리자가 /dialog 명령어를 사용하거나, 대화 구성 요소 또는 다른 대화 상자 내의 show_dialog 액션을 통해 표시할 수 있습니다. 또한, 일시 정지 메뉴나 빠른 실행 단축키(기본 G)를 통해서도 설정된 대화 상자를 열 수 있습니다.

대화 상자를 통해 다음과 같은 다양한 상호작용이 가능합니다:

대화 구성 요소를 사용한 메시지 또는 정보 전달 (서식 있는 텍스트 및 클릭 가능한 링크 포함)
대화 상자, 토글, 슬라이더, 옵션 선택과 같은 입력 컨트롤 필드를 통한 플레이어 입력 수신
액션 버튼을 통한 명령어 실행 (권한 있는 명령어는 서버 관리자만 실행 가능)
중첩된 구조를 사용한 여러 대화 상자 간의 이동

지뢰찾기 - https://www.reddit.com/r/PhoenixSC/comments/1km6bjp/minesweeper_using_a_data_pack_and_the_new_dialog/

배드애플 - https://www.youtube.com/watch?v=GobJAxLJtkw

대화 상자는 주로 다음 세 가지 요소로 구성되지만, 정확한 내용은 유형에 따라 달라집니다:

헤더: 제목과 경고 버튼을 포함합니다.
본문 요소: 레이블, 입력, 버튼, 제출 액션 등을 포함하며, 필요한 경우 스크롤이 가능합니다.
선택적 푸터(footer): 확인 버튼과 제출 액션을 포함할 수 있습니다.

대화 상자 창이 열리면 플레이어 컨트롤이 일시적으로 비활성화되며, 사용자가 종료 액션 버튼, Esc 키 또는 대화 상자 제목 옆의 경고 버튼(타이틀 화면으로 돌아감)을 통해 창을 종료할 때까지 유지됩니다. 싱글플레이어에서는 대화 상자를 통해 게임을 일시 중지하도록 설정할 수 있으며, 이 경우 게임이 자동 저장됩니다.

대화 상자 정의 및 띄우기

대화 상자는 데이터 팩 내에서 다음과 같은 디렉토리 구조로 정의할 수 있습니다:

<데이터 팩 이름>.zip 또는 <데이터 팩 이름>/
├── pack.mcmeta
└── data/
    └── <네임스페이스>/
        └── dialog/
            └── <이름>.json

레지스트리이기 때문에 실험적 기능이 활성화되며 맵을 재시작해야합니다.

혹은 명령어 내부에서 내용을 인라인 작성하여 출력할 수 있습니다.

생성기 사용하기 ( https://misode.github.io/dialog/)

https://misode.github.io/dialog/

[Generator - Minecraft 1.21.6

misode.github.io](https://misode.github.io/dialog/)

위 사이트에서 대화 상자의 json 내용을 간편하게 생성할 수 있습니다.

이 글에서는 생성기를 사용하는데 필요한 개념만 알려드리고 예시 json 내용은 제외하도록 하겠습니다.

대화 상자 형식 (공통)

모든 대화 상자 유형에 적용되는 공통적인 최상위 필드는 다음과 같습니다:

type (문자열, 필수):
- 대화 상자 유형을 지정합니다. (minecraft:dialog_type 레지스트리의 값 중 하나)
  - minecraft:notice
  - minecraft:confirmation
  - minecraft:multi_action
  - minecraft:server_links
  - minecraft:dialog_list
title (대화 구성 요소, 필수):
- 화면 제목입니다. 특정 유형에 관계없이 항상 화면에 표시되어야 합니다.
external_title (대화 구성 요소, 선택 사항):
- 이 대화 상자로 연결되는 버튼에 사용될 이름입니다 (예: 일시 정지 메뉴).
- 지정하지 않으면 title이 사용됩니다.
body (본문 요소 목록 또는 단일 본문 요소, 선택 사항):
- 대화 상자의 본문 내용을 정의합니다. (자세한 내용은 "본문 형식" 참조)
inputs (입력 컨트롤 목록, 선택 사항):
- 플레이어 입력을 받기 위한 컨트롤 목록입니다. (자세한 내용은 "입력 컨트롤 형식" 참조)
can_close_with_escape (boolean, 선택 사항):
- Esc 키로 대화 상자를 닫을 수 있는지 여부입니다. (기본값: true)
pause (boolean, 선택 사항):
- 싱글플레이어 모드에서 대화 상자 화면이 게임을 일시 중지해야 하는지 여부입니다. (기본값: true)
after_action (문자열, 선택 사항):
- 클릭 또는 제출 작업 후 대화 상자에 수행되는 추가 작업입니다. (기본값: close)
  - close: 대화 상자를 닫고 이전의 비-대화 상자 화면으로 돌아갑니다 (있는 경우).
  - none: 아무 작업도 하지 않습니다. 즉, 현재 대화 상자 화면을 계속 열어둡니다 (싱글플레이어 모드에서 게임이 잠기는 것을 방지하기 위해 pause가 false인 경우에만 사용 가능).
  - wait_for_response: 현재 대화 상자를 "응답 대기 중" 화면으로 대체합니다.

대화 상자 유형별 형식

1. `minecraft:notice`

하나의 액션 버튼을 푸터에 가지는 간단한 알림 화면입니다.
action 필드를 추가적으로 요구하며 액션 버튼을 눌렀을 때의 기능을 설정합니다. (기본값: 대화 상자 종료 후 게임플레이 복귀)
action (클릭 액션):
- 버튼 클릭 시 수행할 작업을 정의합니다. (기본값: gui.ok(한국어:확인) 라벨을 가지며 아무 작업도 하지 않는 버튼)
- label (대화 구성 요소, 필수):
  - 버튼에 표시될 텍스트입니다.
- tooltip (대화 구성 요소, 선택 사항):
  - 버튼에 마우스를 올리거나 강조 표시했을 때 표시될 텍스트입니다.
- width (정수, 1~1024):
  - 버튼의 너비입니다. (기본값: 150)
- action (액션 객체):
  - 버튼 클릭 시 수행할 액션입니다. ("액션 형식" 참조)

2. `minecraft:confirmation`

'예/아니오' 와 같이 두 개의 액션 버튼을 푸터에 가지는 확인 화면입니다.
yes와 no 필드로 각 버튼을 정의합니다.
기본적으로 종료 액션은 no 버튼입니다.
yes (클릭 액션, 필수):
- 긍정적인 결과에 대한 액션 버튼입니다. (구조는 notice의 action과 동일)
no (클릭 액션, 필수):
- 부정적인 결과에 대한 액션 버튼입니다. (구조는 notice의 action과 동일)

3. `minecraft:multi_action`

여러 열로 배열된 스크롤 가능한 액션 버튼 목록을 표시하는 화면입니다.
exit_action 필드가 있으면 해당 버튼이 푸터에 나타나고, 없으면 푸터가 표시되지 않습니다.
- exit_action은 Esc 키 액션에도 사용됩니다.
본문에 먼저 Body가 표시되고 그 밑에 actions 버튼이 나열되기 시작합니다.
actions (클릭 액션 목록, 필수):
- 나열될 액션 버튼 목록입니다.(1개 이상) (각 항목의 구조는 notice의 action과 동일)
columns (양의 정수, 선택 사항):
- 열의 수를 나타냅니다. (기본값: 2)
exit_action (클릭 액션, 선택 사항):
- 대화 상자를 나가는 액션 버튼입니다. (구조는 notice의 action과 동일)

4. `minecraft:server_links`

여러 열로 배열된 스크롤 가능한 서버 링크 목록을 표시하는 화면입니다.
서버 링크는 서버에서 설정된 서버 링크가 자동으로 나열됩니다.
exit_action 필드가 있으면 해당 버튼이 푸터에 나타나고, 없으면 푸터가 표시되지 않습니다.
- exit_action은 Esc 키 액션에도 사용됩니다.
본문에 먼저 Body가 표시되고 그 밑에 서버 버튼들이 나열되기 시작합니다.
exit_action (클릭 액션, 선택 사항):
- 대화 상자를 나가는 액션 버튼입니다. (구조는 notice의 action과 동일)
columns (양의 정수, 선택 사항):
- 열의 수를 나타냅니다. (기본값: 2)
button_width (정수, 1~1024, 선택 사항):
- 버튼의 너비입니다. (기본값: 150)

5. `minecraft:dialog_list`

다른 대화 상자로 직접 연결되는 버튼들의 스크롤 가능한 목록을 여러 열로 배열하여 표시하는 화면입니다.
이 버튼들의 제목은 대상 대화 상자의 external_title 필드에서 가져옵니다.
exit_action 필드가 있으면 해당 버튼이 푸터에 나타나고, 없으면 푸터가 표시되지 않습니다.
- exit_action은 Esc 키 액션에도 사용됩니다.
dialogs (대화상자 ID, 대화 상자 인라인, 태그, 리스트, 필수):
- 목록에 표시할 하나 이상의 대화 상자입니다.
exit_action (클릭 액션, 선택 사항):
- 대화 상자를 나가는 액션 버튼입니다. (구조는 notice의 action과 동일)
columns (양의 정수, 선택 사항):
- 열의 수를 나타냅니다. (기본값: 2)
button_width (정수, 1~1024, 선택 사항):
버튼의 너비입니다. (기본값: 150)

본문 형식 (Body Format)

모든 대화 상자는 제목과 액션 또는 입력 사이에 내용을 설명하는 본문 요소 목록을 가질 수 있습니다.
각 요소의 유형을 결정하는 것은 type에 적히는 메세지입니다.

{
    "type": "minecraft:item",
    "item": {
        "id": "minecraft:potato"
    }
},
{
    "type": "minecraft:plain_message",
    "contents": "ㅁㄴㅇㄹ"
}

1. `minecraft:plain_message`

여러 줄의 레이블입니다.

type (문자열, 필수): minecraft:plain_message
contents (텍스트 구성 요소, 필수):
- 표시할 텍스트입니다.
width (정수, 1~1024, 선택 사항):
- 메시지의 최대 너비입니다. (기본값: 200)

2. `minecraft:item`

선택적 설명이 있는 아이템입니다.
아이템 위에 마우스를 올리면 인벤토리 슬롯에 있는 것처럼 보입니다.
너비와 높이를 기본값 이외의 값으로 설정해도 크기는 조절되지 않습니다.
설명이 있으면 아이템 오른쪽에 표시됩니다.
type (문자열, 필수): minecraft:item
item (아이템 스택 객체, 필수):
- 개수가 포함된 아이템 스택입니다.
- id (문자열, 필수):
  - 아이템 식별자입니다.
- count (정수, 필수):
  - 아이템 개수입니다.
- components (객체, 선택 사항):
  - 아이템에 대한 추가 정보입니다. (아이템 구성 요소 참조)
description (텍스트 구성 요소 또는 객체, 선택 사항):
- 아이템 설명입니다. 객체인 경우 다음 필드를 가집니다:
  - contents (텍스트 구성 요소, 필수):
    - 표시할 텍스트입니다.
  - width (정수, 1~1024, 선택 사항):
    - 메시지의 최대 너비입니다. (기본값: 200)
show_decoration (boolean, 선택 사항):
- true이면 아이템 위에 개수와 내구도 막대가 렌더링됩니다. (기본값: true)
show_tooltip (boolean, 선택 사항):
- true이면 아이템에 마우스를 올렸을 때 아이템 툴팁이 표시됩니다. (기본값: true)
width (정수, 1~256, 선택 사항):
- 요소의 가로 크기입니다. (기본값: 16)
height (정수, 1~256, 선택 사항):
- 요소의 세로 크기입니다. (기본값: 16)

입력 컨트롤 형식 (Input Control Format)

입력 컨트롤은 플레이어로부터 특정 정보를 받는 데 사용됩니다.
- 이 정보는 연관된 key 태그를 사용하여 참조할 수 있습니다
- (예: 액션 버튼 클릭 시 매크로 대체를 통해 명령어를 실행하거나 서버로 전송되는 사용자 지정 NBT 태그).
모든 입력 컨트롤 유형에는 label 필드가 있습니다.
type (문자열, 필수):
- 입력 컨트롤 유형을 지정합니다.
- minecraft:input_control_type 레지스트리의 값 중 하나
  - minecraft:text
  - minecraft:boolean
  - minecraft:single_option
  - minecraft:number_range
key (문자열, 필수):
- 데이터를 제출할 때 사용되는 값의 식별자입니다. 유효한 템플릿 인수여야 합니다 (문자, 숫자, 밑줄 _).
label (텍스트 구성 요소, 필수):
- 입력 왼쪽에 표시될 텍스트입니다.

1. `minecraft:text`

기본적인 한 줄 텍스트 입력입니다.

출력 값:
- 템플릿 대체 시: 특수 문자가 SNBT 문자열에 맞게 이스케이프 시퀀스를 사용하여 이스케이프된 내용입니다.
- 태그로 전송 시: 수정되지 않은 내용의 문자열 태그입니다.
width (정수, 1~1024, 선택 사항):
- 입력의 너비입니다. (기본값: 200)
label_visible (boolean, 선택 사항):
- 레이블 표시 여부를 제어합니다. (기본값: true)
initial (문자열, 선택 사항):
- 텍스트 입력의 초기 값입니다.
max_length (정수, 선택 사항):
- 입력의 최대 길이입니다. (기본값: 32)
multiline (객체, 선택 사항):
- 존재하는 경우 여러 줄 입력을 허용합니다. 다음 필드를 가집니다:
  - max_lines (양의 정수, 선택 사항):
    - 존재하는 경우 최대 줄 수를 제한합니다.
  - height (정수, 1~512):
    - 입력의 높이입니다.

2. `minecraft:boolean`

체크박스입니다.

출력 값:
- 템플릿 대체 시: 체크 시 on_true 값, 해제 시 on_false 값입니다.
- 태그로 전송 시: 체크 시 1b, 해제 시 0b입니다.
initial (boolean, 선택 사항):
- 체크박스의 초기 값입니다. (기본값: false (체크 해제))
on_true (문자열, 선택 사항):
- true일 때 전송할 문자열 값입니다. (기본값: 'true')
on_false (문자열, 선택 사항):
- false일 때 전송할 문자열 값입니다. (기본값: 'false')

3. `minecraft:single_option`

미리 설정된 옵션 선택입니다.

label_visible (boolean, 선택 사항):
- 레이블 표시 여부를 제어합니다. (기본값: true)
width (정수, 1~1024, 선택 사항):
- 입력의 너비입니다. (기본값: 200)
options (옵션 목록, 필수):
- 선택할 수 있는 비어 있지 않은 옵션 목록입니다.
  - option (옵션 객체): 각 옵션은 다음을 포함합니다.
    - id (문자열, 필수):
      - 제출 시 전송될 값입니다.
    - display (텍스트 구성 요소):
      - 옵션이 표시되는 방식입니다.
    - initial (boolean, 선택 사항):
      - 하나의 옵션만 true로 설정할 수 있습니다.
      - true이면 해당 옵션이 초기 선택 옵션이 됩니다.
      - 기본값: 첫 번째 옵션이 true, 나머지는 false

4. `minecraft:number_range`

숫자 슬라이더입니다.

출력 값:
- 템플릿 대체 시: 현재 값의 텍스트 표현입니다. 정수는 소수점 없이 전송됩니다.
- 태그로 전송 시: 현재 값의 float 태그입니다.
label_format (번역 키, 선택 사항):
- 레이블을 만드는 데 사용될 번역 키입니다
- 첫 번째 인수는 label 필드의 내용, 두 번째 인수는 현재 값
- 기본값: options.generic_value
width (정수, 1~1024, 선택 사항):
- 입력의 너비입니다. (기본값: 200)
start (float, 필수):
- 슬라이더의 최소값입니다.
end (float, 필수):
- 슬라이더의 최대값입니다.
step (float, 선택 사항):
- 단계 크기입니다
- 존재하는 경우 initial + <정수> * step 값만 허용됩니다.
- 없는 경우 범위 내 모든 값이 허용됩니다
initial (정수, 선택 사항):
- 슬라이더의 초기 세팅 값입니다. (기본값: 범위의 중간값)

액션 형식 (Action Format)

정적 액션 유형 (Static Action Types)

정적 액션은 입력 필드의 값에 의존하지 않는 액션입니다. 대화 구성 요소의 클릭 이벤트와 동일합니다 (open_file 제외)

기존의 action 태그 대신 type으로 변경하여 사용합니다.

예를 들어, show_dialog를 사용할 때 대화 구성 요소 사용법이 다음과 같다면

    "click_event": {
        "action": "show_dialog",
        "dialog": "custom:my_dialog"
    }

버튼의 경우 다음과 같습니다.

{
    "label": "대화 상자 표시 레이블",
    "action": {
        "type": "show_dialog",
        "dialog": "custom:my_dialog"
    }
}

open_url:
- 지정된 URL을 사용자의 기본 웹 브라우저에서 엽니다.
- type: open_url
- url (문자열):
  - 사이트의 URL입니다.
run_command:
- 지정된 명령어를 실행합니다. 플레이어가 채팅에 명령어를 입력하고 Enter 키를 누른 것처럼 실행됩니다.
- 단, /say, /tell, /teammsg와 같이 직접 채팅 메시지를 보내는 명령어는 사용할 수 없습니다.
- 채팅에서 실행되므로 플레이어는 필요한 권한을 가지고 있어야 합니다.
- 만약 권한이 요구되는 명령어를 사용할 시 경고문이 출력됩니다.
- type: run_command
- command (문자열): 실
  - 행할 명령어입니다. / 접두사는 필요하지 않습니다.
suggest_command:
- 채팅을 열고 지정된 텍스트나 명령어를 채웁니다.
- 이미 작성 중인 채팅 메시지가 있으면 덮어씁니다.
- 책에서는 작동하지 않습니다.
  - type: suggest_command
  - command (문자열): 채팅에 채울 명령어입니다. 일반 텍스트도 작동합니다.
change_page:
- 쓰여진 책에서만 사용할 수 있습니다. 해당 페이지가 존재하면 지정된 페이지로 변경합니다.
  - type: change_page
  - page (정수): 변경할 페이지입니다.
copy_to_clipboard:
- 지정된 텍스트를 클립보드에 복사합니다.
  - type: copy_to_clipboard
  - value (문자열): 복사할 텍스트입니다.
show_dialog:
- 지정된 대화 상자를 엽니다.
  - type: show_dialog
  - dialog (문자열 ID 또는 새 대화 상자 정의): 표시할 하나의 대화 상자입니다.
custom:
- 서버로 사용자 지정 이벤트를 전송합니다. 바닐라 서버에서는 효과가 없습니다.
  - type: custom
  - id (문자열): 이벤트를 식별하는 ID입니다.
  - payload (문자열, 선택 사항): 이벤트의 페이로드입니다.

동적 액션 유형 (Dynamic Action Types)

입력 컨트롤과 함께 사용할 수 있습니다.

dynamic/run_command:
- 제공된 매크로 템플릿을 사용하여 run_command 이벤트를 빌드합니다.
  - type (문자열, 필수): dynamic/run_command
  - template (문자열): 명령어로 해석될 매크로 템플릿이 있는 문자열입니다.
dynamic/custom:
- 모든 입력 값을 사용하여 minecraft:custom 이벤트를 빌드합니다.
- 모든 입력 내용은 각 입력의 key 필드 ID 아래에 해당 입력의 태그 값이 있는 복합 태그 내부에 함께 전송됩니다. 페이로드에 정적 필드를 추가할 수 있습니다.
  - type (문자열, 필수): dynamic/custom
  - additions (객체): 페이로드에 추가될 필드입니다.
  - id (네임스페이스 ID): 이벤트의 네임스페이스 ID입니다.

기본 대화 상자 태그 (Dialog Tag)

#minecraft:pause_screen_additions
- 해당 태그를 가진 대화상자가 존재할 경우 일시 정지 화면의 버그 제보하기 버튼을 대체합니다.
- 버튼에는 external_title이 표시됩니다.
- 서버 링크가 존재할 경우 서버 링크 대화 상자가 이 태그에 있는 것처럼 버튼을 대체합니다.
  - 그 경우 피드백 버튼도 대체될 수 있습니다.
- 만약 여러 대화 상자가 태그에 존재할 경우 대화 상자 리스트를 띄우는 사용자 지정 설정 대화상자를 버튼에 배치합니다.

#minecraft:quick_actions
- 해당 태그를 가진 대화 상자가 존재할 경우 빠른 행동 키 (기본값 G) 를 통해 해당 대화 상자를 띄울 수 있습니다.
- 만약 여러 대화 상자가 존재할 경우 대화 상자 리스트를 띄우는 빠른 행동 대화 상자를 띄웁니다.
  - 버튼에는 external_title이 표시됩니다.

이 가이드가 마인크래프트 1.21.6의 새로운 대화 상자 기능을 이해하고 활용하는 데 도움이 되기를 바랍니다!

마인크래프트 JE 1.21.6 기술적 업데이트 정리

Potan — Wed, 4 Jun 2025 00:32:30 +0900

마인크래프트 자바에디션 1.21.6 – 기술적 업데이트 정리

해당 글은 마인크래프트 공식 스냅샷 & 프리릴리스 기사 및 마인크래프트 위키 정보를 바탕으로 1.21.6 주요 기술적 변경 사항을 정리한 것입니다. (1.21.6 정식 출시: 2025년 6월)

해당 글에는 AI가 사용되었습니다.

명령어(Commands)

대화상자 (/dialog - 신규 명령어)

플레이어에게 대화 상자를 띄우는 명령어입니다. 대화 상자는 minecraft:dialog 레지스트리에 저장되거나 인라인으로 정의할 수 있습니다. (실험적 기능)

/dialog show <대상> <dialog>

대상 플레이어에게 대화 상자를 띄웁니다.
<대상>: 플레이어 이름, UUID 또는 플레이어 선택기입니다.
<dialog>: minecraft:dialog 레지스트리의 네임스페이스 ID 또는 인라인 대화 값입니다.
대상 플레이어 수를 반환합니다.

/dialog clear <대상>

대상 플레이어의 대화 상자를 닫습니다 (표시된 경우).
<대상>: 플레이어 이름, UUID 또는 플레이어 선택기입니다.
대상 플레이어 수를 반환합니다.

/dialog show @s minecraft:custom_options 로 호출한 대화 상자입니다.

모든 대화 상자에는 위 경고 버튼이 뜨게 됩니다.

위치 표시기 (/waypoint - 신규 명령어)

위치 표시기에 사용되는 경유지를 탐색하고 수정하는 명령어입니다.

위치 표시기에 보이는 아이콘이 경유지입니다.

/waypoint list

해당 차원의 경유지 엔티티 리스트를 출력합니다.
출력에는 차원, 경유지 수와 각 경유지 엔티티의 플레이어 닉네임 또는 엔티티 유형을 웨이포인트 색상으로 출력합니다.
만약 경유지 색상을 지정하지 않으면 흰색으로 표시됩니다.

/waypoint modify <엔티티> color <색>

해당 엔티티의 경유지 색상을 설정합니다.
<색>은 마인크래프트 대화 구성요소의 기본 색상입니다.

/waypoint modify <엔티티> color hex <hex_색상>

해당 엔티티의 경유지 색상을 16진수 색상으로 설정합니다. (예: 빨강 FF0000).

/waypoint modify <엔티티> color reset

해당 엔티티의 색을 기본값으로 설정합니다 (랜덤 색상 또는 팀 색상).

/waypoint modify <엔티티> style set <스타일>

리소스팩의 <스타일> 리소스 경로에서 경유지 스타일을 가져와 설정합니다.
기본값은 minecraft:default입니다.
게임은 경로를 확인하지 않으며, 파일을 찾지 못하면 경유지에 미싱 텍스처가 설정됩니다.

/waypoint modify <엔티티> style reset

경유지 스타일을 기본값으로 설정합니다. 위치 표시기의 기본 아이콘 동작을 복원합니다.

경유지 정보를 설정하면 list에 출력은 되나 속성의 transmit_transimit_range, transmit_receive_range에 따라 보이지 않을 수 있습니다.

버전 정보 출력 (/version - 신규 명령어)

서버의 게임 버전 정보를 출력합니다. (인수 없음)
클라이언트의 F3 + V (클라이언트 버전 정보 출력)에 해당하는 서버 버전입니다.
OP 권한이 있거나 싱글플레이일 경우 사용 가능합니다.
출력 예시는 다음과 같습니다:

Server version info: 
id = 25w17a 
name = 25w17a 
data = 4425 
series = main 
protocol = 1073742071 (0x400000f7) 
build_time = Wed Apr 23 00:48:34 NZST 2025 
pack_resource = 58 
pack_data = 74 
stable = no

각 필드의 의미는 다음과 같습니다:
- ID: 버전 ID 문자열입니다.
- Name: 사용자 친화적인 버전 이름입니다 (일반적으로 ID와 동일).
- Data: 데이터 버전입니다.
- Series: 게임이 파생된 브랜치를 식별합니다 (기본값: "main").
- Protocol: 프로토콜 버전입니다.
- Build time: 버전 빌드 타임스탬프입니다 (로컬 시간대).
- Pack resource: 리소스 팩 형식 버전입니다.
- Pack data: 데이터 팩 형식 버전입니다.
- Stable: 정식 버전은 "yes", 개발 버전은 "no"입니다.

데이터팩 생성 - /datapack create (신규 형식)

/datapack create <id> <이름>

현재 월드에 빈 데이터팩을 생성합니다.
지원되는 팩 버전은 항상 게임에서 지원하는 버전과 동일하게 설정됩니다.
서버 소유자만 사용 가능합니다.
<id>: 새 팩 이름입니다 (유효한 디렉토리 이름이어야 합니다).
<이름>: pack.mcmeta의 설명에 배치될 텍스트 구성 요소입니다.

확인 결과 data 폴더와 pack.mcmeta 파일만 생성합니다.

새로운 카테고리 - /playsound (신규 형식)

소리가 재생될 카테고리에 ui가 추가되었습니다. (/playsound <소리> ui)
- 이 카테고리에서 재생되는 소리는 게임이 정지되어도 계속 재생됩니다. (music처럼)

게임 규칙(/gamerule)

locatorBar (신규 규칙)
- 기본값은 true입니다 (서버의 경우).
- 로케이터 바의 활성화 여부를 결정합니다.
- 비활성화 시 모든 플레이어의 기존 웨이포인트가 모두 제거됩니다.

속성 (/attribute)

flying_speed (기존 속성, 적용 대상 변경)
- 가스트는 이제 이 속성을 가지고 있으며 비행 속도를 설정합니다.
camera_distance (신규 속성)
- 기본값은 4.0입니다.
- 3인칭 시점에서 플레이어 또는 관전 중인 엔티티로부터 카메라가 떨어져 있는 거리를 수정합니다.
- 탑승 중인 엔티티가 더 큰 camera_distance 속성을 가지고 있다면 해당 거리가 사용됩니다.
- 이 거리는 scale 속성과 곱해져 최종 목표 카메라 거리를 얻습니다.

부담스러워요

waypoint_transmit_range (신규 속성)
- 기본값은 0.0, 최소값은 0.0, 최대값은 60,000,000.0입니다. (플레이어 기본값: 60,000,000)
- 웨이포인트 전송 범위를 설정합니다. 범위가 0보다 큰 몹은 근처 수신자에게 웨이포인트 정보를 보냅니다.
- 예시는 /attribute @s minecraft:waypoint_transmit_range base set 0 (전송 중지, 숨김)입니다.
waypoint_receive_range (신규 속성)
- 기본값은 0.0, 최소값은 0.0, 최대값은 60,000,000.0입니다. (플레이어 기본값: 60,000,000)
- 웨이포인트 수신 범위를 설정합니다. 수신자는 범위가 0보다 클 때만 수신하며 이 범위를 벗어난 웨이포인트는 수신할 수 없습니다.
- 예시는 /attribute @s minecraft:waypoint_receive_range base set 0 (수신 중지)입니다.

아이템 구성요소 변경

attribute_modifiers

attributes_modifiers 항목에 선택적 display 필드가 추가되었습니다.
세 가지 표시 유형이 있습니다:
- default: 계산된 속성 수정자 값을 툴팁에 표시하는 현재 동작입니다.
- hidden: 속성 수정자 항목을 표시하지 않습니다.
- override: 표시되는 속성 수정자 텍스트를 대체합니다.
  - value: 기존 속성의 텍스트를 대체하는 대화 구성요소입니다.
- 예시
  - /give @p tnt[attribute_modifiers=[{id:"waypoint_receive_range",type:"waypoint_receive_range",amount:-10,operation:"add_multiplied_base",slot:"any",display:{type:"override",value:"TNT를 든 사람은 로케이트바를 볼 수 없습니다."}}]] 1

equippable

새로운 선택적 필드 can_be_sheared (boolean)가 추가되었습니다.
- true인 경우, 다른 모든 깎기 조건이 충족되면 플레이어는 가위를 사용하여 대상 몹을 마우스 오른쪽 버튼으로 클릭하여 이 장착 가능한 아이템을 제거할 수 있습니다.
- 지정하지 않으면 기본값은 false입니다.
새로운 선택적 필드 shearing_sound (sound event)가 추가되었습니다.
- 장착 가능한 아이템을 깎을 때 재생되는 사운드 이벤트입니다.
- 지정하지 않으면 기본값은 item.shears.snip 사운드 이벤트입니다.

painting/variant

더 이상 인라인 JSON을 허용하지 않습니다. ID 참조만 가능합니다.

minecraft:profile

minecraft:head 모델에서 플레이어 텍스처 로딩 지원이 중단됩니다.
대신 minecraft:player_head 모델에서 사용됩니다.

조작(Controls)

빠른 동작(Quick Action) 키 (기본값: G)

minecraft:quick_actions 대화 상자 태그로 구성된 대화 상자들을 띄웁니다.
- 태그가 비어있으면 아무 작업도 수행하지 않습니다.
- 단일 요소가 있으면 해당 대화 상자를 엽니다.
- 여러 요소가 있으면 선택할 수 있는 minecraft:quick_actions 대화 상자로 연결됩니다. (기본적으로 이 태그는 비어 있습니다)

F3 + V: 클라이언트 측 버전 정보를 출력합니다.

엔티티

투사체: 시간에 따라 변하는 목표 허용 오차 범위가 추가되었습니다 (초기 2틱은 오차 없음, 이후 틱당 0.05 블록씩 증가하여 최대 0.3 블록).

NBT 변경

모든 몹: home_pos (IntArrayTag, 집 위치), home_radius (IntTag, 집 반경) NBT 필드가 추가되었습니다. 설정 시 해당 영역 내에서 경로 탐색이 제한됩니다.
area_effect_cloud:
- Particle 필드가 custom_particle 필드로 변경되었습니다.
- 항상 entity_effect 입자의 색을 정확히 재정의합니다.
  - 지정하지 않으면 필드를 사용하지 않습니다.
  - entity_effect 또는 tinted_leaves 입자 유형은 더 이상 물약 내용물에서 색상을 상속하지 않습니다.
tnt: TNT를 점화한 엔티티를 저장하는 선택적 owner 필드 (생명체 UUID)가 추가되었습니다.
벡스: 벡스의 소유자를 저장하는 선택적 owner 필드 (몹 UUID)가 추가되었습니다.
투척용 포션: 효과를 받는 엔티티까지의 거리가 엔티티 히트박스와 물약 히트박스 간 가장 가까운 거리에 따라 결정됩니다. 직접 맞으면 전체 효과를 받습니다.

게임플레이 변경점

로케이터 바

월드의 다른 플레이어 방향을 표시하는 HUD UI 요소입니다. 경험치 바 위치에 표시됩니다.
다른 숨겨지지 않은 플레이어가 한 명 이상 있는 서버에서 경험치를 얻고 있지 않을 때 표시됩니다.
기본적으로 모든 플레이어는 자신으로부터 웨이포인트를 전송하고 모든 웨이포인트를 수신합니다.
카메라가 웨이포인트 방향 120도 이내를 향할 때 색상 표시기가 표시됩니다. 위/아래 화살표로 높낮이를 표시합니다.
팀 소속 플레이어/몹은 팀 색상으로 표시됩니다.
locatorBar 게임 규칙으로 토글 가능합니다.
웅크리거나 머리 아이템 착용, 투명화 물약 효과 시 다른 플레이어의 로케이터 바에서 숨겨집니다.
관전자는 다른 관전자에게만 표시됩니다.
웨이포인트 아이콘은 거리에 따라 다른 스프라이트를 사용합니다. /waypoint modify ... style로 변경 가능합니다.
- 기본 스타일 정의 예시는 {"near_distance": 128, "far_distance": 332, "sprites": ["minecraft:default_0", ...]}입니다.

기타 게임플레이 변경

안개: 1인칭 손/아이템 등 3D HUD 요소에도 안개가 적용됩니다. 비가 올 때 안개가 더 짙어집니다.
관전자 모드: 다른 차원으로 이동하는 엔티티를 따라 함께 순간이동하지만 관전은 중지됩니다.
3인칭 시점: 특정 대형 몹(가스트, 엔더 드래곤, 자이언트) 관전 또는 탑승 시 3인칭 카메라 거리가 증가합니다.

데이터팩(Data Packs) – 버전 79

팩 형식 버전은 79입니다.
차원 유형 정의(Dimension Type definitions): 선택적 cloud_height 필드가 추가되었습니다 (해당 차원의 구름 시작 Y 레벨, 음수 가능, 기본값은 effects 필드에 따라 다릅니다).
명령줄 인수: --quickPlaySingleplayer 인수를 식별자 없이 사용하여 마지막으로 플레이한 월드로 실행 가능합니다.
명령 구문 보고서: 필요한 권한 수준에 대한 정보를 포함합니다.

발전과제

새로운 발전과제 트리거 (`minecraft:player_sheared_equipment`)

플레이어가 엔티티의 장비를 가위로 제거하였을 경우 발동합니다.
조건
- item: 가위로 제거된 아이템입니다.
- entity: 가위질된 엔티티입니다.

대화상자(Dialog) 파일 형식

대화 상자는 data/<namespace>/dialog/<id>.json 경로에 저장되며, minecraft:dialog 레지스트리를 통해 관리됩니다. 사용자 혼란을 피하기 위해 제목 옆에 경고 표시가 나타나며, 클릭 시 사용자 지정 콘텐츠임을 알리고 월드를 나갈 수 있는 옵션을 제공합니다.

더 자세한 내용은 새로운 글로 정리해오겠습니다.

최상위 공통 필드:
- type: minecraft:dialog_type 레지스트리의 대화 상자 유형 중 하나입니다.
- title: 화면 제목입니다 (텍스트 구성 요소).
- external_title (선택 사항): 이 대화 상자로 연결되는 버튼에 사용될 이름입니다 (예: 일시 중지 화면). 없으면 title을 사용합니다.
- body (선택 사항): 본문 요소 목록 또는 단일 요소입니다.
- can_close_with_escape (선택 사항, boolean): Escape 키로 닫을 수 있는지 여부입니다 (기본값: true).
- pause (선택 사항, boolean): 싱글 플레이어 모드에서 게임을 일시 중지할지 여부입니다 (기본값: true).
- after_action (선택 사항): 클릭 또는 제출 작업 후 수행되는 추가 작업입니다 (기본값: close).
  - close: 대화 상자를 닫고 이전 비-대화 상자 화면으로 돌아갑니다.
  - none: 아무것도 하지 않습니다 (현재 대화 상자 화면을 유지하며, pause가 false일 때만 가능합니다).
  - wait_for_response: "응답 대기 중" 화면으로 대체됩니다 (5초 후 "뒤로" 버튼이 활성화됩니다).
일반적인 버튼 데이터:
- label: 버튼 레이블입니다 (텍스트 구성 요소).
- tooltip (선택 사항): 버튼 강조 또는 마우스오버 시 표시될 텍스트입니다.
- width: 버튼 너비입니다 (양의 정수, 기본값: 150).
작업 유형 (Action Types):
- 정적 대화 상자: 기존 click_event 작업 대부분을 포함합니다 (예: show_dialog). 텍스트 구성 요소의 click_event와 동일한 형식을 사용하되 action 대신 type을 사용합니다.
- minecraft:dynamic/run_command: 제공된 매크로 템플릿을 사용하여 run_command 이벤트를 빌드합니다. (template 필드)
- minecraft:dynamic/custom: 모든 입력 값을 사용하여 minecraft:custom 이벤트를 빌드합니다. (id, additions 필드)
대화 상자 유형 (Dialog Types):
- minecraft:confirmation: '예/아니오' 두 가지 작업이 있는 간단한 화면입니다. (yes, no 필드)
- minecraft:dialog_list: 다른 대화 상자로 직접 연결되는 버튼 목록입니다. (dialogs, exit_action, columns, button_width 필드)
- minecraft:multi_action: 작업 목록입니다. (actions, exit_action, columns 필드)
- minecraft:notice: 단일 작업이 있는 간단한 화면입니다. (action 필드)
- minecraft:server_links: 서버에서 받은 링크 목록입니다. (이전 "서버 링크" 화면을 대체합니다)
본문 유형 (Dialog Body Types):
- minecraft:item: 아이템과 선택적 설명입니다. (item, description, show_decorations, show_tooltip, width, height 필드)
- minecraft:plain_message: 여러 줄 레이블입니다. (contents, width 필드)
입력 컨트롤 유형 (Input Control Types): (key 필드 공통)
- minecraft:boolean: 체크박스입니다. (label, initial, on_true, on_false 필드)
- minecraft:number_range: 슬라이더입니다. (label, label_format, width, start, end, step, initial 필드)
- minecraft:single_option: 옵션 순환 버튼입니다. (label, label_visible, width, options 필드)
- minecraft:text: 텍스트 입력 필드입니다. (width, label, label_visible, initial, max_length, multiline 필드)
제출 작업 유형 (Submit Action Types): (id 필드 공통)
- minecraft:command_template: 매크로 템플릿을 사용하여 명령 빌드 및 실행을 요청합니다. (template 필드)
- minecraft:custom_form: 모든 값에서 사용자 지정 서버 클릭 작업을 빌드합니다. (id 필드)
- minecraft:custom_template: 매크로 템플릿을 사용하여 사용자 지정 서버 클릭 작업을 빌드합니다. (template, id 필드)
텍스트 구성 요소 클릭 이벤트:
- minecraft:custom (신규): 클릭 시 minecraft:custom_click_action 패킷을 서버로 전송합니다 (id, payload (선택적 문자열 또는 NBT 태그) 필드). 모드 서버에서 사용자 지정 명령 없이 상호작용 가능하며, 바닐라 서버에서는 기능이 없습니다.
- show_dialog (신규): 클릭 시 대화 상자를 엽니다 (dialog 필드 - ID 또는 인라인 값).
- run_command: 실행 전 구문 분석이 불가하거나 높은 권한이 필요할 시 확인 메시지를 표시합니다.

대화 구성요소

클릭 이벤트

책이나 채팅의 run_command 클릭 액션 실행 전, 명령을 구문 분석할 수 없거나 높은 권한(기본값 0 이상)이 필요한 경우 사용자에게 확인 메시지를 표시합니다.

새로운 클릭 액션 minecraft:custom이 추가되었습니다.
- 사용자가 이 클릭 액션이 있는 구성 요소를 클릭하면, 클라이언트는 서버로 전용 패킷 minecraft:custom_click_action을 전송합니다.
- 이것은 모드 서버에서 사용자 지정 명령을 추가하는 것에 대한 걱정 없이 run_command의 대안으로 사용하도록 의도되었습니다.
- 이 패킷은 바닐라 서버에서는 아무런 기능도 하지 않습니다.
- 필드:
  - id: 네임스페이스 ID입니다.
  - payload: 선택적 문자열 필드입니다

대화 상자 클릭 이벤트

새로운 대화 상자 클릭 이벤트 액션 show_dialog가 추가되었습니다.
사용자가 이 구성 요소를 클릭하면, 사용자에게 새로운 대화 상자가 열립니다.
필드:
- dialog: minecraft:dialog 레지스트리의 네임스페이스 ID 또는 대화상자 JSON입니다.

태그 추가/변경

블록:
- #happy_ghast_avoids: 행복한 가스트가 피하는 블록입니다.
- #triggers_ambient_desert_sand_block_sounds: 해당 블록들은 주변 사막 모래 소리를 유발합니다.
- #triggers_ambient_dried_ghast_block_sounds: 말린 가스트 블록을 놓았을 때 주변에 있을 경우 말린 가스트 소리를 유발합니다.
- #plays_ambient_desert_block_sounds → #triggers_ambient_desert_dry_vegetation_block_sounds (이름이 변경되었습니다).
아이템:
- #happy_ghast_food: 행복한 가스트에게 먹일 수 있는 아이템입니다.
- #happy_ghast_tempt_items: 행복한 가스트를 유인하는 아이템입니다.
- #harnesses: 모든 종류의 하네스입니다.
- #horse_food에 당근이 추가되었습니다.
엔티티:
- #can_equip_harness: 하네스를 장착 가능한 엔티티입니다.
- #followable_friendly_mobs: 가스트링이 따라갈 성체 엔티티입니다.
- #dismounts_underwater, #fall_damage_immune에 happy_ghast가 추가되었습니다.대화 상자 태그
대화 상자 (dialog)
- #pause_screen_additions: 이 태그에 있는 대화 상자는 ESC 화면의 버그 제보하기, 서버 주소 버튼을 대체합니다.
- #quick_actions: 빠른 동작(G키) 시 열리는 대화 상자입니다.

리소스팩(Resource Packs) – 버전 63

팩 형식 버전은 63입니다.
UI, 모델 및 텍스처:
- 블록 모델 회전(elements[].rotation.angle)이 더 이상 22.5도 배수로 제한되지 않고 -45도에서 +45도 사이의 모든 각도를 가질 수 있습니다.
- 새로운 장비 에셋 레이어 유형 happy_ghast_body (행복한 가스트 몸체 슬롯 렌더링)가 추가되었습니다.
- 아이템 모델 정의에 oversized_in_gui (boolean, 기본값 false) 필드가 추가되었습니다. true이면 GUI에서 아이템 슬롯보다 크게 렌더링을 허용합니다
- 새로운 아이템 모델 minecraft:player_head가 도입되었습니다 (minecraft:profile 구성요소 사용, 플레이어 프로필 텍스처 로딩/렌더링). minecraft:head 모델은 더 이상 minecraft:profile을 지원하지 않습니다.
- hud/locator_bar_arrow_up 및 hud/locator_bar_arrow_down 스프라이트가 이제 해당 .mcmeta 파일의 표준 애니메이션 정의로 애니메이션됩니다.
- 파노라마 텍스처는 이제 모두 동일한 크기여야 하며 정사각형이어야 합니다.
- mob_effects.png-atlas가 gui.png-atlas에 병합되어 더 이상 존재하지 않습니다 (상태 효과 스프라이트가 GUI 스프라이트 크기 조절 속성을 지원합니다).
- icon/music_notes 및 toast/now_playing 스프라이트가 추가되었습니다.
- 구름 텍스처(clouds.png)는 더 이상 색칠할 수 없습니다. 구름 패턴이 업데이트되었으며, 수평선까지 존재합니다.
- .png.mcmeta 파일의 blur 텍스처 매개변수를 일관되게 반영합니다.
글꼴(Fonts):
- uniform 글꼴이 Unifont 16.0.03으로 업데이트되었습니다.
- PUA(Private Use Areas)용 Unifont 글리프가 추가되었습니다 (minecraft:include/unifont_pua 하위 글꼴).
- Unihex 글꼴 공급자: size_overrides 필드가 선택 사항으로 변경되었습니다 (기본값: 빈 목록).
기타:
- 모든 JSON 파일(월드, 팩, 구성 등)은 이제 엄격 모드로 구문 분석됩니다.

소리 관련 변경

새로운 소리 이벤트가 추가되었습니다: entity.leashknot.break (끈 끊어질 때), 가위질 소리 (mob.horse.armor_unequip 등).
일부 몹(발광 오징어, 오징어, 가디언, 말, 토끼, 복어)의 소리 파일 위치가 변경되었습니다 (entity 폴더 → mob 폴더).
소리 이벤트 이름이 변경되었습니다: block.sand.wind → block.dry_grass.ambient 등.
주변 사막 블록 소리 규칙이 조정되었습니다.

쉐이더(Shaders)

모든 내장 유니폼은 이제 불투명한 개별 유니폼 대신 유니폼 블록(uniform blocks)입니다.
후처리 셰이더에 제공되는 사용자 지정 유니폼은 이제 유니폼 블록입니다.
JSON 파일 내 유니폼 정의는 이제 블록당 정의됩니다.
별과 하늘 상단 부분을 각각 렌더링하는 데 사용되는 두 개의 새로운 핵심 셰이더 stars와 sky가 추가되었습니다.

셰이더 안개(Fog)

안개는 이제 환경 기반 안개와 렌더링 거리 기반 안개로 분리됩니다.
- 이전에는 두 개념이 동일한 유니폼에 혼합되어 있었습니다.
- 환경 안개는 플레이어가 있는 환경(용암, 물, 그리고 이제 대기)의 "안개 자욱함"을 나타냅니다.
- 렌더링 거리 안개는 보이는 지형의 경계를 가리는 역할을 합니다.
환경 안개는 구형 거리를 사용하여 강도를 결정하고, 렌더링 거리 안개는 원통형 거리를 사용합니다.
주어진 정점에 대한 최종 안개 값은 두 가지 중 최대값입니다.

후처리 효과 정의 변경

targets 맵 항목이 새로운 속성을 지원하도록 확장되었습니다.
- 새로운 선택적 boolean 필드: persistent
  - 기본값: false
  - true이면 이 렌더 대상은 프레임 간에 유지됩니다.
  - 화면 크기가 조정되면 대상의 내용이 지워집니다.
- 새로운 선택적 필드: clear_color
  - 기본값: [0, 0, 0, 0]
  - 형식: 정수 ARGB 값 또는 [R, G, B, A] 순서의 float 배열
  - 이 대상이 생성되거나 지워질 때 이 색상으로 채워집니다.
uniforms 값은 이제 전역 목록 대신 블록당 목록입니다.
- 예시: uniforms: { "UniformBlockName": [ { "type": "vec2", "value": [...] } ] }
- 블록 내 유니폼 순서는 셰이더의 순서와 일치해야 합니다.
유니폼 정의의 일부인 name은 더 이상 사용되지 않습니다.
유니폼 정의의 일부인 value는 이전 values를 대체하며, 타입은 type 필드에 따라 결정됩니다.
- 이 필드는 필수입니다.
- "type": "int"는 "value": 123 (단일 int)이 필요합니다.
- "type": "float"는 "value": 123.4 (단일 float)가 필요합니다.
- "type": "vec2"는 "value": [1.2, 3.4] (두 개의 float)가 필요합니다.
- "type": "vec3"는 "value": [1.2, 3.4, 5.6] (세 개의 float)가 필요합니다.
- "type": "ivec3"는 "value": [1, 2, 3] (세 개의 int)가 필요합니다.
- "type": "vec4"는 "value": [1.2, 3.4, 5.6, 7.8] (네 개의 float)가 필요합니다.
- "type": "matrix4x4"는 "value": [1.0, 2.0, ..., 16.0] (4x4 float 행렬)이 필요합니다.

후처리 효과 셰이더 변경

모든 유니폼이 개별적인 불투명 타입인 대신, 이제 유니폼 블록으로 그룹화됩니다.
- JSON 파일의 패스 정의에 따라 설정되며, 정점 및 프래그먼트 셰이더 모두에서 공유될 수 있습니다.
크기 목록(모든 vec2 *Size 유니폼)은 이제 단일 SamplerInfo 유니폼 블록으로 대체됩니다.
- 여기에는 출력 텍스처의 크기와 모든 입력 텍스처의 크기가 순서대로 포함됩니다.
- 정의 파일의 텍스처 순서가 이 유니폼의 샘플러 순서를 결정합니다.
- 대부분의 후처리 체인에서는 이전과 같이 OutSize과 InSize입니다.
- 모든 크기는 vec2입니다.
post/bits.fsh: float Resolution과 float MosaicSize의 BitsConfig를 예상합니다.
post/blit.fsh: vec4 ColorModulate의 BlitConfig를 예상합니다.
post/blur.vsh 및 post/box_blur.fsh: vec2 BlurDir과 float Radius의 BlurConfig를 예상합니다.
post/color_convolve.fsh: vec3 RedMatrix, vec3 GreenMatrix, vec3 BlueMatrix의 ColorConfig를 예상합니다.
post/invert.fsh: float InverseAmount의 InvertConfig를 예상합니다.
post/rotscale.vsh: vec2 InScale, vec2 InOffset, float InRotation의 RotScaleConfig를 예상합니다.
post/spiderclip.fsh: vec4 Scissor와 vec4 Vignette의 SpiderConfig를 예상합니다.

주요 유니폼 블록

Globals 유니폼 블록:
- #moj_import <minecraft:globals.glsl>을 통해 사용 가능합니다.
- 대부분의 셰이더는 일반적으로 사용하지 않더라도 이 유니폼 블록을 받을 수 있습니다.
- ScreenSize, GlintAlpha, GameTime, MenuBlurRadius를 포함합니다.
- MenuBlurRadius는 메뉴가 열렸을 때 배경의 흐림 반경입니다.
Fog 유니폼 블록:
- #moj_import <minecraft:fog.glsl>을 통해 사용 가능합니다.
- 대부분의 셰이더는 일반적으로 사용하지 않더라도 이 유니폼 블록을 받을 수 있습니다.
- FogColor, FogRenderDistanceStart, FogRenderDistanceEnd, FogEnvironmentalStart, FogEnvironmentalEnd, FogSkyEnd, FogCloudsEnd를 포함합니다.
  - FogRenderDistanceStart는 렌더링 거리 안개 시작을 나타냅니다.
  - FogRenderDistanceEnd는 렌더링 거리 안개 끝을 나타냅니다.
  - FogEnvironmentalStart는 환경 기반 안개의 시작을 나타내는 새로운 필드입니다.
  - FogEnvironmentalEnd는 환경 기반 안개의 끝을 나타내는 새로운 필드입니다.
  - FogSkyEnd는 하늘을 그릴 때 안개가 끝나야 하는 지점을 나타내는 새로운 필드입니다.
  - FogCloudsEnd는 구름을 그릴 때 안개가 끝나야 하는 지점을 나타내는 새로운 필드입니다.
- FOG_IS_SKY는 하늘 셰이더 분할을 위해 제거되었습니다.
- FogShape가 제거되었습니다. 렌더링 거리 안개는 이제 원통형이고 환경 안개는 구형입니다.
Projection 유니폼 블록:
- #moj_import <minecraft:projection.glsl>을 통해 사용 가능합니다.
- 대부분의 셰이더는 일반적으로 사용하지 않더라도 이 유니폼 블록을 받을 수 있습니다.
- 변경 사항 없이 ProjMat를 포함합니다.
DynamicTransforms 유니폼 블록:
- #moj_import <minecraft:dynamictransforms.glsl>을 통해 사용 가능합니다.
- 일반적으로 사용하지 않는 셰이더에는 더 이상 사용할 수 없습니다.
- ModelViewMat, ColorModulator, ModelOffset, TextureMat, LineWidth를 포함합니다.
Lighting 유니폼 블록:
- #moj_import <minecraft:light.glsl>을 통해 사용 가능합니다.
- 대부분의 셰이더는 일반적으로 사용하지 않더라도 이 유니폼 블록을 받을 수 있습니다.
  - 그러나 셰이더가 일반적으로 예상하지 않는 경우 값은 의미가 없을 수 있습니다.
- Light0_Direction과 Light1_Direction을 포함합니다.
CloudInfo 유니폼 블록:
- 구름 셰이더(rendertype_clouds.vsh/rendertype_clouds.fsh)에서만 사용 가능합니다.
- CloudColor, CloudOffset, CellSize (신규)를 포함합니다.
- CellSize는 개별 구름 셀의 크기를 포함합니다.
LightmapInfo 유니폼 블록:
- 라이트맵 셰이더(lightmap.fsh)에서만 사용 가능합니다.
- 동작 변경 없이 AmbientLightFactor, SkyFactor, BlockFactor, UseBrightLightmap, NightVisionFactor, DarknessScale, DarkenWorldFactor, BrightnessFactor, SkyLightColor를 포함합니다.

쉐이더는 저의 지식 부족으로 틀린 정보가 포함될 수 있습니다.

(본 글은 프리릴리스 및 정식 출시 정보를 종합한 것이며, 일부 내용은 요약되거나 생략되었을 수 있습니다. 최신 정보는 공식 자료를 참고하시기 바랍니다.)

마인크래프트 디스플레이 엔진 튜토리얼

Potan — Tue, 6 May 2025 18:12:18 +0900

마인크래프트 디스플레이 엔진 (이하 MDE)는 BDEngine의 모델 파일을 가지고 마인크래프트내에서 사용 가능한 mcfunction으로 만들어주는 프로그램입니다.

BDEngine의 애니메이터를 안쓰는 이유

z와alt키로 피벗을 바꿀시 애니메이션이 망가지는 문제 발생
:애니메이션 제작 조작감을 낮춥니다

툴 안에서 10틱까지밖에 지원하지 않습니다
:정교한 애니메이션을 만들떄 불편합니다 / 그래프 기능으로 어느정도 상쇄가능

그룹 생성 제거 불가
:애니메이션을 제작할때 불편함이 증가합니다

커맨드 구조 문제1
:애니메이션을 재생할떄 커맨드 비용이 무겁습니다

커맨드 구조 문제2
:한 모델을 여러개 소환해서 각자 다른 타이밍에 애니메이션을 재생하는것이 불가능하고 언제나 같은 움직임을 공유합니다

과도한 .mcfunction생성
:키프레임만큼 .mcfunction을 생성하는게 아니라 애니메이션이 없더라고 0.1초씩 체크하기 위해 과도한 .mcfunction을 생성합니다
이것은 맵에 쓸대없는 용량을 증가시킬 뿐만 아니라 맵을 공유할때 다운로드 속도를 느리게 만듭니다

스케줄 사용
:불안정

By Pangch

설치하고 메인메뉴 들어가기

https://github.com/Potan7/Potan-Minecraft-Display-Engine/releases

Releases · Potan7/Potan-Minecraft-Display-Engine

Minecraft Animation Generator. Contribute to Potan7/Potan-Minecraft-Display-Engine development by creating an account on GitHub.

github.com

링크의 가장 최신 버전에서 파일을 다운 받습니다.

압축을 푼 뒤 나오는 실행파일로 실행시키면 됩니다.

실행하면 나오는 메인메뉴입니다.

여기에서 애니메이션 제작 창으로 이동하거나 태그 부여기를 실행시킬 수 있습니다.

다만 여기서 이렇게 제작 창으로 들어가지 못하고 Version not found 메세지가 출력되는 경우가 있습니다. 이 경우는 마인크래프트의 jar 파일을 불러오지 못한 것입니다.

따라서 오른쪽 아래 변경하기 버튼을 누른 뒤 파일 선택하기 버튼을 눌러 마인크래프트의 jar 파일을 불러오면 됩니다.

마인크래프트 jar 파일의 위치를 찾는 방법은

https://potangaming.tistory.com/319

마인크래프트 기본, Curseforge, Prism 런처의 version jar파일 기본 경로

윈도우를 기준으로 작성되었습니다.0. Roaming 폴더 들어가기시작버튼과 R키를 동시에 누르거나 시작 메뉴에 실행 검색실행창에 %appdata% 검색그러면 자동으로 C:\Users\(계정이름)\AppData\Roaming 경로가

potangaming.tistory.com

이 게시글을 확인해주세요

이후 입력 완료를 누르면 올바른 파일일 경우 첫번째 화면처럼 돌아오며 올바르지 않은 파일일 경우 경로가 지워집니다.

한번 올바른 파일을 입력시키면 경로가 저장되어 자동으로 계속 불러올 것입니다.

태그 부여하기

마크에서 애니메이션을 적용시키기 위해선 각 파츠마다 tag를 적용시켜야 합니다. 따라서 태그 부여기를 통해 디스플레이 모델의 모든 파츠에 태그를 부여해야 합니다.

우선 애니메이션에 사용할 모델을 준비합니다. 여기선 제 스킨을 가져와봤습니다.

태그 부여기를 눌렀을 때 뜨는 창입니다. 파일 불러오기 버튼을 눌러 제가 만든 bdengine 파일을 불러옵니다.

Add Tag : 모든 모델에 tag를 추가합니다. 설정된 이름을 바탕으로 모든 모델에 0이 붙은 태그가 들어가고 각 모델에 1, 2, 3 ... 으로 태그가 부여됩니다.

Add UUID : 모든 모델에 Tag와 UUID를 설정합니다. 모든 디스플레이에 0이 붙은 태그가 들어가고 각 모델에 UUID가 설정됩니다.

UUID는 마인크래프트에서 엔티티의 고유한 ID로 애니메이션에서 tag를 사용하는 것보다 성능이 좋지만 월드 내에 모델이 하나만 존재할 수 있습니다.

기존 태그 지우기는 만약 기존 모델의 NBT에 Tags가 존재한다면 지워버리고 넣을지, 유지하고 태그를 같이 추가할지 설정합니다.

저장하기를 누르면 기존이름_edited로 파일이 새롭게 생성되며

태그가 추가된 것을 확인할 수 있습니다.

실제로 마크로 소환시켜봐도 태그가 잘 부여되어 있습니다.

애니메이션 만들기

애니메이션 창입니다.

화면의 이동 방법은 BDE와 동일합니다.

설정화면입니다. Import & Play는 런처 내에서 자동으로 저장하며 Export 설정은 세이브 파일 내부에 저장되어 불러올 때 설정됩니니다.

마우스를 이름에 올리면 설명이 나오니 이를 보고 확인하면 됩니다.

자 그러면 애니메이션을 만들어봅시다.

밑의 Add New Object를 눌러 새로운 트랙을 생성합니다.

여기엔 방금전 생성한 bdengine 파일을 넣어주면 됩니다.

이로써 트랙이 생성되었습니다. 첫번째 프레임은 항상 0틱에 고정되어 있으며 보간을 설정해도 위의 창에서는 무시됩니다.

이제 애니메이션 프레임을 만들어서 저장해줍니다.

트랙에서 원하는 tick 위치에 마우스를 올리고 우클릭하면 프레임 추가 버튼이 나타납니다. 버튼을 눌러 방금 만든 프레임 2개를 반복해서 넣어주겠습니다.

MDE의 애니메이션 방식은 마인크래프트와 동일한 방식을 사용하기에 사용 방식이 조금 다릅니다.

프레임은 왼클릭으로 선택해 tick을 옮기거나 우클릭으로 세부 설정을할 수 있습니다.

이때 프레임 오른쪽 파란 막대가 보간 길이입니다.

기존의 애니메이션이 A, B 프레임이 있을 때 A, B 사이에서는 A -> B로 점점 애니메이션이 진행되었다면

MDE에서는 A -> A 파랑막대 끝 에서 A의 애니메이션이 진행됩니다.

즉 A 프레임에 도달한 이후부터 파랑막대 길이만큼 애니메이션을 진행합니다.

무슨 소린지 모르시겠다면 직접 해보시면 됩니다.

시간이 적힌 창을 마우스 왼클릭해 시간을 세세하게 조절해볼 수 있습니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

또한 원한다면 창을 위로 드래그해 새로운 트랙을 추가할 수 있습니다.

저장, 불러오기, 내보내기

왼쪽 위 Files에 마우스를 올리면 저장, 불러오기를 할 수 있습니다.

저장을 할 경우 mcdeanim 확장자로 저장되며

모든 애니메이션, export 설정, 내보내기 경로 등이 저장됩니다.

이후에 불러오기 버튼을 통해 위의 내용을 다시 불러올 수 있습니다.

참고로 불러오기의 경우 기존에 띄워놓은 트랙들을 리셋시키지 않고 새로 추가하니 이 점 주의하시기 바랍니다.

작성날 기준 리셋에 버그가 있으므로 새로 하실 때에는 재부팅을 추천드립니다.

내보내기 기능입니다.

설정 버튼은 기존의 설정 창을 띄우는 버튼입니다.

위의 경로를 누르면 경로를 선택할 수 있습니다.

설정에서 적어놓은 결과물 폴더 이름에 맞춰 자동으로 폴더를 생성해 그 안에 mcfunction들을 넣어줍니다.

이때 기존에 존재하던 mcfunction 파일들을 다 지우니 주의하셔야 합니다.

내보내기 후에는 이렇게 mcfunction 파일들이 나오게 됩니다.

frame 파일에 애니메이션에 대한 정보가 들어있습니다.

따라서 해당하는 스코어보드를 1씩 증가시켜주면서 frame.mcfunction을 호출해주면 애니메이션이 자동으로 진행됩니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

이렇게 애니메이션을 생성해보았습니다.

Potan의 게임블로그

마인크래프트 JE 26.1 기술적 업데이트 정리

마인크래프트 자바에디션 26.1 "Tiny Takeover" - 기술적 업데이트 정리

1. 코어 시스템 및 엔진 업데이트

1.1 Java 런타임 및 메모리

1.2 공식 난독화 해제

1.3 시스템 상태 알림

1.4 입력기(IME) 후보창 인게임 렌더링

2. 월드 저장 구조 및 NBT 개편

2.1 파일 및 폴더 경로 변경 상세

2.2 level.dat NBT 구조 개편 및 데이터 분리

3. 데이터 팩 개편 (Data Packs - v101.1)

3.1 주민 거래 시스템 (Data-Driven Villager Trades)

3.2 시간 시스템 (World Clock & Timeline)

3.3 환경 속성 시스템 (Environment Attributes)

3.4 데이터 기반 동물 변종 (Mob Sound Variants)

3.5 데이터 기반 특수 조합법 (Data-Driven Special Recipes)

3.6 추가 데이터 팩 변경 사항

4. 리소스 팩 및 시각 효과 (Resource Packs - v84)

4.1 조명 엔진 개편에 따른 셰이더(Shader) 변경

4.2 아기 몹 (Baby Mobs) 모델 오버홀

4.3 아이템 모델 변환 (Transformation) 지원

5. 데이터 구성 요소 변경 (Data Components)

6. 명령어 및 게임플레이 로직 (Commands & Gameplay)

6.1 명령어 업데이트

6.2 게임플레이/아이템 변경점

7. 신규 태그 (Tags) 목록

7.1 블록 및 아이템 태그

7.2 엔티티 및 파티클 태그

Map Maker's Utils 마인크래프트 Fabric 모드

마인크래프트 JE 1.21.11 기술적 업데이트 정리

마인크래프트 자바에디션 1.21.11 - 기술적 업데이트 정리

환경 속성 (Environment Attributes)

환경 속성 소스

환경 속성 맵 (Environment Attribute Map)

수정자 (Modifiers)

공통 데이터 유형

수정자 종류

보간 (Interpolation)

새로운 환경 속성 전체 목록

시각 (Visual)

오디오 (Audio)

게임플레이 (Gameplay)

명령어 변경 사항

게임 규칙 (Game Rules)

아이템 구성요소 (Item Components)

신규 구성요소

변경된 구성요소

전리품 및 슬롯

타임라인 (Timelines)

속성 트랙 (Attribute Tracks)

속성 트랙 형식

이징 유형 (Easing Types)

공통 데이터 유형

수정자 (Modifiers)

리소스 팩 (Resource Packs)

블록 모델 (Block models)

블록 상태 정의 (Blockstates definition)

아이템 모델 (Item models)

셰이더 및 후처리 효과 (Shaders & Post-process Effects)

스프라이트 애니메이션 (Sprite Animations)

텍스처 아틀라스 (Texture atlases)

텍스처 (Textures)

UI

사운드 (Sounds)

데이터 팩 (Data Packs)

태그 (Tags)

마법 부여 (Enchantment)

술어 (Predicates)

기타 주요 변경 사항

피해 유형 (Damage Types)

차원 유형

엔티티 데이터

몹 변종

그 외

마인크래프트 JE 1.21.9 기술적 업데이트 정리

마인크래프트 자바에디션 1.21.9 – 기술적 업데이트 정리

일반

파티클

명령어 (Commands)

2.2 `level.dat` NBT 구조 개편 및 데이터 분리

1. `minecraft:notice`

2. `minecraft:confirmation`

3. `minecraft:multi_action`

4. `minecraft:server_links`

5. `minecraft:dialog_list`

1. `minecraft:plain_message`

2. `minecraft:item`

1. `minecraft:text`

2. `minecraft:boolean`

3. `minecraft:single_option`

4. `minecraft:number_range`