配置与 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