VillagerLobotimizer
If you run a Minecraft server, you know the pain: a bustling trading hall packed with dozens of villagers, each one pathfinding, gossiping, and scanning for workstations every tick. That constant AI churn can tank your TPS and turn a thriving economy into a laggy nightmare. VillagerLobotimizer is the Paper plugin that solves this problem with surgical precision, automatically disabling villager AI when they are confined to trading cells, then re-enabling it only when needed. The result? A massive performance boost without breaking any vanilla mechanics.
Why Villager AI Cripples Server Performance
Minecraft villagers are notorious resource hogs. Even when trapped in a 1x1 space, they constantly attempt to pathfind, gossip with invisible neighbors, and scan for job site blocks. On a server with dozens of trading halls, this idle AI can consume a significant chunk of the tick budget. The VillagerLobotimizer plugin for Paper servers intelligently detects when a villager is confined—such as inside a standard trading cell—and disables its AI entirely. The villager remains fully functional for trading, but stops all background processing. When the villager is freed, its AI instantly returns. This dynamic approach means you get the performance of a villager-free server without sacrificing your carefully curated trades.
Key Features of VillagerLobotimizer
- Automatic AI Disabling: Detects trapped villagers and lobotomizes them to reduce server load.
- Configurable Restock Sounds: Play custom sounds when villagers restock, including profession-specific celebrations.
- Smart Job Site Detection: Optimized checks prevent unnecessary scanning for workstations.
- Night-Time Refresh: Optionally restore AI at night so villagers can sleep, then re-lobotomize at dawn.
- Name-Based Control: Name a villager "nobrain" to force lobotomization, or "alwaysbrain" to keep it active.
- Debug Mode: Visualize lobotomized villagers and troubleshoot with detailed commands.
- Persistent State: Lobotomized status survives chunk unloads and server restarts.
How to Download VillagerLobotimizer and Install It
Getting started is straightforward. First, ensure your server runs Paper or a compatible fork (the plugin is built for the Paper API). VillagerLobotimizer supports modern Minecraft versions, including 1.21.6 and later. To download VillagerLobotimizer, grab the latest .jar file from the official plugin page. Place it in your server's /plugins folder and restart. No dependencies are required. Once loaded, the plugin immediately begins monitoring villagers with its default settings, which are tuned for typical survival servers. For those using a launcher like foxygame.net, you can often find VillagerLobotimizer in the integrated add-on catalog, allowing one-click installation and automatic updates without manually managing files.
How to Install and Configure the Plugin
After placing the .jar in your plugins directory, restart your server. A config.yml file will be generated. Here's how to tailor it to your needs:
- Check Interval: Adjust how often the plugin scans villagers (in ticks). Lower values increase accuracy but use slightly more resources.
- Restock Interval: Set the time (in milliseconds) between automatic trade restocks. Add randomization to prevent all villagers restocking simultaneously.
- Profession-Specific Sounds: Customize the
restock-soundandlevel-up-soundusing Paper's sound keys, likeentity.villager.celebrate. - Ignore Settings: Choose to lobotomize only villagers with professions, those that have been traded with, or those in vehicles.
- Debug Teams: Enable colored glowing effects to visually identify lobotomized villagers.
After editing, run /lobotomy reload to apply changes without restarting the server.
Commands and Permissions
VillagerLobotimizer includes a simple command set for server operators:
/lobotomy info– Shows statistics on lobotomized and active villagers./lobotomy debug– Displays detailed AI state for the villager you're looking at./lobotomy debug <entity>– Checks a specific villager by UUID or selector./lobotomy debug toggle– Enables or disables debug mode globally./lobotomy wake– Manually restores AI to the targeted villager./lobotomy reload– Reloads the configuration file.
All commands require OP status or the villagerlobotimizer.admin permission node.
Advanced Configuration: Fine-Tuning Performance
The plugin's true power lies in its configurable options. For example, you can set only-lobotomize-villagers-with-experience: true to ensure only villagers that have been traded with are lobotomized, preserving the vanilla feel for new additions. The persist-lobotomized-state option (enabled by default) prevents lag spikes when chunks load by remembering which villagers were already lobotomized. If you run a large server with hundreds of trading halls, consider enabling disable-chunk-villager-updates to stop block changes from waking up villagers unnecessarily. The plugin also includes Sentry error tracking (configurable) to help developers squash bugs quickly.
Why VillagerLobotimizer Stands Out
Unlike generic entity-lag plugins that simply reduce mob caps or tick rates, VillagerLobotimizer targets the specific cause of villager-induced lag: idle AI in confined spaces. It preserves all trading functionality, including restocking, while slashing CPU usage. The automatic detection system means you don't need to manually tag villagers or set up complex regions. Simply build your trading hall as usual, and the plugin handles the rest. For server owners who want to maintain a vanilla player experience without the performance hit, this is an essential tool.
Final Thoughts
VillagerLobotimizer is a must-have for any Paper server that relies on villager trading halls. It delivers immediate TPS improvements with zero player-facing changes, and its extensive configuration lets you dial in exactly the behavior you want. Whether you're running a small community server or a large network, this plugin will keep your villagers working without dragging down performance. Download VillagerLobotimizer today and give your server the brainpower it needs—by taking some away from your villagers.