Custom Item Merge
Every Minecraft server admin knows the pain: hundreds of dropped items scattered across the ground after a mob farm runs, a mining expedition wraps up, or a player empties a full inventory. Each one of those floating entities ticks away at your CPU, and on a busy server, that adds up fast. Custom Item Merge is a lightweight add-on that tackles this exact problem by giving you full control over how and when item entities combine, cutting down entity count and keeping your tick rate healthy.
What Custom Item Merge Does
Vanilla Minecraft already merges nearby item stacks, but the default radius is fixed and often too small to make a real dent in entity counts. This mod lets you modify the item entity merge distance to reduce CPU usage, so clusters of drops collapse into single stacks far more aggressively. The result is fewer entities to track, less collision checking, and smoother performance during heavy farming or redstone activity.
The add-on sets a merging radius of 5 blocks as its default, which is already a meaningful improvement over vanilla behavior. From there, the sky is basically the limit: you can push the radius out to whatever distance suits your world, or dial it back if you prefer a more conservative approach.
Key Features at a Glance
- Fully customizable through config files, no coding required
- Change the merge radius to any distance you want
- Allow merging horizontally by setting mergeZ, so items on the same plane combine even when they are not stacked vertically
- Hot reload support via the /reload item-merge command with OP permission
- Experiment with configs without relaunching the game or server
Horizontal Merging Explained
The mergeZ option is the feature that surprises most players. In vanilla, merging tends to favor vertical proximity, which means items spread across a flat floor may never combine. By enabling mergeZ, you allow horizontal merging, so a wide carpet of drops collapses into neat stacks. On skyblock islands or flat tech bases, this single setting can transform your entity counts.
Hot Reloading for Fast Tuning
Nobody wants to restart a live server just to test a config tweak. With OP permission, you can run /reload item-merge and apply your new values on the spot. That makes it easy to find the sweet spot between aggressive merging and preserving item behavior your players expect. If you are the type who likes to tinker, this workflow is genuinely satisfying.
Supported Versions and Loaders
Custom Item Merge supports Minecraft 1.17 and above, covering the modern era of the game including the 1.18 caves and cliffs terrain, the 1.19 wild update, and later releases. It is built as a Fabric mod, so you will need the Fabric loader installed alongside a matching version of the Fabric API. Performance-focused packs and vanilla-plus servers are the natural home for it, though it plays nicely in larger modpacks too as long as you watch for overlapping optimization mods.
If you manage mods across several worlds or profiles, the foxygame.net launcher streamlines the whole process: it keeps Custom Item Merge and your other add-ons updated automatically, so version compatibility headaches after a game patch become a thing of the past.
How to Install Custom Item Merge
Getting set up takes only a few minutes. Here is the standard routine:
- Install the Fabric loader for your target Minecraft version
- Place the Fabric API jar in your mods folder
- Download Custom Item Merge and drop the jar into the same mods folder
- Launch the game once to generate the config file
- Open the config, set your merge radius and mergeZ preference, then save
- Run /reload item-merge in-game as an operator to apply changes instantly
When you download Custom Item Merge for Minecraft, double-check that the mod version matches your game version, since mismatches are the most common cause of startup crashes. After that, the add-on is essentially maintenance-free.
Choosing the Right Merge Radius
There is no universal perfect number. A radius of 5 works well for survival servers with moderate farm activity. Large public servers running massive mob grinders often push it higher, sometimes into double digits, to keep entity counts manageable during peak hours. Smaller private worlds may barely notice a difference beyond 6 or 7, so start modest and scale up while watching your tick times.
Final Thoughts
Custom Item Merge is one of those quiet quality-of-life mods that you install once and forget about, until you check your server's performance graphs and realize how much smoother everything runs. It is small, configurable, and respects your time with hot reloading. Whether you run a sprawling multiplayer world or just want your singleplayer farms to behave, tuning your item merge distance is a simple change with an outsized payoff.
===ARTICLE===