? 概览
Upgrades 是一款 BentoBox 插件,为岛屿提供全面的升级系统。玩家可以购买增强功能以扩展其岛屿的能力,包括岛屿范围扩展、实体与方块上限以及自定义命令执行。
主要特性
- ?️ 岛屿范围扩展 - 升级岛屿保护半径
- ? 方块上限升级 - 增加每种方块的放置上限
- ? 实体上限 - 扩展实体的生成和放置上限
- ? 实体组上限 - 管理特定实体组的限制
- ⚡ 命令升级 - 在购买升级时执行自定义命令
- ? 经济集成 - 完全支持 Vault 货币成本
- ? 多游戏模式支持 - 兼容 BSkyBlock、AcidIsland、CaveBlock、SkyGrid、AOneBlock 等
- ⚙️ 高度可配置 - 针对每个游戏模式自定义等级、成本和需求
- ? 多语言 - 内置多种语言支持
? 依赖要求
- Minecraft: 1.21+
- Java: 21+
- BentoBox: 3.0.0 或更高版本
- Paper/Spigot: 建议使用最新稳定版
可选依赖项
为实现完整功能,请安装以下插件:
注意:缺少这些依赖项时,部分功能将被禁用,但插件仍可正常运行。
? 安装指南
快速开始
- 下载
- 将 JAR 文件放入
plugins/BentoBox/addons/ 目录
- 重启服务器
- 通过编辑
plugins/BentoBox/addons/Upgrades/config.yml 来配置该插件
- 再次重启服务器以应用更改
⚙️ 配置
该插件通过位于 plugins/BentoBox/addons/Upgrades/ 的 config.yml 进行配置。
主配置部分
禁用的游戏模式
disabled-gamemodes:
- BSkyBlock # 禁用特定游戏模式的升级
升级等级
定义具有不同等级的升级进度:
- 范围升级等级 - 控制岛屿保护半径扩展
- 方块上限升级等级 - 控制按方块类型的放置上限
- 实体上限升级等级 - 控制实体生成上限
- 实体组上限升级等级 - 控制分组实体上限
- 命令升级等级 - 在购买时执行命令
游戏模式特定配置
gamemodes:
BSkyBlock:
range:
tier-1:
cost: 1000
value: 50
自定义选项
- 实体图标 - 自定义实体升级选项的外观
- 实体组图标 - 自定义分组实体升级显示
- 命令图标 - 自定义命令升级展示
? 使用方法
玩家使用
- 使用
/upgrade 命令打开升级面板
- 浏览岛屿可用的升级项目
- 点击升级项目进行购买(如果有足够的资金/等级)
- 购买后升级立即生效
管理员使用
- 在
config.yml 中配置升级等级
- 设置合适的成本和需求
- 在本地化文件中自定义图标和描述
- 如有需要,使用
/reload 重新加载插件
? 本地化
Upgrade 支持通过 plugins/BentoBox/addons/Upgrades/locales/ 中的本地化文件实现多语言。
? Bug 报告与功能请求
发现问题?有改进想法?我们非常期待听到您的反馈!
? 贡献指南
欢迎贡献!无论是修复 Bug、添加新功能还是改进文档:
- Fork 仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature)
- 提交更改 (
git commit -m 'Add amazing feature')
- 推送到分支 (
git push origin feature/amazing-feature)
- 发起 Pull Request
? 许可证
版权所有 (c) 2020-2026 Guillaume-Lebegue, tastybento 及 BentoBoxWorld 贡献者
本项目基于 MIT 许可证 授权 - 详见 LICENSE 文件获取全文。
? 致谢
- Guillaume-Lebegue - 原作者
- tastybento - BentoBox 核心维护者及贡献者
- BentoBox 社区 - 提供支持与反馈
? 技术支持
需要帮助?我们随时为您服务!
? 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
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!
评论 0
登录后参与评分
还没有评论,来抢沙发吧