Item Merge
Reduces entity lag from scattered dropped items by merging nearby item stacks into fewer entities — keeps your ground clutter-free and your tick rate happy.
Features
- Merges nearby dropped item stacks (same item + same metadata) within a short radius
- Wall-safe: items never merge through solid blocks — a raycast check confirms a clear path first
- Instant pickup: merged stacks get their pickup delay reset so players scoop them up right away
- Respects each item's real max stack size (64, 16, 1, etc. — no overstacking)
- Works across Bukkit, Spigot, Paper, and Purpur from 1.8 all the way up through Folia, auto-detected at runtime
- On Folia, merging runs through the per-region entity scheduler so it's fully thread-safe across regions
How it works
Every few ticks, the plugin scans for live dropped-item entities and checks their neighbors within range. If two item stacks have a clear line of sight to each other (no solid blocks in between) and are the same item type, they're combined into one stack (topping off at the item's max stack size) and the leftover entity is removed.
Compatibility
- Bukkit / Spigot / Paper / folia / Purpur (1.8 → latest): uses the standard Bukkit scheduler
- Folia: uses GlobalRegionScheduler + per-entity EntityScheduler for safe cross-region item access
