Item Clumps Wiki
欢迎查阅由 Dasik (Rifaditya) 精心工程化设计的 Item Clumps（即时满足系列 Instant Gratification Collection）官方技术与玩法维基。
📌 仓库源码声明：本 Wiki 中的文档反映了仓库中的当前源代码状态，可能包含领先于 CurseForge 和 Modrinth 上公开发布版本的最新未发布提交或开发中功能。
🧭 多版本切换总门户
Item Clumps 针对专属的 Minecraft 发行基准版本进行了工程化设计。请在下方选择您的目标 Minecraft 版本以进入其专属、独立的文档套件：
| Minecraft 版本 | 发布纪元 | 支持构建号 | Java 等级 | Loom 工具链 | Wiki 入口 |
|---|---|---|---|---|---|
| Minecraft 26.2 | 现代主权纪元 | 1.0.23+26.2 | Java 25 | Loom 1.15.2 | 👉 进入 MC 26.2 Wiki |
| Minecraft 26.1.2 | 现代主权纪元 | 1.0.4+26.1.2 | Java 25 | Loom 1.15.2 | 👉 进入 MC 26.1.2 Wiki |
⚡ 核心设计理念与架构
Item Clumps 属于即时满足 (Instant Gratification, IG) 设计轨道。其唯一宗旨是 “极致性能，零摩擦力 (Performance First. Friction Zero)”。
+-------------------------------------------------------------------------+
| VANILLA ITEM BEHAVIOR |
| 6,400 Cobblestone dropped = 100 Item Entities = Severe Server/FPS Lag |
+-------------------------------------------------------------------------+
│
▼ (Item Clumps Transformation)
+-------------------------------------------------------------------------+
| ITEM CLUMPS BEHAVIOR |
| 6,400 Cobblestone dropped = 1 Mega-Stack Entity = 0 Entity Lag |
| - Floating Label: "Cobblestone x6400" (Vanilla Name Tag rendering) |
| - Smart Pickup: Feeds into player inventory in standard 64x stacks |
| - Hopper Drip: Transfers 1 item per 8 ticks (Vanilla automation parity)|
+-------------------------------------------------------------------------+核心架构支柱
- 激进的巨型堆叠聚合：解除了原版地面实体硬编码的 64 个堆叠上限。成千上万的掉落物可凝聚为单一实体，彻底消除实体 tick 计算与渲染开销。
- 纯服务端架构：100% 运行在逻辑服务端上。与未安装模组的原版客户端完全兼容，客户端无需安装任何模组。
- 智能背包分发：当玩家走过聚合体时，物品会以标准的规范堆叠大小（如 64 个）安全注入背包，且零自定义 NBT 或标签污染。
- 漏斗与自动化完全对齐：漏斗以原版标准的传输速率（$2.5\text{ 个/秒}$，即每 $8\text{ tick}$ 抽取 $1\text{ 个}$）从巨型聚合体中抽取物品，防止跳过自动化机制。
- 最年轻消失年龄守护：聚合实体继承所有合并物品中最年轻项的年龄（$\min(\text{age}_A, \text{age}_B)$），杜绝活跃农场中掉落物过早消失。
- 跨模组兼容：与 Magnet 磁铁模组及 Stack Size Adjuster 堆叠上限调整模组深度无缝整合。