📦 Item Clumps (Server Only): The "Instant Gratification" Update

No Backports: I will NOT backport this mod to older Minecraft versions (1.21, 1.20, etc.). Please do not ask.

In vanilla Minecraft, dropped items merge, but they strictly cap at a maximum stack size of 64. If a high-efficiency mob farm, automated quarry, or massive TNT explosion drops thousands of items, the game is forced to tick and render hundreds of individual ground entities. This leads to heavy client-side frame drops, rendering lag, and severe server TPS decay.

Item Clumps (Server Only) changes this foundation by breaking the 64-item stack limit for ground entities entirely server-side. It aggressively condenses identical items into single, lightweight virtual mega-stacks of up to 9,999 items by default. Vanilla clients can connect to servers running this mod without having to install it!

---

🎥 Showcase Video

Click the player above to watch the mod showcase in action!

---

✨ Features

🚀 Server-Side Stack Size Virtualization

Bypasses the 64-item ground stack cap. Identical items merge into single entities containing up to 9,999 items by default (configurable up the full 32-bit integer limit of 2,147,483,647 both in the GameRules screen and via commands).

[!NOTE]
MegaCount Strategy: In this server-side only version, the true virtual count is stored directly in the standard vanilla ItemStack count. Because Minecraft 26.x serializes stack counts using standard VarInts/integers rather than bytes, vanilla clients natively support, sync, and display these larger counts on item entities.

🏷️ Vanilla-Compatible Count Tags

Renders a custom name tag (e.g., Oak Log x450) above clumps when the count exceeds a normal stack. Uses vanilla's native custom name tags (setCustomName / setCustomNameVisible) on the server so that vanilla clients display the count tag without needing any client-side mod.

⏱️ Vanilla Despawn Timer Rules

To match vanilla merging logic, when two stacks merge, the resulting clump inherits the age of the youngest item in the merge (taking the smaller age value, as age ticks upwards). This extends/resets the despawn window for the combined clump exactly like vanilla, ensuring you don't lose items prematurely.

📦 Smart Inventory Integration

Walking over a clump smoothly transfers items to your inventory in max stack chunks. The mod dynamically calculates the exact amount of free space in your inventory and takes only what fits, keeping the remainder safely in the ground clump instead of deleting or de-syncing them.

⚙️ Hopper Drip-Feeding

Hoppers extract items from virtual clumps one by one at standard vanilla transfer speeds. This ensures your redstone automation, sorting systems, and item-elevator pipelines function exactly as they did in vanilla, keeping the game balanced.

📐 Vanilla Physics Alignment

To match vanilla merging rules and prevent glitches, clumping operates on a configurable horizontal block radius, but respects vertical space. Items will not merge if they are separated vertically by 1 block or more (e.g., items resting on top of a block won't merge with items below it).

---

⚙️ Config

[!IMPORTANT]
Config vs. In-Game GameRules:
The global configuration file only defines default values for new worlds at creation time.
If you have already created/opened a world, changing the config file will have no effect. You must change the settings in-game using the Edit Game Rules UI screen or the /gamerule command.
The mod works out of the box with zero setup. All parameters are managed in-game using the Native Minecraft Game Rules system.

• In-Game: Use /gamerule item_clumps: for core settings.
  • item_clumps:enable_clumping (Default: true) - Toggles the clumping mechanic. When disabled, items behave exactly like vanilla.
  • item_clumps:max_clump_size (Default: 9999) - The maximum quantity of items a single clumped entity can contain. (Disabled automatically if Stack Size Adjuster is loaded).
  • item_clumps:render_labels (Default: true) - Toggles the rendering of the floating custom count tag above virtual clumps.
  • item_clumps:merge_radius (Default: 1) - The horizontal block radius items will search to find matching items to merge.
  • item_clumps:label_min_count (Default: -1) - Minimum item count before the clump label displays. Set to -1 to use the default vanilla stack limit.

[!IMPORTANT]
Recommended Mod: Since this mod adds several GameRules, we highly recommend using Collapsible Game Rules to keep your settings menu clean and organized.

---

📦 Installation & Environment

🖥️ Environment Support

• Server-side only: All functionality is done server-side and is compatible with vanilla clients.
  • Works in singleplayer too

📥 Install Instructions

1. Install Fabric API.
2. Download item-clumps-*.jar and place it in your mods folder.

---

🧩 Compatibility

Feature	Fabric (26.2+)
Singleplayer	✅
Multiplayer (LAN/Server)	✅
Empty Dimensions	✅

🎮 Version Compatibility & Support

• Minecraft 26.2+: Current public release — Active & Supported.
• Minecraft 26.1.2: Discontinued

---

☕ Support

If you enjoy the Instant Gratification collection, consider fueling the next update!

---

📜 Credits

Role	Author
Creator	Rifaditya (Dasik)
Collection	Instant Gratification
License	GNU GPLv3

[!IMPORTANT]
Modpack Permission Policy:
You are free to include this mod in any modpack. However, cross-platform redistribution of this project or its files is strictly prohibited. Modpacks hosting this project's files must be published on the same platform (Modrinth).

---