Control Panel

插件

· 作者 tastybento

一个可自定义的 GUI 面板,为玩家提供对 BentoBox 所有游戏模式设置和操作的便捷访问。

0 本站下载 0 关注 更新于 7 个月前

需要前置:BentoBox

最新 1.16.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

?️ 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 等

? 安装

  1. 将 ControlPanel JAR 文件放入 plugins/BentoBox/addons/ 目录中。
  2. 重启服务器 —— ControlPanel 会在 plugins/BentoBox/addons/ControlPanel/ 下创建一个默认的 controlPanelTemplate.yml 文件。
  3. 编辑 controlPanelTemplate.yml 以构建你的面板(见下文)。
  4. 在游戏中运行导入命令以加载你的面板:
    /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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源