Handy Mob Culler

HANDY MOB CULLER

Handy Mob Culler is a Minecraft server plugin designed to boost performance by automatically despawning mobs that pick up specified disallowed items. By enforcing a timed despawn on these mobs, it prevents unwanted persistence that can lead to entity lag and degraded server performance.

Key Features

• Automatically schedules a despawn countdown for mobs holding any configured disallowed items.
• Drops all held equipment before despawning, ensuring that no items are lost.
• Fully configurable “despawn-items” list (e.g., EGG, various SAPLINGS, SEEDS, STRING, ARROW, etc.) and despawn delay.
• Persists scheduled mob data across server reloads for consistent operation.
• Operates entirely server-side with no client modifications required.

Functionality
In vanilla Minecraft, mobs that pick up items can become persistent, contributing to lag—especially in modded environments with high mob spawns. Handy Mob Culler monitors non-player entities and triggers a countdown when a mob picks up any item from the disallowed list. If the mob retains the item beyond the configured delay, it is automatically despawned, and all its equipment is dropped naturally. This proactive approach maintains a balanced entity count and optimizes server performance without affecting gameplay.

Configuration

• Config File Location: plugins/HandyMobCuller/config.yml
• "despawn-items": Define the list of items that, when picked up, trigger a mob’s despawn.
• "despawn-delay": Set the delay (in ticks) before a mob holding a disallowed item is despawned.

Installation
Simply place the HandyMobCuller.jar into your server’s plugins folder and restart or reload the server. This is a server-side plugin, so no client installation is necessary.

Note: Mobs with custom name tags will retain their vanilla behavior and are exempt from forced despawn.