item merger

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

1. Smart Merging Logic: Only merges items with no pickup delay to allow Create fans to detect items first
2. Conflict Prevention: Uses entity ID comparison to prevent merge conflicts
3. Item Type Safety: Never merges non-stackable items (tools, armor, etc.)
4. 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.