Skip to content

管理工具#

BentoBox 为服务器管理员提供了一系列工具来管理游戏、调查问题并保持一切顺利运行 — 无需手动编辑文件。

管理面板#

主要管理中心是管理面板,通过以下方式打开:

/bentobox manage
(或其别名 /bbox manage

从这里你可以一目了然地查看所有运行的游戏模式、活跃岛屿和基本服务器健康状况。

/bentobox 命令#

所有顶级 BentoBox 管理都通过 /bentobox(别名 /bbox)进行:

命令 作用
/bentobox version 显示 BentoBox 版本和所有已加载的插件。报告 bug 时始终包括此内容。
/bentobox manage 打开管理面板 GUI
/bentobox reload 重新加载 BentoBox 配置文件和地区,无需完全服务器重启
/bentobox catalog 打开插件目录
/bentobox perms 显示 BentoBox 和所有插件的有效权限
/bentobox rank 列出、添加或移除自定义等级

每个游戏模式的管理员命令#

每个游戏模式都有自己的管理员命令。对于 BSkyBlock 是 /bsb,对于 AcidIsland 是 /acid admin 等。这些为你提供特定于该游戏模式的控制:

命令 作用
/[admin] info <player> 显示玩家的岛屿的完整详细信息
/[admin] delete <player> 删除玩家的岛屿
/[admin] setrange <player> <range> 更改玩家的岛屿保护范围
/[admin] settings 打开管理员的世界设置面板
/[admin] settings <player> 打开特定玩家的岛屿设置面板
/[admin] why <player> 开始跟踪为什么玩家可以或不可以做某事(见下文)
/[admin] reload 重新加载游戏模式的配置
/[admin] blueprint 打开蓝图管理器 GUI

确切的管理员命令前缀取决于游戏模式的配置。请查看游戏模式的文档以获取其特定命令。

"Why" 诊断工具#

最有用的管理员工具之一是 why 命令。如果玩家报告他们在岛屿上不能做某事(或他们可以做他们不应该做的事情),运行:

/[admin_command] why <player>

之后,服务器控制台将记录该玩家采取的每个操作的原因 — 是否被允许或被阻止,以及哪个保护标志导致了它。这使得无需猜测即可轻松诊断配置错误的权限。

要停止跟踪,再次运行该命令。

管理员设置面板#

管理员设置面板(使用 /[admin] settings 打开)控制全球范围的默认值 — 适用于游戏模式世界中任何地方的设置,而不仅仅是一个岛屿。这包括:

  • 新岛屿的默认保护标志
  • 全球范围的限制(例如爬行者爆炸伤害、活塞行为)
  • 玩家设置面板的可见性设置(隐藏你不想让玩家改变的标志)

有关标志系统的完整说明,请参阅保护

基于权限的控制#

BentoBox 在很大程度上基于权限。几乎所有内容 — 从玩家可以拥有多少个家园,到他们是否可以飞行,再到他们的岛屿的大小 — 都可以通过通过你的权限插件(例如 LuckPerms)给予或扣除权限来控制。

Tip

在控制台中运行 /bentobox perms 以查看 BentoBox 及其插件注册的所有权限的列表,采用 YAML 格式。这对于配置你的权限插件很有用。

数据库管理#

BentoBox 支持多个数据库后端来存储岛屿和玩家数据:

  • JSON(平面文件) — 默认值;易于设置,无需额外软件
  • MySQL (5.7+)
  • MariaDB (10.2.3+)
  • MongoDB (3.6+)
  • SQLite (3.28+)
  • PostgreSQL

数据库类型在 BentoBox 的 config.yml 中设置。要在不丢失数据的情况下从一个数据库类型迁移到另一个数据库类型,请使用:

/bentobox migrate

Warning

迁移数据库前始终进行完整备份。

不重启即重新加载#

更改配置文件后,你可以在不完全重启服务器的情况下应用它:

/bentobox reload
这将重新加载 BentoBox 和所有插件,包括地区。请注意,某些更改(如世界生成设置)始终需要完全重启才能生效。


Last update: April 2, 2026 19:30:56