BubbleVillagers

Supports Folia

Minecraft Version

Java Version

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

- Radius Commands: Remove AI from villagers to reduce server load while maintaining trading functionality - Radius Commands: Villagers can still restock trades and level up even when optimized - Radius Commands: Prevent spam optimization with customizable cooldowns - Radius Commands: Optimize or unoptimize multiple villagers at once in a specified radius

🎮 Multiple Optimization Methods

1. Command-Based: Use nametags on villagers to optimize them 2. Command-Based: Right-click villagers with specific blocks (configurable) 3. Command-Based: Interact with villager workstations for optimization 4. Command-Based: Use commands to optimize villagers in bulk

🌍 Cross-Version Support

- Paper Optimized: Full compatibility across modern Minecraft versions - Paper Optimized: Fully compatible with Folia's regionized multithreading - Paper Optimized: Built specifically for Paper and its forks

📊 Additional Features

- Permission System: English, German, Italian, Korean, Russian, Chinese - Permission System: Modern text formatting with MiniMessage support - Permission System: Optional anonymous usage statistics - Permission System: Configurable automatic trade restocking - Permission System: Granular permission control for all features

📋 Requirements

- Java Version: 1.16.5 or higher (optimized for 1.21.x) - Java Version: 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:

```yaml

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

- Maintainer: Maintainer - 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.