原创 - 开源 - 工具 - JibaiWorkbench 服务器交互工作台 - GUI菜单/商店/VIP/奖励系统

版权类型: 原创

插件中文名称: 即白服务器交互工作台

插件英文名称: JibaiWorkbench

原帖地址: https://github.com/A2225211273/-JibaiWorkbench

支持的核心（服务端）

Spigot
Paper
Purpur

语言支持: 中文（简体）

前置组件: Vault（可选，用于经济功能）：https://www.spigotmc.org/resources/vault.34315/
PlaceholderAPI（可选，用于变量解析）：https://www.spigotmc.org/resources/placeholderapi.6245/
LuckPerms（可选，用于权限组显示）：https://luckperms.net/

适配版本（Java）

1.21
1.20

JibaiWorkbench
即白服务器交互工作台

不用写代码，改改 YAML、套模板、执行指令，
5 分钟搭出主菜单、商店、VIP、奖励、传送和活动入口。

MC 1.20+ | Java 17 | Paper / Spigot / Bukkit / Purpur 全核心兼容 | 零强制依赖

在线 Wiki：

http://www.jibai.shop/

这插件是干嘛的

做服务器的都懂：主菜单、商店、签到、VIP 页、传送点……这些交互入口每个服都要，但要么去装一堆各管一摊的插件，要么找人写，改个按钮还得等。

JibaiWorkbench 就是把这些全塞进一套箱子 GUI 系统里。想要哪个页面，一条指令从模板生成，然后打开 YAML 改按钮、改动作、改条件、改文字，全程不碰 Java。改完 /jwb reload 立刻生效。

第一次装还会自动生成 8 套现成菜单，先跑起来再慢慢调，比从零写快太多。

5 分钟上手

把 JibaiWorkbench-1.0.0.jar 丢进 plugins/，重启服务器
游戏里输入 /jwb open main，主菜单就出来了
想改？编辑 plugins/JibaiWorkbench/menus/main.yml
保存后 /jwb reload，再打开看效果
怕写错？/jwb validate 一键检查有没有配错

⚠ 注意：所有 YAML 一定要用 UTF-8 保存，别用记事本另存为 ANSI，不然中文全乱码。推荐 VS Code / Notepad++。

能做什么

模块	能力
GUI 菜单	标题、行数、背景填充、发光、CustomModelData、多槽位按钮
商店系统	购买、出售、每日限购、库存、冷却、确认页，先扣款后发货，发货失败自动退款，防连点重复扣款
奖励系统	每日 / 每周 / 一次性 / 在线时长奖励，领取状态持久化，重进服务器照样记得
动作系统	开关菜单、玩家/控制台指令、消息、标题、音效、给物品、传送、跳服、冷却，左右键+Shift 分别配置
条件系统	按权限、金币、冷却、奖励状态控制按钮"显示"和"能否点击"
变量系统	内置 {player} {world} {balance} {group} 等，另支持 PlaceholderAPI 的 %papi% 变量
配置校验	上线前 /jwb validate 检查行数、槽位、材质、价格、目标菜单、依赖，写错不会让插件崩

内置 8 套模板：main 主菜单、shop 商店、vip VIP 页、reward 奖励、activity 活动、guide 新手指南、teleport 传送、rules 规则。用 /jwb create <模板> <菜单ID> 生成。

配置长什么样

商品按钮的关键是 shop: 段落。插件自动处理扣款、发货、限购、库存，不要自己写 take-money，不然容易扣款成功但发货失败。

YAML：

buttons:
  diamond:
    slot: 10
    material: DIAMOND
    name: "&b钻石 x8"
    lore:
      - "&7购买价：&a100 金币"
      - "&7出售价：&e60 金币"
      - "&e左键购买 &7/ &e右键出售"
    shop:
      buy-price: 100.0
      sell-price: 60.0
      give-item: "DIAMOND:8"
      daily-limit: 10       # 每日限购，0=不限
      stock: -1             # -1=无限库存
      confirm: false        # true=购买前弹确认页

奖励按钮的关键是 reward: 段落。插件自动记录领取状态和冷却，你不用写"标记已领取"。

YAML：

buttons:
  daily:
    slot: 10
    material: CHEST
    name: "&a每日奖励"
    reward:
      key: "daily"
      type: "daily"           # daily/weekly/once/playtime
      give-item: "DIAMOND:2"
      commands:
        - "give {player} bread 8"

  playtime:
    slot: 16
    material: CLOCK
    name: "&e在线满 60 分钟奖励"
    reward:
      key: "playtime_60"
      type: "playtime"
      playtime-min: 60
      give-item: "GOLD_INGOT:5"

YAML：

buttons:
  vip_only:
    slot: 15
    material: NETHER_STAR
    name: "&d&lVIP 专属指令"
    view-condition:
      - "permission: jibaiworkbench.reward.vip"
    actions:
      - "player-command: kit vip"

只有拥有该权限的玩家才能看到这个按钮。

指令

主指令 /jworkbench，别名 /jwb。

指令	作用
`/jwb open <菜单> [玩家]`	打开菜单，可为其他玩家打开
`/jwb create <模板> <菜单ID>`	从模板创建菜单
`/jwb copy <源> <目标>`	复制菜单
`/jwb reload`	重载配置与菜单
`/jwb validate`	校验所有菜单配置
`/jwb preview <菜单>`	预览菜单
`/jwb giveitem <玩家> <菜单>`	给玩家一个右键打开菜单的快捷物品
`/jwb list` / `/jwb help`	列出菜单 / 查看帮助