Logo
BubbleVillagers
PluginMIT

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

126
Downloads
0
Followers
2 months ago
Updated
📦
4
Versions
managementoptimizationutilitybukkitfoliapaperpurpurspigot
Download Latestv2.0.3View on Modrinth

📖About 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

  • 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.

stat1