GUIShop

插件

· 作者 pablo67340

这个插件是解决所有告示牌、箱子以及漏洞的终极方案。

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

最新 9.4.4 · 26.2 · Bukkit / Folia

一键开服(送7天)

GUIShop Banner Updated

GUIShop v9.4.3c

Minecraft 服务器终极基于 GUI 的商店插件

完全兼容 Paper/Spigot/Folia/Bukkit 1.13 - 1.21.11


概述

GUIShop 是一款功能强大、特性丰富的商店插件,允许服务器管理员创建美观且高度可定制的基于 GUI 的商店。告别令人困惑的告示牌商店和箱子系统。GUIShop 为玩家提供直观的购物体验,同时赋予管理员对价格、物品和布局的完全控制权。


主要特性

  • 易于使用的 GUI 系统 - 玩家通过整洁、有序的库存菜单浏览商店
  • 多页商店 - 为大型物品目录创建具有无限页面的商店
  • 动态定价 - 可选的基于供需关系的定价系统
  • 价值显示系统 - 直接在物品描述中显示出售价值(需要 PacketEvents)
  • 完整的基于 GUI 的物品编辑器 - 通过直观的 GUI 编辑物品价格、名称、附魔等
  • 拖拽式商店构建 - 只需拖拽即可放置和重新排列商店中的物品
  • 命令物品 - 出售时可执行命令的命令物品
  • 自定义物品支持 - 完全支持附魔、药水、烟花和自定义模型数据
  • 原生刷怪笼支持 - 配置并售卖任何实体类型的刷怪笼
  • 原生玩家头颅支持 - 使用玩家 UUID 或 Base64 皮肤纹理制作自定义头颅
  • PDC 支持 - 使用 Bukkit 的持久化数据容器 API 进行可靠的物品识别
  • 单物品权限控制 - 限制特定物品仅供某些玩家组使用
  • PlaceholderAPI 支持 - 在商店名称和描述中使用占位符
  • Vault 集成 - 兼容任何 Vault 经济插件
  • 内置经济系统 - 可选的内部经济系统(无需外部经济插件!)
  • 替代出售 GUI - 在不离开商店的情况下出售物品
  • 交易日志记录 - 追踪所有购买和销售记录

截图

点击查看截图

主菜单

Main Menu

商店视图

Shop View

物品编辑器

Item Editor

数量选择器

Quantity Selector

价值显示

Worth Display


命令

玩家命令

/shop, /buy          - 打开商店菜单
/sell                - 打开出售 GUI
/value, /val         - 检查手持物品的购买/出售价值

管理员命令

/gs reload           - 重载所有配置文件
/gs edit             - 进入主菜单的创建者模式
/gs edit menu        - 进入主菜单的创建者模式
/gs edit transaction - 进入交易 GUI 的创建者模式
/gs edit [shop]      - 进入特定商店的创建者模式
/gs edit [shop] [page] - 编辑特定商店的特定页面
/gs parsemob <type>  - 验证刷怪笼的实体类型
/gs toggleworth      - 切换自身的价值显示(仅当前会话有效)
/gs iteminfo         - 显示手持物品的综合信息

经济命令

(仅在启用内置经济时可用)

玩家命令:

/bal, /balance, /money          - 查看余额
/bal <player>                   - 查看其他玩家的余额
/pay <player> <amount>          - 向玩家转账
/togglepay                      - 开启/关闭转账通知

管理员命令:

/gs eco give <player> <amount>  - 给予玩家金钱
/gs eco take <player> <amount>  - 扣除玩家金钱
/gs eco set <player> <amount>   - 设置玩家余额
/gs eco balance <player>        - 查看玩家余额
/gs eco reset <player>          - 重置为初始余额

所有金额均支持缩写:1k, 1.5M, 100B 等。

物品信息命令

/gs iteminfo 命令是一个强大的调试和配置辅助工具。手持任意物品并运行该命令以查看:

  • 材质类型和显示名称
  • 所有描述行
  • 配置就绪格式的附魔(例如 SHARPNESS:5 UNBREAKING:3)
  • 配置就绪格式的药水信息(类型、溅射版、延长版、升级版)
  • 配置就绪格式的烟花信息(飞行效果、爆炸效果、颜色)
  • 所有 PDC(持久化数据容器)值
  • 自定义 NBT 数据

这使得配置复杂物品变得非常容易——只需创建你想要的物品,然后使用 /gs iteminfo 获取 shops.yml 所需的精确格式。


权限

