?️ ControlPanel 插件(BentoBox 附加组件)
为你的玩家提供一个酷炫的可点击 GUI 菜单,用于运行他们最常用的岛屿命令——无需打字。ControlPanel 是一个 BentoBox 附加组件,允许服务器管理员使用简单的 YAML 文件构建完全可定制的控制面板。
✨ 功能特性
- ?️ 点击执行 — 左键、右键和 Shift+左键可分别触发不同的命令
- ?️ 多面板支持 — 每个游戏模式可定义任意数量的面板;通过权限系统分配给玩家
- ? 丰富的图标 — 可使用任何原版材质、BentoBox
ItemParser格式或 ItemsAdder 自定义物品 - ? 实时占位符 — 按钮描述支持 PlaceholderAPI、颜色代码以及
[gamemode]替换 - ? 控制台命令 — 在命令前添加
[server]前缀即可以控制台身份执行 - ? 槽位范围 — 使用
"0-8"这样的单一定义即可填充一整行槽位 - ? 13 种本地化语言 — cs, de, en-US, es, fr, id, ko, lv, pl, ru, zh-CN, zh-HK, zh-TW
- ? 兼容模组 — AcidIsland, BSkyBlock, CaveBlock, SkyGrid, AOneBlock 等
? 安装
- 将
ControlPanelJAR 文件放入plugins/BentoBox/addons/目录中。 - 重启服务器 —— ControlPanel 会在
plugins/BentoBox/addons/ControlPanel/下创建一个默认的controlPanelTemplate.yml文件。 - 编辑
controlPanelTemplate.yml以构建你的面板(见下文)。 - 在游戏中运行导入命令以加载你的面板:
提供自定义文件名可从不同文件导入:/bsb cp import/bsb cp import myCustomPanels⚠️ 当已存在面板时进行导入,系统会请求确认并替换现有面板。
? 命令
玩家命令
/is cp
/is controlpanel
打开分配给玩家的专属控制面板。没有特定面板权限的玩家将看到 defaultPanel(默认面板)。
管理员命令
/{admin} cp import [filename]
/{admin} cp import
| 命令 | 描述 |
|---|---|
/{admin} cp import |
从 controlPanelTemplate.yml(默认)导入面板 |
/{admin} cp import myFile |
从附加数据文件夹中的 myFile.yml 导入面板 |
请将
{admin}替换为你游戏模式的管理员命令,例如 BSkyBlock 使用bsb,AOneBlock 使用oa。
? 权限
| 权限 | 默认值 | 描述 |
|---|---|---|
[gamemode].controlpanel |
true |
打开控制面板 |
[gamemode].controlpanel.admin |
op |
使用管理员导入命令 |
[gamemode].controlpanel.panel.default |
true |
访问默认面板 |
[gamemode].controlpanel.panel.<后缀> |
— | 访问名为 <后缀> 的自定义面板 |
将 [gamemode] 替换为小写的游戏模式名称,例如 bskyblock、acidisland、aoneblock。
?️ 配置文件参考
模板文件位于 plugins/BentoBox/addons/ControlPanel/controlPanelTemplate.yml。
顶层结构
panel-list:
<panel-key>:
defaultPanel: true|false
panelName: '<title>'
permission: '<suffix>'
buttons:
<slot>:
name: '<display name>'
material: MATERIAL_NAME
icon: 'namespace:item_id'
itemsadder: 'namespace:item_id'
description: |-
line one
line two
command: '<left-click command>'
right_click_command: '<right-click command>'
shift_click_command: '<shift+left-click command>'
面板字段
| 字段 | 描述 |
|---|---|
defaultPanel |
true = 向没有任何特定面板权限的玩家显示 |
panelName |
库存 GUI 的标题。支持 & 颜色代码。 |
permission |
[gamemode].controlpanel.panel.<suffix> 的后缀。拥有该权限的玩家可以看到此面板。 |
按钮字段
| 字段 | 描述 |
|---|---|
slot |
库存槽位(0–53)。也接受范围如 "0-8" 以填充多个槽位。 |
name |
按钮显示名称。支持 & 颜色代码和命令占位符。 |
material |
Minecraft 原版材质(例如 GRASS_BLOCK)。通过 Material.match 解析。 |
icon |
BentoBox ItemParser 字符串(例如 minecraft:diamond)。优先级高于 material。 |
itemsadder |
ItemsAdder 自定义物品 ID(例如 iasurvival:ruby)。需要安装 ItemsAdder 插件。 |
description |
显示在按钮名称下方的介绍行。支持 & 颜色代码、多行 |、PlaceholderAPI %placeholders% 以及 [gamemode]。 |
command |
左键单击时运行的命令(以及任何没有特定覆盖的点击)。支持占位符。 |
right_click_command |
右键单击或 shift+右键单击时运行的命令。如果省略,则回退到 command。 |
shift_click_command |
shift+左键单击时运行的命令。如果省略,则回退到 command。 |
点击类型汇总
| 点击方式 | 使用的命令 |
|---|---|
| 左键单击 | command |
| 右键单击 | right_click_command → command |
| Shift + 右键单击 | right_click_command → command |
| Shift + 左键单击 | shift_click_command → command |
| 其他任何点击 | command |
命令占位符
| 占位符 | 替换为 |
|---|---|
[label] |
游戏模式的玩家命令标签(例如 island, ob) |
[player] |
点击玩家的用户名 |
[server] |
以服务器控制台身份运行命令,而不是以玩家身份 |
介绍占位符
| 占位符 | 替换为 |
|---|---|
[gamemode] |
小写的游戏模式名称(例如 bskyblock, aoneblock) |
%PlaceholderAPI_placeholder% |
任何已注册的 PlaceholderAPI 占位符 |
? 配置示例
一个用于活跃 BSkyBlock / AOneBlock 服务器的完整、真实世界示例。它展示了两个面板——面向所有玩家的默认面板和面向捐赠者的 VIP 面板,以及所有的按钮功能。
panel-list:
# ── 默认面板 — 向所有玩家显示 ───────────────────────────────────────────
default:
defaultPanel: true
panelName: '&8&l⚙ &r&6&l 岛屿控制面板'
permission: 'default'
buttons:
# 第 0 行:装饰性玻璃窗格边框
"0-8":
name: ' '
material: BLACK_STAINED_GLASS_PANE
description: ''
command: ''
# ── 导航 ────────────────────────────────────────────────────────────────
9:
name: '&a&l ? 前往岛屿'
icon: minecraft:grass_block
description: |-
&7 左键点击:传送至你的岛屿。
&7 右键点击:前往你的下界岛屿。
&7 Shift+点击:在此处设置家。
&7 岛屿等级:&e%Level_[gamemode]_island_level%
command: '[label] go'
right_click_command: '[label] go nether'
shift_click_command: '[label] sethome'
10:
name: '&e&l ? 设置家'
icon: minecraft:white_bed
description: |-
&7 将你的岛屿家园
&7 设置为当前位置。
command: '[label] sethome'
11:
name: '&b&l ? 团队'
icon: minecraft:player_head
description: |-
&7 查看并管理
&7 你的岛屿团队。
command: '[label] team'
12:
name: '&d&l ✉ 邀请'
icon: minecraft:paper
description: |-
&7 邀请一名玩家加入
&7 你的岛屿。
&7 用法:&f/[label] invite <player>
command: '[label] invite'
13:
name: '&6&l ⚙ 设置'
icon: minecraft:anvil
description: |-
&7 配置你的岛屿
&7 保护设置。
command: '[label] settings'
# ── 统计与排行榜 ──────────────────────────────────────────────────────
18:
name: '&e&l ⭐ 岛屿等级'
icon: minecraft:experience_bottle
description: |-
&7 计算你的岛屿等级。
&7 当前等级:&e%Level_[gamemode]_island_level%
&7 当前排名:&6%Level_[gamemode]_island_rank%
command: '[label] level'
19:
name: '&6&l ? 顶级岛屿'
icon: minecraft:gold_block
description: |-
&7 查看本服务器上
&7 排名前 10 的岛屿。
command: '[label] top'
20:
name: '&a&l ? 传送点'
icon: minecraft:ender_eye
description: |-
&7 浏览玩家传送点。
command: '[label] warps'
21:
name: '&5&l ? 挑战'
icon: minecraft:enchanting_table
description: |-
&7 完成挑战
&7 获取丰厚奖励!
command: '[label] challenges'
22:
name: '&b&l ? 生物群系'
icon: minecraft:oak_sapling
description: |-
&7 更改你岛屿上的
&7 生物群系。
command: '[label] biomes'
# ── 世界 / 实用工具 ───────────────────────────────────────────────────
27:
name: '&f&l ? 出生点'
icon: minecraft:bedrock
description: |-
&7 传送至世界出生点。
command: '[label] spawn'
28:
name: '&c&l ? 商店'
icon: minecraft:emerald
description: |-
&7 打开服务器商店。
command: 'shop'
29:
name: '&e&l ? 余额'
icon: minecraft:gold_nugget
description: |-
&7 查看你当前的余额。
&7 余额:&6%vault_balance%
command: 'balance'
# 控制台命令示例 — 以服务器身份运行,而非玩家
35:
name: '&c&l ? 报告 Bug'
icon: minecraft:writable_book
description: |-
&7 向管理员报告问题。
&7 打开支持工单。
command: '[server] ticket create [player] bug-report'
# 第 5 行:装饰性边框
"36-44":
name: ' '
material: BLACK_STAINED_GLASS_PANE
description: ''
command: ''
# ── VIP 面板 — 通过权限 bskyblock.controlpanel.panel.vip 分配 ─
vip:
defaultPanel: false
panelName: '&8&l⚙ &r&d&l VIP 控制面板'
permission: 'vip'
buttons:
"0-8":
name: ' '
material: PURPLE_STAINED_GLASS_PANE
description: ''
command: ''
9:
name: '&a&l ? 前往岛屿'
icon: minecraft:grass_block
description: |-
&7 传送至你的岛屿。
&7 岛屿等级:&e%Level_[gamemode]_island_level%
command: '[label] go'
10:
name: '&e&l ? 设置家'
icon: minecraft:white_bed
description: |-
&7 设置你的岛屿家园。
command: '[label] sethome'
11:
name: '&b&l ? 团队'
icon: minecraft:player_head
description: |-
&7 查看并管理团队。
command: '[label] team'
12:
name: '&5&l ? 挑战'
icon: minecraft:enchanting_table
description: |-
&7 完成挑战!
command: '[label] challenges'
# VIP 专属 — 通过控制台授予套件
13:
name: '&d&l ? VIP 套件'
icon: minecraft:chest
description: |-
&d VIP 专属!
&7 领取你的每周 VIP 套件。
command: '[server] kit vipweekly [player]'
# VIP 专属 — ItemsAdder 自定义图标示例
14:
name: '&6&l ✨ VIP 特权'
itemsadder: 'iasurvival:vip_star'
description: |-
&7 浏览你所有的 VIP 特权。
command: 'vipperks'
18:
name: '&e&l ⭐ 岛屿等级'
icon: minecraft:experience_bottle
description: |-
&7 当前等级:&e%Level_[gamemode]_island_level%
&7 当前排名:&6%Level_[gamemode]_island_rank%
command: '[label] level'
19:
name: '&6&l ? 顶级岛屿'
icon: minecraft:gold_block
description: |-
&7 查看排名前 10 的岛屿。
command: '[label] top'
20:
name: '&f&l ? 出生点'
icon: minecraft:bedrock
description: |-
&7 传送至世界出生点。
command: '[label] spawn'
"36-44":
name: ' '
material: PURPLE_STAINED_GLASS_PANE
description: ''
command: ''
? 提示
-
替代点击 — 在按钮中添加
right_click_command和/或shift_click_command,以便在右键点击和 Shift+左键点击时执行不同的命令。若省略这些配置,则回退使用command。 -
槽位布局 — 标准的一行箱子对应槽位 0–8。一个 6 行的箱子(最大值)使用槽位 0–53。
-
槽位范围 — 使用
"0-8"(需加引号)将同一个按钮放置在一系列槽位中。非常适合用于边框装饰。 -
空白按钮 — 设置
command: ''和name: ' '以创建视觉上的间隔或边框。 -
控制台命令 — 在前面加上
[server]前缀,即可作为控制台静默执行命令,例如用于物资箱、经济奖励或玩家没有权限直接执行的管理员操作。 -
多个面板 — 给予玩家
[gamemode].controlpanel.panel.<后缀>权限,即可显示不同的面板。适合用于工作人员、捐赠者或拥有特定排位的玩家。 -
ItemsAdder 图标 — 使用
itemsadder:键(而非icon:或material:)来显示具有自定义纹理的物品。需要安装 ItemsAdder;若未安装则优雅降级。 -
重新加载 — 编辑 YAML 后,再次运行
/{admin} cp import以完成重载。确认后,现有面板将被替换。
? 信息
更多信息请参阅 BentoBox 文档。
需要帮助?加入 BentoBox Discord。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