/
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.
✨ Features
🚀 Performance Optimization
- AI Toggle System: Remove AI from villagers to reduce server load while maintaining trading functionality
- Smart Optimization: Villagers can still restock trades and level up even when optimized
- Configurable Cooldowns: Prevent spam optimization with customizable cooldowns
- Radius Commands: Optimize or unoptimize multiple villagers at once in a specified radius
🎮 Multiple Optimization Methods
- Nametag Optimization: Use nametags on villagers to optimize them
- Block Interaction: Right-click villagers with specific blocks (configurable)
- Workstation Method: Interact with villager workstations for optimization
- Command-Based: Use commands to optimize villagers in bulk
🌍 Cross-Version Support
- Minecraft 1.16 - 1.21.x: Full compatibility across modern Minecraft versions
- Folia Ready: Fully compatible with Folia's regionized multithreading
- Paper Optimized: Built specifically for Paper and its forks
📊 Additional Features
- Multi-Language Support: English, German, Italian, Korean, Russian, Chinese
- Adventure API: Modern text formatting with MiniMessage support
- bStats Integration: Optional anonymous usage statistics
- Trade Restocking: Configurable automatic trade restocking
- Permission System: Granular permission control for all features
📋 Requirements
- Minecraft Version: 1.16.5 or higher (optimized for 1.21.x)
- Server Software: Paper, Folia, or compatible forks
- Java Version: Java 17 or higher
🔧 Installation
- Download the latest version from Spigot or Modrinth
- Place the
BubbleVillagers-X.X.X.jarfile in your server'spluginsfolder - Restart your server or use a plugin manager to load it
- Configure the plugin in
plugins/BubbleVillagers/config.yml - Reload with
/bubblevillagers reloador restart the server
📝 Commands
| Command | Description | Permission | Aliases |
|---|---|---|---|
/villageroptimizer [reload|version|disable] | Admin commands | bubblevillagers.admin | /vo, /bv, /bubblevillagers |
/optimizevillagers <radius> | Optimize villagers in radius | bubblevillagers.optimize | /optvils, /noai, /bvopt |
/unoptimizevillagers <radius> | Unoptimize villagers in radius | bubblevillagers.unoptimize | /unoptvils, /noaiundo, /bvunopt |
Command Examples
/optimizevillagers 50 # Optimize all villagers within 50 blocks
/unoptimizevillagers 30 # Restore AI to villagers within 30 blocks
/bubblevillagers reload # Reload plugin configuration
/bubblevillagers version # Check plugin version
🔐 Permissions
| Permission | Description | Default |
|---|---|---|
bubblevillagers.* | Access to all features | op |
bubblevillagers.admin | Admin commands (reload, version, disable) | op |
bubblevillagers.optimize | Use optimization commands | op |
bubblevillagers.unoptimize | Use unoptimization commands | op |
Legacy Permissions
The plugin maintains backward compatibility with VillagerOptimizer permissions:
villageroptimizer.adminvillageroptimizer.optimizevillageroptimizer.unoptimize
⚙️ Configuration
The plugin offers extensive configuration options:
# Performance Settings
optimization:
remove-ai: true # Remove AI from optimized villagers
allow-restocking: true # Allow trade restocking when optimized
restock-interval: 1200 # Ticks between restocks (20 = 1 second)
# Cooldown Settings
cooldowns:
optimization-cooldown: 300 # Seconds between optimizations
command-cooldown: 30 # Seconds between command uses
# Method Settings
methods:
nametag-enabled: true # Enable nametag optimization
block-enabled: true # Enable block interaction optimization
workstation-enabled: true # Enable workstation optimization
# Radius Limits
limits:
max-radius: 100 # Maximum radius for commands
# Language
language: en_us # Available: en_us, de_de, it_it, ko_kr, ru_ru, zh_cn
🌐 Supported Languages
- 🇺🇸 English (en_us)
- 🇩🇪 German (de_de)
- 🇮🇹 Italian (it_it)
- 🇰🇷 Korean (ko_kr)
- 🇷🇺 Russian (ru_ru)
- 🇨🇳 Chinese (zh_cn)
🔄 Migration from VillagerOptimizer
BubbleVillagers is fully backward compatible with VillagerOptimizer. Simply:
- Stop your server
- Remove the old VillagerOptimizer JAR
- Add BubbleVillagers JAR
- Start your server
All configurations and data will be automatically migrated.
🐛 Bug Reports & Feature Requests
Found a bug or have a feature request? Please open an ticket on our Discord Server.
📜 License
This project is licensed under the appropriate license - see the LICENSE file for details.
🙏 Credits
- Original Author: xGinko
- Maintainer: Ξthan
💖 Support
If you enjoy this plugin, please consider:
- 📝 Leaving a review on Spigot or Modrinth
- 💰 Supporting the developers
Note: This plugin is designed for performance optimization. Always test on a development server before deploying to production.
!stat1