guishop.use          - 访问商店(默认:op)
guishop.shop.*       - 访问所有商店物品(默认:op)
guishop.shop.<shop>.<item> - 访问特定物品
guishop.reload       - 重载插件的权限(默认:op)
guishop.creator      - 访问游戏内商店编辑器(默认:op)
guishop.value        - 访问 /value 命令(默认:true)
guishop.sell         - 访问 /sell 命令(默认:true)
guishop.admin        - 完整管理员权限(默认:op)

配置

GUIShop 使用多个配置文件以实现最大灵活性:

  • config.yml - 通用插件设置、命令、标题、按钮
  • shops.yml - 商店布局和物品定义
  • menu.yml - 主菜单配置
  • messages.yml - 所有插件消息(完全可定制)
  • worth.yml - 价值显示系统配置
示例商店物品配置
shops:
  Blocks:
    pages:
      Page0:
        '0':
          type: SHOP              # 物品类型(SHOP、COMMAND、SHOP_SHORTCUT、DUMMY、BLANK)
          id: STONE               # 材质 ID
          buy-price: 10.0         # 购买价格(设为 'false' 则禁用)
          sell-price: 5.0         # 出售价格(设为 'false' 则禁用)
          shop-name: '&7Stone'    # 商店中显示的名称
          buy-name: '&7Stone'     # 购买后物品显示的名称
          shop-lore:              # 商店中显示的描述信息
            - '&fA basic building block'
          enchantments: 'DURA:1 SHARP:2'  # 附魔(空格分隔)
          quantity: 64            # 给予的堆叠数量
          permission: 'shop.vip'  # 所需权限(可选)

基于 GUI 的物品编辑器

GUIShop 提供了一个功能强大且完全基于图形用户界面 (GUI) 的物品编辑器,无需手动编辑配置文件。通过直观的点击式菜单配置商店物品的各个方面。

工作原理

  1. 使用 /gs edit(用于菜单)或 /gs edit <shop>(用于特定商店)进入创建者模式
  2. 左键点击以拖放物品——在商店内移动物品、重新排列位置,或将背包中的新物品放置到商店中
  3. 右键点击或 Shift+点击任意物品以打开物品编辑器 GUI
  4. 点击任何设置项,通过聊天输入或嵌套选择 GUI 进行修改
  5. 关闭库存界面时自动保存更改

创建者模式控制

左键点击     - 拾取 / 放置物品(可在商店与背包之间操作)
右键点击     - 打开被点击物品的物品编辑器
Shift+点击   - 打开被点击物品的物品编辑器

导航按钮(分页、返回、余额):
左键点击     - 拾取并移动按钮
右键点击     - 打开该按钮的物品编辑器
Shift+点击   - 激活按钮(切换页面、返回等)

物品编辑器功能

  • 购买/出售价格 - 支持缩写格式(如 1k, 1.5M, 100B)设置价格
  • 物品类型 - 在 SHOP、COMMAND、SHOP_SHORTCUT 和 DUMMY 类型之间切换
  • 显示名称 - 设置商店显示名称和购买后物品名称
  • 自定义描述 - 为物品添加描述性 Lore 行
  • 附魔 - 通过可视化附魔选择器添加/移除附魔
  • 药水效果 - 通过 GUI 配置药水类型、持续时间和等级
  • 烟花属性 - 设置飞行持续时间、爆炸形状、颜色和效果
  • 刷怪笼怪物类型 - 从可视化实体选择器中选择怪物类型
  • 命令 - 配置购买时执行的命令
  • 权限 - 为每个物品设置所需权限
  • 数量 - 设置购买时给予的堆叠数量
物品编辑器截图

物品编辑器主视图

Item Editor

附魔选择器

Enchantment Editor

药水编辑器

Potion Editor


价值显示系统

GUIShop 包含一个强大的价值显示功能,可直接在物品描述中显示出售价值。该系统使用数据包操作仅在客户端侧显示价值,这意味着你的实际物品永远不会被修改。

要求: PacketEvents 插件

价值显示配置 (worth.yml)
enabled: true
format: "&7Worth: &a%worth%"
position: BOTTOM
add-blank-line: true
only-show-sellable: true
not-sellable-format: "&7Worth: &cNot sellable"

# 在特定库存界面隐藏价值
blacklisted-inventories:
  - "Auction House"
  - "Crate Preview"

# 在具有特定名称的物品上隐藏价值
blacklisted-item-names:
  - "Crate Key"
  - "Vote Token"

# 在装备的盔甲上隐藏价值
hide-armor-slots: true

