Item Merger - Summary

Item Merger is a Fabric mod (v1.0.4) for Minecraft 1.20.1 that automatically merges nearby item entities to reduce lag in large automated farms.

Core Functionality

Automatic Merging: Combines item entities of the same type within a 3-block radius into a single entity
Super-Stacking: Items can stack beyond the normal stack limit (up to 6,400 items per entity)
Performance Optimization: Reduces entity count significantly, minimizing tick load, AABB checks, and rendering overhead

Technical Details

Merge Radius: 3.0 blocks
Merge Interval: Every tick (staggered per entity using ID modulo)
Max Merged Count: 6,400 items (100 stacks) per entity
Compatibility: Designed to work with Create mod farms and fan processing

Key Features

Smart Merging Logic: Only merges items with no pickup delay to allow Create fans to detect items first
Conflict Prevention: Uses entity ID comparison to prevent merge conflicts
Item Type Safety: Never merges non-stackable items (tools, armor, etc.)
Jade Integration: Displays merged stack information in tooltips showing:
- Number of full stacks
- Remainder items
- Total item count

Implementation

Mixin-based: Uses a single mixin on ItemEntity.tick() to inject merge logic
Server-side: All merging happens server-side only
Languages: Supports English and Spanish

Use Case

Specifically optimized for large Create mod farms where hundreds of items drop simultaneously, reducing server lag without affecting gameplay mechanics.

item merger