BubbleVillagers

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

1. Nametag Optimization: Use nametags on villagers to optimize them
2. Block Interaction: Right-click villagers with specific blocks (configurable)
3. Workstation Method: Interact with villager workstations for optimization
4. 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

1. Download the latest version from Spigot or Modrinth
2. Place the BubbleVillagers-X.X.X.jar file in your server's plugins folder
3. Restart your server or use a plugin manager to load it
4. Configure the plugin in plugins/BubbleVillagers/config.yml
5. Reload with /bubblevillagers reload or 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.admin
• villageroptimizer.optimize
• villageroptimizer.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:

1. Stop your server
2. Remove the old VillagerOptimizer JAR
3. Add BubbleVillagers JAR
4. 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.