Leaky - Item Lag Fix

Leaky detects broken farms, item leaks and dangerous concentrations of dropped items before they become a server performance problem.

Instead of periodically deleting all dropped items, Leaky tracks larger item clusters and observes how they behave over time. This allows it to distinguish temporary item bursts from continuously leaking or wasteful farms.

For example, breaking a few chests may temporarily create hundreds of dropped items, but no new items arrive afterwards. A broken farm instead keeps feeding new items into the same area, while a wasteful farm may continuously produce items that eventually despawn.

Leaky is server-side only.

Item leak detection

Once enough dropped item entities gather in an area, Leaky starts tracking them as an item cluster.

It monitors:

• current item entity count
• newly arriving items
• despawned items
• player pickups
• cluster lifetime

New clusters initially have a short observation period to avoid treating temporary bursts as leaks.

Clusters can then progress through:

Observing → Suspicious → Leak → Critical

Working farms with a low item concentration can continue operating normally without being classified as leaks.

Reports

When Leaky detects a problem, it reports useful information about the affected cluster, including its size, state, activity and location.

Coordinates in chat are clickable for quickly teleporting to the problem.

Notification recipients can be configured for nearby players, operators, everyone, or disabled completely.

Automatic cleanup

Confirmed leaks can automatically be removed after reaching a configurable size and delay.

A separate much higher emergency threshold can immediately remove extreme item concentrations to help prevent severe server lag or crashes.

Recently deleted clusters are temporarily kept in deletion history and can be restored if necessary.

Leaky can also detect extreme item concentrations in non-ticking areas through Minecraft's entity sections.

Additional features

• Optional dropped-item performance improvements
• Detection and logging of unusually large non-item entity concentrations
• Configurable detection, reporting, waste and cleanup thresholds
• Item highlighting for reported clusters
• Support for detecting wasteful farms where a significant portion of produced items continuously despawns

• /leaky status                         Show currently tracked clusters
• /leaky inspect <id>             Inspect a specific cluster
• /leaky deleteCluster<id>   Manually remove a cluster
• /leaky deletionHistory       View and restore recently deleted clusters

No known incompatibilities, should work with any other mods.

Only required on serverside

If you enjoy this mod consider supporting the development, any support is greatly appreciated.

The development is an unpaid free-time activity, so any support helps being able to spend more time on it.
You can support me on Patreon or just spreading the word around.