API 및 애드온 연동 (MC 26.1.2)
이 문서는 Minecraft 26.1.2 버전의 Item Clumps에 대한 타사 모드 연동 훅, DasikLibrary API 상호작용 및 프로그래밍 방식 뭉침 조회에 대해 다룹니다.
📊 연동 정보 상자
| 속성 | 값 |
|---|---|
| API 아키텍처 | 순수 바닐라 ItemEntity 및 ItemStack API |
| 데이터 저장 방식 | ItemStack.getCount() 직접 사용 (VarInt / 32비트 정수) |
| 게임 규칙 API | DynamicGameRuleManager (DasikLibrary API) |
🔌 애드온 개발자를 위한 프로그래밍 방식 뭉침 조회
Item Clumps는 가상 메가 스택 수량을 표준 Minecraft ItemStack 내부에 직접 보관하므로, 애드온 개발자는 복잡한 커스텀 API 없이도 수량을 읽고 수정할 수 있습니다:
1. 뭉친 아이템 수량 확인
java
// Standard ItemEntity instance
ItemEntity entity = ...;
// Native vanilla getter returns true mega-count (e.g. 5000)
int trueCount = entity.getItem().getCount();2. 뭉침 가능 여부 확인
java
// Queries Item Clumps customIsMergable logic
boolean canMerge = entity.isMergable();3. 뭉친 수량 안전하게 변경
java
// When mutating item entity counts, always update the stack object:
ItemStack stack = entity.getItem().copy();
stack.setCount(newCount);
entity.setItem(stack); // Triggers custom name tag update automatically!