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 直接将虚拟巨型堆叠数量存储在原版标准的 ItemStack 中，附属开发者无需特殊的 API 外观即可直接读取或操作聚合数量：

1. 读取聚合堆叠真实数量

// Standard ItemEntity instance
ItemEntity entity = ...;

// Native vanilla getter returns true mega-count (e.g. 5000)
int trueCount = entity.getItem().getCount();

2. 检查是否允许聚合

// Queries Item Clumps customIsMergable logic
boolean canMerge = entity.isMergable();

3. 安全修改聚合实体数量

// 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!

---

🔗 相关文档 (MC 26.1.2)

• 26.1.2 架构设计与 Mixin
• 26.1.2 开发者配置与构建