Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
📋 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
/upgradecommand 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
/reloadif 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
Copyright (c) 2020-2026 Guillaume-Lebegue, tastybento, and BentoBoxWorld Contributors
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