高级物品类型

命令物品

出售并在购买时执行命令。使用占位符如 {PLAYER_NAME}、{PLAYER_UUID}、{PLAYER_WORLD} 或任何 PlaceholderAPI 占位符:

'19':
  type: COMMAND
  id: NETHER_STAR
  shop-name: '&6VIP Rank'
  buy-price: 10000
  sudo: false          # 以控制台身份运行(默认)或以玩家身份运行(true)
  commands:
    - 'lp user {PLAYER_NAME} parent set vip'
    - 'broadcast {PLAYER_NAME} purchased VIP!'

可用占位符:

占位符 描述
{PLAYER_NAME} 玩家名称
{PLAYER_UUID} 玩家 UUID
{PLAYER_WORLD} 玩家当前所在世界
{PLAYER_BALANCE} 玩家经济余额

所有占位符也支持 %placeholder% 格式。如果安装了 PAPI,也支持 PlaceholderAPI 占位符。

Sudo 模式: 将 sudo: true 设置为以玩家身份而非控制台身份运行命令。适用于检查玩家权限或仅限玩家执行的命令。

附魔书

'20':
  type: SHOP
  id: ENCHANTED_BOOK
  buy-price: 1000
  enchantments: 'SHARP:5 FIRE_ASPECT:2'

药水

通过 potion-info 部分配置药水。支持普通药水、喷溅药水和滞留药水。

# 普通药水(加速 II)
'21':
  type: SHOP
  id: POTION
  buy-price: 500
  potion-info:
    type: SPEED
    splash: false
    lingering: false
    extended: true
    upgraded: false

# 喷溅药水(治疗 II)
'22':
  type: SHOP
  id: SPLASH_POTION
  buy-price: 600
  potion-info:
    type: HEALING
    splash: true
    lingering: false
    extended: false
    upgraded: true

# 滞留药水
'23':
  type: SHOP
  id: LINGERING_POTION
  buy-price: 700
  potion-info:
    type: POISON
    splash: false
    lingering: true
    extended: true
    upgraded: false

药水信息字段:

字段 描述
type 药水效果(SPEED, HEALING, STRENGTH, POISON 等)
splash 是否为喷溅药水
lingering 是否为滞留药水
extended 持续时间延长版本
upgraded II 级/更强效果版本

刷怪笼

支持任意有效实体类型的原生刷怪笼(使用 /gs parsemob <type> 进行验证):

'22':
  type: SHOP
  id: SPAWNER
  buy-price: 50000
  mob-type: ZOMBIE
  shop-name: '&6僵尸刷怪笼'

烟花

'23':
  type: SHOP
  id: FIREWORK_ROCKET
  buy-price: 100
  firework-info:
    flight: 2
    explosions:
      - shape: ball_large
        flicker: true
        trail: true
        colors: [11743532, 2437522]
        fade-colors: [1973019, 15790320]

玩家头颅

支持玩家 UUID 或 Base64 皮肤纹理:

# 使用玩家 UUID
'24':
  type: SHOP
  id: PLAYER_HEAD
  buy-price: 1000
  skull-uuid: 'player-uuid-here'

# 使用 Base64 皮肤纹理(来自 minecraft-heads.com 等)
'25':
  type: SHOP
  id: PLAYER_HEAD
  buy-price: 500
  skull-uuid: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWJjMTIzIn19fQ=='

统计与 PlaceholderAPI

GUIShop 会追踪玩家的商店统计数据,并与 PlaceholderAPI 集成,以便在计分板、全息图和聊天中使用。

追踪的统计数据

  • 总消费金额(从商店购买)
  • 总赚取金额(出售物品)
  • 总购买/出售物品数量
  • 每位玩家购买最多的前 3 种物品
  • 每位玩家出售最多的前 3 种物品

可用的占位符

%guishop_total_spent%           - 消费金额(带千位分隔符)
%guishop_total_spent_formatted% - 消费金额(缩写格式:1.5M)
%guishop_total_earned%          - 赚取金额(带千位分隔符)
%guishop_total_earned_formatted% - 赚取金额(缩写格式)
%guishop_items_bought%          - 购买物品数量
%guishop_items_bought_formatted% - 购买物品数量(缩写格式)
%guishop_items_sold%            - 出售物品数量
%guishop_items_sold_formatted%  - 出售物品数量(缩写格式)
%guishop_top_bought_1%          - #1 最购买的物品 (材质: 数量)
%guishop_top_sold_1%            - #1 最出售的物品 (材质: 数量)

