API 및 애드온 연동 (MC 26.2)
이 문서는 Minecraft 26.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().copyWithCount(newCount);
entity.setItem(stack); // Triggers custom name tag update automatically!🧲 자석 및 비행 덕 타이핑 훅
자석 모드, 염력 모드, 진공 모드를 개발 중인 경우, ItemEntity 믹스인에 다음 덕 타이핑 메서드 중 하나를 추가하여 비행 중인 아이템이 조기에 병합되는 것을 방지할 수 있습니다:
java
public boolean ig_magnet$isMagnetized() {
return this.isFlyingTowardsPlayer;
}
// Or legacy alternative:
public boolean ig$isMagnetized() {
return this.isFlyingTowardsPlayer;
}Item Clumps는 병합 틱 발생 시 리플렉션을 통해 이 메서드를 자동으로 호출합니다.