Upgrades#
Upgrades 通过让玩家购买岛屿升级——扩展保护范围、更高的方块/实体限制、自定义命令、刷怪笼增益和农作物生长增益——为玩家提供进度曲线,可使用金钱、物品、权限或岛屿等级进行购买。
由 tastybento 创建和维护。
Warning
Upgrades 目前处于 Beta 测试阶段。
请记住,您可能会遇到更多的错误 且 某些功能可能不够稳定。
1.0.0 版本是完全重写
Upgrades 1.0.0 用完全数据库驱动的架构取代了旧的基于配置文件的系统。升级定义、层级、价格和奖励现在存储在 BentoBox 的数据库中,完全通过游戏内界面管理。旧的 config.yml 不再使用 — 如果从 0.x 版本升级,请在安装 1.0.0 之前删除它。
安装#
- 将 Upgrades 插件 jar 文件放入 BentoBox 插件的 addons 文件夹。
- 重启服务器。
- 首次运行时,系统会自动创建 8 个示例升级,让你快速开始。
- 使用
/[admin_command] upgrades在游戏内自定义或创建升级。
工作原理#
升级、层级、价格和奖励存储在 BentoBox 的数据库(YAML、JSON、MySQL、MongoDB 等)中。无需编辑大型配置文件。所有升级数据由插件自动加载、缓存和保存。
首次安装时,播种器会创建 8 个示例升级。一旦删除示例升级,下次重启时不会重新播种。要重新触发播种,从插件数据文件夹中删除 .seeded-gamemodes 标记文件。
层级与等级#
每个升级由一个或多个层级组成。每个层级覆盖一定的等级范围——例如,一个层级可能覆盖等级 0 到 4,意味着升级等级在该范围内的玩家将受到该层级奖励的影响。
- 玩家每次购买升级,其等级增加 1。
- 始终应用包含玩家当前等级的层级的奖励。进入新层级的范围后立即切换到该层级的奖励。
- 一个层级可以要求多种价格(必须全部支付)并授予多种奖励(全部应用)。
- 价格和奖励公式可以使用变量(参见公式变量)根据等级、岛屿等级或队伍人数自动调整。
命令#
Tip
[player_command] 和 [admin_command] 是根据你运行的游戏模式而不同的命令。
/[player_command] upgrade: 打开升级购买面板。
/[admin_command] upgrades: 打开管理员 GUI,用于创建、编辑和删除升级及其层级。
价格类型#
每个升级层级可以要求以下任意组合的价格(必须全部满足才能购买):
| 类型 | 描述 |
|---|---|
| 金钱 | Vault 经济费用 |
| 物品 | 玩家物品栏中必须有特定物品 |
| 权限 | 玩家必须拥有特定权限节点 |
| 岛屿等级 | 最低岛屿等级(需要 Level 插件) |
奖励类型#
每个升级层级可以授予以下任意组合的奖励:
| 类型 | 描述 | 应用时机 |
|---|---|---|
| 范围 | 增加岛屿保护范围 | 购买时 |
| 方块限制 | 提高方块类型的每岛限制(需要 Limits 插件) | 购买时 |
| 实体限制 | 提高实体类型的限制(需要 Limits 插件) | 购买时 |
| 实体组限制 | 提高实体组的限制(需要 Limits 插件) | 购买时 |
| 命令 | 购买时运行控制台或玩家命令 | 购买时 |
| 刷怪笼增益 | 为岛屿上每次刷怪笼事件增加额外生成 | 被动持续生效 |
| 农作物生长增益 | 为岛屿上每次自然农作物生长事件增加额外生长刻 | 被动持续生效 |
命令#
命令奖励在玩家购买升级时运行一条或多条命令。
- 控制台模式:命令以服务器控制台身份运行(适用于
/give、晋升命令或需要较高权限的命令)。 - 玩家模式:命令以购买升级的玩家身份运行(受其权限限制)。
命令字符串中可以使用以下占位符:
[player]— 购买升级的玩家名称[owner]— 岛屿主人的名称
刷怪笼增益#
刷怪笼增益是一种被动持续效果。购买时不会触发任何效果;它会立即生效,并在岛屿持有该升级等级期间保持活跃。
每次岛屿上的刷怪笼触发时,插件会汇总该岛屿在所有激活升级层级中的刷怪笼增益值,并在相同位置生成相应数量的同类型生物。
公式值是一个额外倍数:
| 公式值 | 每次刷怪笼事件的效果 |
|---|---|
0.5 | 50% 概率额外生成 1 只生物 |
1.0 | 固定额外生成 1 只生物 |
1.5 | 固定额外生成 1 只 + 50% 概率再生成 1 只 |
2.0 | 固定额外生成 2 只生物 |
来自多个包含刷怪笼增益奖励的升级的加成会叠加。该增益适用于所有类型的刷怪笼。
农作物生长增益#
农作物生长增益同样是一种被动持续效果。当农作物自然生长时,插件会施加相当于增益值的额外骨粉生长刻——玩家升级等级越高,农作物生长越快。
公式值的工作方式与刷怪笼增益相同:
| 公式值 | 每次自然生长事件的效果 |
|---|---|
0.5 | 50% 概率额外施加 1 个生长刻 |
1.0 | 固定额外施加 1 个生长刻 |
2.0 | 固定额外施加 2 个生长刻 |
来自多个升级的加成会叠加。支持的农作物:小麦、胡萝卜、马铃薯、甜菜根、地狱疣、甜浆果丛、火把花、投手作物。
公式变量#
价格和奖励中的公式字段均支持以下变量:
[level]— 正在购买(或激活)的当前升级等级[islandLevel]— 岛屿当前等级(来自 Level 插件;如果未安装 Level 插件则可能为 0)[numberPlayer]— 岛屿团队中的玩家数量
这些变量可以让你编写自动调整的公式,例如金钱费用 500 * [level] 或刷怪笼增益 0.1 * [level]。
权限#
插件根据升级配置自动授予权限。查看 addon.yml 了解当前权限列表。
API#
UpgradeAPI 类公开给其他插件,用于以编程方式查询和修改升级数据。
更新日志#
v1.0.0 新内容 — 完全重写,需要操作
发布于: 2026-04-12
- 数据库驱动的升级系统。 所有升级、层级、价格和奖励现在存储在 BentoBox 数据库中——无需编辑配置文件。
- 新管理员 GUI。
/[admin_command] upgrades打开完整的游戏内管理界面,通过 GUI 和聊天输入创建和编辑升级。 - 新奖励类型: 刷怪笼增益(乘以刷怪笼速率)和农作物生长增益(乘以农作物生长速度)。
- 模板化玩家面板。 玩家升级面板现在是 BentoBox
TemplatedPanel— 可通过panels/upgrades_panel.yml完全自定义。 - 完整的
UpgradeAPI用于从其他插件进行编程访问。 - 首次安装时自动播种 8 个示例升级。
- 与 Limits 插件 1.28 的兼容性修复。
🔺 与 0.x 版本不向后兼容。 安装前删除旧的 config.yml 和任何现有升级数据。没有自动迁移。
v1.0.1 新内容
发布于: 2026-04-12
- 播种器修复。 示例升级在被删除后不再每次重启都重新生成。播种器现在在持久性
.seeded-gamemodes标记文件中跟踪已播种的游戏模式。
v1.0.2 新内容
发布于: 2026-04-13
- 持久化修复。 管理员升级定义(名称、图标、价格、奖励、层级设置)和玩家购买等级仅存储在内存中,服务器重启后丢失。现在所有修改操作完成后立即保存到数据库。
翻译#
帮助我们保持翻译准确
现在 BentoBox 及其插件的大多数翻译已借助 AI 完成——大部分工作已经做好, 但 AI 并不完美。我们真正需要社区提供的是错误报告和纠正。
- 发现错误或措辞不当?请在 bentobox.world 的相关仓库(我们 GitHub 组织的短链接)上提交 issue 或 PR,或者在 Discord 上告知我们。
- 想要添加全新语言?请在相关仓库的
src/main/resources/locales/目录下 提交包含新语言文件的 PR,或在 Discord 上联系我们,我们会为你提供帮助。
| 语言 | 语言代码 | 进度 |
|---|---|---|
| 英语(美国) | en-US | 100%(默认) |
| 中文(中国) | zh-CN | 13% |
| 日语 | ja | 11% |
| 法语 | fr | 11% |
| 波兰语 | pl | 13% |