统计数据存储在 SQLite 数据库中 (plugins/GUIShop/Data/player_statistics.db)。


动态定价系统

GUIShop 内置了供需经济系统,使物品价格根据交易活动而波动。

工作原理

  • 当物品被购买时:供应减少 → 价格上涨
  • 当物品被出售时:供应增加 → 价格下跌
  • 随时间推移:价格逐渐恢复正常基准值

配置

在 config.yml 中启用:

dynamic-pricing: true

在 dynamicpricing.yml 中配置:

price-change-per-item: 0.01    # 每件物品变动 1%
max-price-multiplier: 2.0      # 最高可达基准价的 200%
min-price-multiplier: 0.5      # 最低降至基准价的 50%
normalization-rate: 0.001      # 价格回归正常的速度
normalization-interval: 300    # 每次归零调整之间的间隔秒数

单物品覆盖配置

为特定物品设置不同的波动性参数:

item-overrides:
  DIAMOND:
    price-change-per-item: 0.005  # 更稳定(每件物品变动 0.5%)
    max-price-multiplier: 1.5
    min-price-multiplier: 0.75

关联定价

使物品影响其他物品的价格——非常适合合成关系:

item-overrides:
  DIAMOND_BLOCK:
    affects:
      DIAMOND: 9.0           # 1 个方块 = 合成需要 9 颗钻石
      DIAMOND_ORE: 1.0       # 同时也影响矿石价格
  
  BREAD:
    affects:
      WHEAT: 3.0             # 1 个面包 = 合成需要 3 个小麦

当玩家购买 1 个 DIAMOND_BLOCK 时,DIAMOND 的价格变化相当于购买了 9 颗钻石。这基于合成配方创建了真实的经济关系!

单物品控制

将特定物品排除在动态定价之外:

'0':
  id: DIAMOND
  buy-price: 100
  sell-price: 50
  dynamic: false  # 使用静态定价

管理员命令

命令 描述
/gs market status 查看系统状态
/gs market info <item> 检查物品的市场状态
/gs market reset <item> 重置物品至基准价
/gs market resetall 重置所有价格

开发者 API

GUIShop 提供了全面的 API,供开发者进行集成:

API 示例
// 检查物品是否可以出售
boolean canSell = GUIShopAPI.canBeSold(itemStack);

// 获取买入/卖出价格
BigDecimal buyPrice = GUIShopAPI.getBuyPrice(itemStack, quantity);
BigDecimal sellPrice = GUIShopAPI.getSellPrice(itemStack, quantity);

// 以编程方式出售物品
GUIShopAPI.sellItems(player, SellType.COMMAND, items);

// 价值显示 API
BigDecimal worth = GUIShopAPI.getItemWorth(itemStack);
BigDecimal stackWorth = GUIShopAPI.getStackWorth(itemStack);

// 按玩家切换价值显示
GUIShopAPI.toggleWorthForPlayer(player);
GUIShopAPI.enableWorthForPlayer(player);
GUIShopAPI.disableWorthForPlayer(player);

// 用于持久化按玩家价值设置的钩子
GUIShopAPI.setExternalWorthCheck(player -> {
    return myPlugin.hasWorthDisabled(player.getUniqueId());
});

完整的 API 文档请参阅 Wiki。


依赖项

必需:

  • Vault(用于经济 API)

可选:

  • Economy Plugin(EssentialsX、CMI 等)- 或者使用 GUISShop 内置的经济系统!
  • PacketEvents(用于价值显示功能)

Folia 支持: GUIShop 完全支持 Folia —— Paper 的区域化多线程分支,旨在提升大型服务器的性能。无需额外配置!

  • PlaceholderAPI(用于占位符支持)

注意: GUIShop 包含其自身的经济系统!在 economy.yml 中启用它,即可将 GUIShop 用作服务器的经济系统,无需 EssentialsX 或其他类似插件。


安装

  1. 下载 GUIShop 并将其放入你的 plugins(插件)文件夹中
  2. 安装 Vault 和经济类插件(如 EssentialsX、CMI 等)——或者启用 GUIShop 内置的经济系统
  3. (可选)安装 PacketEvents 以显示物品价值
  4. (可选)安装 PlaceholderAPI 以支持占位符
  5. 重启服务器
  6. 在 plugins/GUIShop/shops.yml 中配置商店
  7. 使用 /gs reload 应用更改

支持


由 pablo67340 开发

如果你喜欢 GUIShop,请考虑留下评价!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源