설정 및 GUI 연동 (MC 26.1.2)
이 문서는 Minecraft 26.1.2 버전의 Item Clumps에 대한 설정 파일 스키마, Cloth Config v2 GUI 연동, ModMenu 진입점 및 월드 우선순위 규칙에 대해 다룹니다.
📊 설정 정보 상자
| 속성 | 값 |
|---|---|
| 설정 파일 경로 | config/item-clumps.json |
| 파일 형식 | JSON (원자적 교체 안전성이 보장된 Gson 직렬화) |
| 현재 스키마 버전 | configVersion: 1 |
| 그래픽 인터페이스 제공자 | Cloth Config v2 (ModMenu 지원) |
| 우선순위 규칙 | 설정 파일은 새 월드 기본값, 실행 중 월드는 GameRules 적용 |
📄 JSON 파일 스키마 (config/item-clumps.json)
json
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1
}필드 정의
| JSON 키 | 데이터 타입 | 기본값 | 설명 |
|---|---|---|---|
configVersion | Integer | 1 | 내부 스키마 마이그레이션 추적자. |
enableClumping | Boolean | true | 메가 스택 아이템 뭉침 기능 활성화 여부. |
maxClumpSize | Integer | 9999 | 뭉치 엔티티당 아이템 최대 한도 ($64$ ~ $2,147,483,647$). |
renderLabels | Boolean | true | 뭉치 위에 부유 이름표 수량 라벨 표시. |
mergeRadius | Integer | 1 | 수평 블록 탐색 반경 ($1$ ~ $10$ 블록). |
🖥️ 그래픽 인터페이스 (Cloth Config & ModMenu)
Item Clumps는 Cloth Config v2 및 ModMenu를 통한 선택적 클라이언트 설정 화면을 지원합니다:
java
// ModMenuIntegration.java (MC 26.1.2)
public class ModMenuIntegration implements ModMenuApi {
@Override
public ConfigScreenFactory<?> getModConfigScreenFactory() {
if (net.fabricmc.loader.api.FabricLoader.getInstance().isModLoaded("cloth-config")) {
return ClothConfigScreenHelper.createFactory();
}
return parent -> null;
}
}