IG：物品团块

📦 物品聚合（仅服务端）：“即刻满足”更新

不向下移植： 我不会将此模组移植到更旧的 Minecraft 版本（1.21、1.20 等）。请勿询问。

在原版 Minecraft 中，掉落物会合并，但严格限制最大堆叠数量为 64 个。如果一个高效率的刷怪塔、自动采石场或大规模 TNT 爆炸掉落成千上万个物品，游戏将被迫处理并渲染数百个独立的地面实体。这会导致严重的客户端帧数下降、渲染卡顿以及服务端 TPS 严重衰退。

物品聚合（仅服务端） 从根本上改变了这一点，通过在服务端完全打破地面实体的 64 个物品堆叠限制。它会将相同的物品激进地压缩成单个轻量级的虚拟巨型堆叠，默认上限为 9,999 个物品。原版客户端可以连接到运行此模组的服务器，而无需安装该模组！

---

🎥 展示视频

点击上方播放器观看模组实际演示！

---

✨ 特性

🚀 服务端堆叠大小虚拟化

绕过 64 个物品的地面堆叠上限。相同的物品会合并成单个实体，默认包含最多 9,999 个物品（可在游戏规则界面和通过命令配置至完整的 32 位整数上限 2,147,483,647）。

[!NOTE] 巨型计数策略：在此仅服务端版本中，真实的虚拟计数直接存储在原版标准的 ItemStack 计数中。由于 Minecraft 26.x 使用标准的 VarInt/整数而非字节来序列化堆叠计数，原版客户端原生支持、同步并显示物品实体上的这些更大的计数。

🏷️ 原版兼容的计数标签

当聚合物的物品数量超过正常堆叠时，会在其上方渲染自定义名称标签（例如 橡木原木 x450）。服务端利用原版的原生自定义名称标签（setCustomName / setCustomNameVisible），让原版客户端无需安装任何客户端模组即可显示计数标签。

⏱️ 原版消失计时器规则

为匹配原版合并逻辑，当两个堆叠合并时，最终的聚合物会继承合并中最年轻物品的年龄（取较小的年龄值，年龄向上累加）。这完全像原版一样延长/重置了合并后聚合物的消失窗口，确保你不会过早丢失物品。

📦 智能物品栏整合

走过聚合物时，会以最大堆叠块的形式将物品顺畅地转移到你的物品栏中。该模组会动态计算你物品栏中的确切可用空间，只拿走能装下的物品，剩余部分安全地留在地面聚合物中，而不是删除或造成不同步。

⚙️ 漏斗滴灌式提取

漏斗以原版标准传输速度从虚拟聚合物中逐个提取物品。这确保你的红石自动化、分类系统和物品电梯管道功能与原版完全一致，保持了游戏平衡。

📐 原版物理对齐

为匹配原版合并规则并防止故障，聚合操作基于可配置的水平方块半径，但尊重垂直空间。如果物品在垂直方向上相隔 1 个方块或更多（例如，放置在方块顶部的物品不会与下方的物品合并），它们将不会合并。

---

⚙️ 配置

[!IMPORTANT] 配置文件 vs. 游戏内游戏规则： 全局配置文件仅在创建时定义新世界的默认值。 如果你已经创建/打开了一个世界，更改配置文件将不会生效。你必须使用编辑游戏规则 UI 界面或 /gamerule 命令在游戏内更改设置。

该模组开箱即用，无需任何设置。所有参数都可以通过原生 Minecraft 游戏规则系统在游戏内管理。

• 游戏内：使用 /gamerule item_clumps: 进行核心设置。
  • item_clumps:enable_clumping（默认：true）- 切换聚合机制。禁用时，物品行为与原版完全一致。
  • item_clumps:max_clump_size（默认：9999）- 单个聚合实体可包含的最大物品数量。（如果加载了堆叠大小调整器，则会自动禁用）。
  • item_clumps:render_labels（默认：true）- 切换在虚拟聚合物上方渲染浮动自定义计数标签。
  • item_clumps:merge_radius（默认：1）- 物品寻找相同物品进行合并的水平方块半径。
  • item_clumps:label_min_count（默认：-1）- 显示聚合物标签的最小物品数量。设置为 -1 则使用默认的原版堆叠上限。

[!IMPORTANT] 推荐模组：由于此模组添加了几个游戏规则，我们强烈推荐使用 可折叠游戏规则 来保持你的设置菜单整洁有序。

---

📦 安装与环境

🖥️ 环境支持

• 仅服务端：所有功能都在服务端完成，且与原版客户端兼容。
  • 在单人游戏中同样有效

📥 安装说明

1. 安装 Fabric API。
2. 下载 item-clumps-*.jar 并将其放入 mods 文件夹。

---

🧩 兼容性

特性	Fabric (26.2+)
单人游戏	✅
多人游戏（局域网/服务器）	✅
空白维度	✅

🎮 版本兼容性与支持

• Minecraft 26.2+：当前公开版本 — 活跃并受支持。
• Minecraft 26.1.2：已停止支持

---

☕ 支持

如果你喜欢即刻满足系列，不妨考虑资助下一次更新！

---

📜 鸣谢

角色	作者
创作者	Rifaditya (Dasik)
系列	即刻满足
许可证	GNU GPLv3

[!IMPORTANT] 整合包许可政策： 你可以自由地将此模组包含在任何整合包中。但是，严禁跨平台分发本项目或其文件。托管本项目文件的整合包必须发布在同一平台（Modrinth）上。

---