Skip to content

Upgrades#

Upgrades 通过让玩家购买岛屿升级——扩展保护范围、更高的方块/实体限制、自定义命令、刷怪笼增益和农作物生长增益——为玩家提供进度曲线,可使用金钱、物品、权限或岛屿等级进行购买。

tastybento 创建和维护。

Warning

Upgrades 目前处于 Beta 测试阶段

请记住,您可能会遇到更多的错误某些功能可能不够稳定

1.0.0 版本是完全重写

Upgrades 1.0.0 用完全数据库驱动的架构取代了旧的基于配置文件的系统。升级定义、层级、价格和奖励现在存储在 BentoBox 的数据库中,完全通过游戏内界面管理。旧的 config.yml 不再使用 — 如果从 0.x 版本升级,请在安装 1.0.0 之前删除它。

安装#

  1. 将 Upgrades 插件 jar 文件放入 BentoBox 插件的 addons 文件夹。
  2. 重启服务器。
  3. 首次运行时,系统会自动创建 8 个示例升级,让你快速开始。
  4. 使用 /[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.0

v1.0.1 新内容

发布于: 2026-04-12

  • 播种器修复。 示例升级在被删除后不再每次重启都重新生成。播种器现在在持久性 .seeded-gamemodes 标记文件中跟踪已播种的游戏模式。

发布 v1.0.1

v1.0.2 新内容

发布于: 2026-04-13

  • 持久化修复。 管理员升级定义(名称、图标、价格、奖励、层级设置)和玩家购买等级仅存储在内存中,服务器重启后丢失。现在所有修改操作完成后立即保存到数据库。

发布 v1.0.2

翻译#

帮助我们保持翻译准确

现在 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%

Last update: April 14, 2026 00:43:43