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

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.jar file in your server's plugins folder
Restart your server or use a plugin manager to load it
Configure the plugin in plugins/BubbleVillagers/config.yml
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:

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