Home

Item Clumps Wiki

Welcome to the official technical and gameplay documentation for Item Clumps (Instant Gratification Collection), engineered by Dasik (Rifaditya).

📌 Repository Source Disclaimer: The documentation in this Wiki reflects the current source code state in the repository, which may include recent unreleased commits or developmental features ahead of public release builds on CurseForge and Modrinth.

---

🧭 Multi-Version Switchboard Portal

Item Clumps is engineered across dedicated Minecraft release anchors. Select your targeted Minecraft version below to enter its dedicated, isolated documentation suite:

Minecraft Version	Release Era	Supported Build	Java Level	Loom Toolchain	Wiki Entry
Minecraft 26.2	Modern Sovereign Era	1.0.23+26.2	Java 25	Loom 1.15.2	👉 Enter MC 26.2 Wiki
Minecraft 26.1.2	Modern Sovereign Era	1.0.4+26.1.2	Java 25	Loom 1.15.2	👉 Enter MC 26.1.2 Wiki

---

⚡ Core Philosophy & Architecture

Item Clumps belongs to the Instant Gratification (IG) design track. Its sole mandate is "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)|
+-------------------------------------------------------------------------+

Key Architectural Pillars

1. Aggressive Mega-Stack Aggregation: Hardcoded 64-item ground entity caps are lifted. Thousands of dropped items condense into single entities, eliminating entity ticking and rendering overhead.
2. Server-Side Only Architecture: Operates 100% on the logical server. Completely compatible with un-modded vanilla clients and requires no client-side mod installations.
3. Smart Inventory Distribution: When players walk over clumps, items are safely fed into the player inventory in clean, standard stack sizes (e.g. 64) with zero custom NBT or tag pollution.
4. Automation & Hopper Parity: Hoppers extract items from mega-clumps at vanilla transfer rates ($2.5\text{ items/s}$ / $1\text{ item per } 8\text{ ticks}$), preventing automation bypass.
5. Youngest Despawn Age Safeguard: Clumped entities inherit the age of the youngest item ($\min(\text{age}_A, \text{age}_B)$), preventing premature item loss in active farms.
6. Cross-Mod Compatibility: Fully integrated with the Magnet mod and Stack Size Adjuster.

---

📚 Global Navigation & Resources

• Version Compatibility Matrix
• MC 26.2 Documentation Hub
• MC 26.1.2 Documentation Hub
• CurseForge Platform Page
• Modrinth Platform Page
• GitHub Source Repository