<\/p>\n
# VillagerLobotimizer<\/p>\n
A Minecraft Paper plugin that improves server performance by turning off villagers’ AI when they’re confined to trading halls.<\/p>\n
 <\/p>\n
## Features<\/p>\n
– Automatically detects when villagers are trapped in trading halls
\n– Disables AI for trapped villagers to improve server performance
\n– Maintains villager trading functionality while AI is disabled
\n– Automatically refreshes villager trades on a configurable schedule with randomization support
\n– Profession-specific restock sounds and level-up celebrations
\n– Optimized job site detection for better performance
\n– Night-time trade refresh functionality
\n– Allows naming villagers to control their behavior (“nobrain”, “alwaysbrain”)
\n– Debug mode for troubleshooting
\n– Command system for checking villager status and managing the plugin<\/p>\n
## Commands<\/p>\n
– `\/lobotomy info` – Shows statistics about lobotomized and active villagers  **Note: I do not make any money off this link. It’s fully non-monetized.** <\/p>\n ## Configuration<\/p>\n “`yaml #Interval between trapped checks, in ticks, for active villagers #Interval between trapped checks, in ticks, for inactive villagers #Interval between villager trade restocks, in milliseconds #Range (in milliseconds) before restock-interval to start random restock checks. If set to 0, restocking is not randomized. If equal to or greater than restock-interval, restock will always occur. #Whether to only lobotomize villagers with jobs #Whether to lobotomize villagers in boats\/minecarts. Does not apply to villagers riding on non-vehicle entities like horses. #The sound to play when a villager restocks. Leave empty (“”) for default sounds. #The sound played when a villager is leveled up. Leave empty (“”) for no sound. #Debug mode. Prints debug messages to the console. #Chunk debug mode. Prints debug messages related to chunks #To ignore villagers stuck in doors, set this to true. #To not lobotomize villagers surrounded by non-solid blocks, set this to true. #To check if there is a roof above a villager before lobotomizing, set this to true #Create teams for debugging purposes. This will create colored teams for inactive and active villagers. We use this to color their glowing effect. #Disable the update checker. You can disable this if you don’t want to be notified about updates. #Disable chunk forced Villager updating. This’ll disable changes to blocks in a chunk from triggering Villagers in the chunk to be updated. #Prevent trading with unlobotomized villagers. When enabled, players can only trade with villagers that have been lobotomized. ## Special Villager Names<\/p>\n – Name a villager with “nobrain” to force it to always be lobotomized ## Sound System<\/p>\n The plugin features an enhanced sound system: ## Requirements<\/p>\n – Paper (or its forks) 1.21.6+ ## Installation<\/p>\n 1. Download the latest release from Modrinth or Hangar ## Development<\/p>\n ### Prerequisites<\/p>\n – Java Development Kit (JDK) 21 ### Building<\/p>\n 1. Clone the repository 2. Build the plugin ### Running a test server<\/p>\n The project uses the run-paper plugin to easily test changes:<\/p>\n “`bash This will download a Paper server for Minecraft 1.21.5 and start it with the plugin installed.<\/p>\n ### Publishing<\/p>\n The project uses Hangar for publishing:<\/p>\n “`bash This requires the `HANGAR_API_KEY` environment variable to be set. The plugin will be published as: ## Support<\/p>\n If you encounter any issues, please report them on GitHub.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" A plugin to lobotomize villagers stuck in a trading hall. Perfect for SMPs looking to increase performance without sacrificing gameplay!<\/p>\n","protected":false},"featured_media":166505,"template":"","meta":{"_minecraft_slug":"villagerlobotomy","_minecraft_project_id":"pDaq3k6b","_minecraft_author":"mja00","_minecraft_license":"MIT","_minecraft_downloads":4446,"_minecraft_follows":52,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villagerlobotomy.zip","_minecraft_size_bytes":18954564,"_minecraft_version_count":63,"_minecraft_updated_at":"2026-05-16T03:58:01.073517Z","_minecraft_date_created":"2025-03-31T03:57:38.072160Z","_minecraft_date_modified":"2026-05-10T17:36:46.712792Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villagerlobotomy","_minecraft_icon_attachment_id":166505,"_minecraft_imported_at":"2026-06-09T18:25:09+00:00","_minecraft_import_hash":"4635971b83c9665802c1934c328b1c79","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,137,90,127,128,123,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-166504","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/lobotomy debug` – Shows detailed information about the villager you’re looking at
\n– `\/lobotomy debug
\n– `\/lobotomy debug toggle` – Toggles debug mode
\n– `\/lobotomy wake` – Manually restores AI to the villager you’re looking at
\n– `\/lobotomy reload` – Reloads the configuration and applies changes to all villagers<\/p>\n
\n#List of names that will always keep villagers active (case-insensitive)
\nalways-active-names:
\n – “alwaysbrain”<\/p>\n
\ncheck-interval: 150<\/p>\n
\ninactive-check-interval: 150<\/p>\n
\nrestock-interval: 540000<\/p>\n
\nrestock-random-range: 0<\/p>\n
\nonly-lobotomize-villagers-with-professions: false<\/p>\n
\nalways-lobotomize-villagers-in-vehicles: false<\/p>\n
\n#A list of sounds can be found at https:\/\/jd.papermc.io\/paper\/1.21.6\/io\/papermc\/paper\/registry\/keys\/SoundEventKeys.html
\n#Use the name found in the description column, e.g. “entity.villager.celebrate” for the sound played when a villager restocks.
\nrestock-sound: “”<\/p>\n
\nlevel-up-sound: “entity.villager.celebrate”<\/p>\n
\ndebug: false<\/p>\n
\nchunk-debug: false<\/p>\n
\nignore-villagers-stuck-in-doors: false<\/p>\n
\nignore-non-solid-blocks: false<\/p>\n
\ncheck-roof: true<\/p>\n
\ncreate-debug-teams: false<\/p>\n
\ndisable-update-checker: false<\/p>\n
\ndisable-chunk-villager-updates: false<\/p>\n
\nprevent-trading-with-unlobotomized-villagers: false
\n“`<\/p>\n
\n– Name a villager with “alwaysbrain” to prevent it from ever being lobotomized (configurable in `always-active-names`)<\/p>\n
\n– **Default restock sounds**: When `restock-sound` is left empty, villagers will play default sounds when restocking
\n– **Customizable sounds**: You can override the default sounds by specifying a custom sound in the configuration
\n– **Sound reference**: A complete list of available sounds can be found in the Paper API documentation
\n– **Level-up celebrations**: Villagers play celebration sounds when they level up their trades<\/p>\n
\n– Java Development Kit (JDK) 21 for development<\/p>\n
\n2. Place the .jar file in your server’s plugins folder
\n3. Restart your server or use a plugin manager to load the plugin
\n4. Configure the plugin settings in `plugins\/VillagerLobotimizer\/config.yml` if needed<\/p>\n
\n– Gradle (wrapper included)<\/p>\n
\n “`bash
\n git clone https:\/\/github.com\/mja00\/VillagerLobotimizer.git
\n cd VillagerLobotimizer
\n “`<\/p>\n
\n “`bash
\n .\/gradlew build
\n “`
\n The built plugin will be in `build\/libs\/VillagerLobotimizer-
\n.\/gradlew runServer
\n“`<\/p>\n
\n.\/gradlew publishPluginPublicationToHangar
\n“`<\/p>\n
\n– A release version if the current commit is tagged with a version matching the project version
\n– A snapshot version if there’s no matching tag<\/p>\n