設定与 GUI 介面集成 (MC 26.1.2)

本文件详细介绍 Minecraft 26.1.2 下 Item Clumps 的設定文件結構、Cloth Config v2 介面集成、ModMenu 入口点及世界优先级規則。

---

📊 設定資訊框

属性	数值
設定文件路径	config/item-clumps.json
文件格式	JSON（具备原子替换安全的 Gson 序列化）
当前結構版本	configVersion: 1
图形設定介面支援	Cloth Config v2 通过 ModMenu
优先级準則	設定文件定义新建世界默认值；现有世界以 GameRules 为准

---

📄 JSON 文件格式規範 (config/item-clumps.json)

{
  "configVersion": 1,
  "enableClumping": true,
  "maxClumpSize": 9999,
  "renderLabels": true,
  "mergeRadius": 1
}

字段定义說明

JSON 键	类型	默认值	描述說明
configVersion	整數	1	内部結構版本迁移追蹤标识。
enableClumping	布尔值	true	开启或关闭掉落物巨型堆疊聚合功能。
maxClumpSize	整數	9999	单个聚合實體的物品数量硬上限 ($64\text{ 至 }2,147,483,647$)。
renderLabels	布尔值	true	在聚合体上方渲染原版浮空自定义名牌数量。
mergeRadius	整數	1	水平方块搜索聚合半径 ($1\text{ 至 }10\text{ 格}$)。

---

🖥️ 图形設定介面 (Cloth Config & ModMenu)

Item Clumps 通过 Cloth Config v2 和 ModMenu 提供了可选的客户端設定屏幕：

// 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;
    }
}

---

🔗 相关文件 (MC 26.1.2)

• 26.1.2 遊戲規則表
• 26.1.2 架構設計與 Mixin