📋 Overview

Upgrades is a BentoBox addon that provides a comprehensive upgrade system for islands. Players can purchase enhancements to expand their island's capabilities, including island size expansion, entity and block limits, and custom command execution.

Key Features

🏝️ Island Range Expansion - Upgrade island protection radius
📦 Block Limit Upgrades - Increase block placement limits per type
👥 Entity Limits - Expand entity spawning and placement limits
🎯 Entity Group Limits - Manage specific entity group restrictions
⚡ Command Upgrades - Execute custom commands on upgrade purchase
💰 Economy Integration - Full Vault support for monetary costs
🎮 Multi-GameMode Support - Works with BSkyBlock, AcidIsland, CaveBlock, SkyGrid, AOneBlock, and more
⚙️ Highly Configurable - Customize tiers, costs, and requirements per game mode
🌐 Multilingual - Built-in support for multiple languages

📦 Requirements

Minecraft: 1.21+
Java: 21+
BentoBox: 3.0.0 or higher
Paper/Spigot: Latest stable version recommended

Optional Dependencies

For full functionality, install these addons:

Addon	Purpose
Vault	Monetary costs for upgrades
Level	Island level requirements
Limits	Block and entity limit upgrades

Note: Without these dependencies, certain features will be disabled but the addon will still function.

🚀 Installation

Quick Start

Download
Place the JAR file in your plugins/BentoBox/addons/ directory
Restart your server
Configure the addon by editing plugins/BentoBox/addons/Upgrades/config.yml
Restart your server again to apply changes

⚙️ Configuration

The addon is configured through config.yml located in plugins/BentoBox/addons/Upgrades/.

Main Configuration Sections

Disabled GameModes

disabled-gamemodes:
  - BSkyBlock  # Disable upgrades for specific game modes

Upgrade Tiers

Define upgrade progression with different tiers:

Range Upgrade Tiers - Controls island protection radius expansion
Block Limits Upgrade Tiers - Controls per-block-type placement limits
Entity Limits Upgrade Tiers - Controls entity spawning limits
Entity Group Limits Upgrade Tiers - Controls grouped entity limits
Command Upgrade Tiers - Execute commands on purchase

GameMode-Specific Configuration

gamemodes:
  BSkyBlock:
    range:
      tier-1:
        cost: 1000
        value: 50

Customization

Entity Icons - Customize appearance of entity upgrade options
Entity Group Icons - Customize grouped entity upgrade display
Command Icons - Customize command upgrade presentation

💡 Usage

For Players

Use the /upgrade command to open the upgrades panel
Browse available upgrades for your island
Click on an upgrade to purchase it (if you have sufficient funds/level)
Upgrades apply immediately after purchase

For Administrators

Configure upgrade tiers in config.yml
Set appropriate costs and requirements
Customize icons and descriptions in locale files
Reload the addon with /reload if needed

🌍 Localization

Upgrade supports multiple languages through locale files in plugins/BentoBox/addons/Upgrades/locales/

🐛 Bug Reports & Feature Requests

Found an issue? Have an idea for an improvement? We'd love to hear from you!

👥 Contributing

Contributions are welcome! Whether it's bug fixes, features, or documentation improvements:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for the full text.

🙏 Credits

Guillaume-Lebegue - Original author
tastybento - Core BentoBox maintainer and contributor
BentoBox Community - For support and feedback

📞 Support

Need help? We're here for you!

💬 Discord: Join the BentoBox Discord
📧 Issues: GitHub Issues
📖 Documentation: Check the wiki for detailed guides