\n
\n<\/p>\n
**BubbleVillagers** (formerly VillagerOptimizer) is a powerful performance optimization plugin that helps combat heavy villager lag by allowing players and administrators to optimize their trading halls and villager setups.<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\ude80 Performance Optimization
\n– **AI Toggle System**: Remove AI from villagers to reduce server load while maintaining trading functionality
\n– **Smart Optimization**: Villagers can still restock trades and level up even when optimized
\n– **Configurable Cooldowns**: Prevent spam optimization with customizable cooldowns
\n– **Radius Commands**: Optimize or unoptimize multiple villagers at once in a specified radius<\/p>\n
### \ud83c\udfae Multiple Optimization Methods
\n1. **Nametag Optimization**: Use nametags on villagers to optimize them
\n2. **Block Interaction**: Right-click villagers with specific blocks (configurable)
\n3. **Workstation Method**: Interact with villager workstations for optimization
\n4. **Command-Based**: Use commands to optimize villagers in bulk<\/p>\n
### \ud83c\udf0d Cross-Version Support
\n– **Minecraft 1.16 – 1.21.x**: Full compatibility across modern Minecraft versions
\n– **Folia Ready**: Fully compatible with Folia’s regionized multithreading
\n– **Paper Optimized**: Built specifically for Paper and its forks<\/p>\n
### \ud83d\udcca Additional Features
\n– **Multi-Language Support**: English, German, Italian, Korean, Russian, Chinese
\n– **Adventure API**: Modern text formatting with MiniMessage support
\n– **bStats Integration**: Optional anonymous usage statistics
\n– **Trade Restocking**: Configurable automatic trade restocking
\n– **Permission System**: Granular permission control for all features<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft Version**: 1.16.5 or higher (optimized for 1.21.x)
\n– **Server Software**: Paper, Folia, or compatible forks
\n– **Java Version**: Java 17 or higher<\/p>\n
## \ud83d\udd27 Installation<\/p>\n
1. Download the latest version from Spigot or Modrinth
\n2. Place the `BubbleVillagers-X.X.X.jar` file in your server’s `plugins` folder
\n3. Restart your server or use a plugin manager to load it
\n4. Configure the plugin in `plugins\/BubbleVillagers\/config.yml`
\n5. Reload with `\/bubblevillagers reload` or restart the server<\/p>\n
## \ud83d\udcdd Commands<\/p>\n
| Command | Description | Permission | Aliases | ### Command Examples ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | ### Legacy Permissions ## \u2699\ufe0f Configuration<\/p>\n The plugin offers extensive configuration options:<\/p>\n “`yaml # Cooldown Settings # Method Settings # Radius Limits # Language ## \ud83c\udf10 Supported Languages<\/p>\n – \ud83c\uddfa\ud83c\uddf8 English (en_us) ## \ud83d\udd04 Migration from VillagerOptimizer<\/p>\n BubbleVillagers is fully backward compatible with VillagerOptimizer. Simply: All configurations and data will be automatically migrated.<\/p>\n ## \ud83d\udc1b Bug Reports & Feature Requests<\/p>\n Found a bug or have a feature request? Please open an ticket on our Discord Server. This project is licensed under the appropriate license – see the LICENSE file for details.<\/p>\n ## \ud83d\ude4f Credits<\/p>\n – **Original Author**: xGinko ## \ud83d\udc96 Support<\/p>\n If you enjoy this plugin, please consider: —<\/p>\n **Note**: This plugin is designed for performance optimization. Always test on a development server before deploying to production.<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" (formerly VillagerOptimizer) is a powerful performance optimization plugin that helps combat heavy villager lag by allowing players and administrators to optimize their trading halls and villager setups<\/p>\n","protected":false},"featured_media":35341,"template":"","meta":{"_minecraft_slug":"bubblevillagers","_minecraft_project_id":"5L5S9xh2","_minecraft_author":"ethan08921","_minecraft_license":"MIT","_minecraft_downloads":426,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubblevillagers.zip","_minecraft_size_bytes":26779214,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T10:54:47.481178Z","_minecraft_date_created":"2025-12-28T21:56:20.533940Z","_minecraft_date_modified":"2026-05-02T12:47:16.421710Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubblevillagers","_minecraft_icon_attachment_id":35341,"_minecraft_imported_at":"2026-06-01T17:07:03+00:00","_minecraft_import_hash":"1b61d5e153f87a86861ea534d4a73eb0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,122,126,90,127,128,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-35340","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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|———|————-|————|———|
\n| `\/villageroptimizer [reload|version|disable]` | Admin commands | `bubblevillagers.admin` | `\/vo`, `\/bv`, `\/bubblevillagers` |
\n| `\/optimizevillagers
\n| `\/unoptimizevillagers
\n“`
\n\/optimizevillagers 50 # Optimize all villagers within 50 blocks
\n\/unoptimizevillagers 30 # Restore AI to villagers within 30 blocks
\n\/bubblevillagers reload # Reload plugin configuration
\n\/bubblevillagers version # Check plugin version
\n“`<\/p>\n
\n|————|————-|———|
\n| `bubblevillagers.*` | Access to all features | op |
\n| `bubblevillagers.admin` | Admin commands (reload, version, disable) | op |
\n| `bubblevillagers.optimize` | Use optimization commands | op |
\n| `bubblevillagers.unoptimize` | Use unoptimization commands | op |<\/p>\n
\nThe plugin maintains backward compatibility with VillagerOptimizer permissions:
\n– `villageroptimizer.admin`
\n– `villageroptimizer.optimize`
\n– `villageroptimizer.unoptimize`<\/p>\n
\n# Performance Settings
\noptimization:
\n remove-ai: true # Remove AI from optimized villagers
\n allow-restocking: true # Allow trade restocking when optimized
\n restock-interval: 1200 # Ticks between restocks (20 = 1 second)<\/p>\n
\ncooldowns:
\n optimization-cooldown: 300 # Seconds between optimizations
\n command-cooldown: 30 # Seconds between command uses<\/p>\n
\nmethods:
\n nametag-enabled: true # Enable nametag optimization
\n block-enabled: true # Enable block interaction optimization
\n workstation-enabled: true # Enable workstation optimization<\/p>\n
\nlimits:
\n max-radius: 100 # Maximum radius for commands<\/p>\n
\nlanguage: en_us # Available: en_us, de_de, it_it, ko_kr, ru_ru, zh_cn
\n“`<\/p>\n
\n– \ud83c\udde9\ud83c\uddea German (de_de)
\n– \ud83c\uddee\ud83c\uddf9 Italian (it_it)
\n– \ud83c\uddf0\ud83c\uddf7 Korean (ko_kr)
\n– \ud83c\uddf7\ud83c\uddfa Russian (ru_ru)
\n– \ud83c\udde8\ud83c\uddf3 Chinese (zh_cn)<\/p>\n
\n1. Stop your server
\n2. Remove the old VillagerOptimizer JAR
\n3. Add BubbleVillagers JAR
\n4. Start your server<\/p>\n
\n## \ud83d\udcdc License<\/p>\n
\n– **Maintainer**: \u039ethan<\/p>\n
\n– \ud83d\udcdd Leaving a review on Spigot or Modrinth
\n– \ud83d\udcb0 Supporting the developers<\/p>\n