Inventory Shop - 背包商店

这是一个简单的 GUI 商店插件，允许玩家通过图形界面购买和出售物品。要创建商店，请参考配置文件 config.yml。本插件需要 Vault 及配套的经济插件才能运行。

💡核心功能

• 通过直观的 GUI 界面进行物品买卖。
• 支持自定义物品的显示名称、描述文本（Lore）和附魔。
• 商店支持多页面显示。
• 可配置购买/出售数量、提示信息、音效等。

🎮配置说明

自定义物品

物品可以包含自定义的显示名称、描述文本和附魔。如需添加，您需要在 items.yml 文件中创建一个自定义物品，然后在商店配置中使用 $物品名称 来代替物品 ID。

多页面商店

商店可以拥有多个页面。要添加新页面，只需在 items 配置部分插入一个空行即可。

示例 (shops.yml 片段):

items:
- 18 7.5 1.5
- 18:1 7.5 1.5
- '' # -------------  新页面从这里开始
- 38:4 9.0 1.8
- 38:5 9.0 1.8

🔧命令列表

• /shop open <商店名称> [玩家名] - 为指定玩家打开商店 GUI。
• /shop list - 列出所有已配置的商店。
• /shop reload - 重载插件配置。

✨权限节点

• shop.command.usage - 查看命令使用帮助的权限。
• shop.command.open - 使用 /shop open 命令的权限。
• shop.command.open.others - 为其他玩家打开商店 GUI 的权限。
• shop.command.list - 使用 /shop list 命令的权限。
• shop.command.reload - 使用 /shop reload 命令的权限。

⭐配置文件详解

config.yml

主要配置文件，用于设置商店的通用行为。

# 购买和出售物品的数量范围。
amountPattern: '1-16'

# 是否允许出售带有颜色代码显示名称的物品。
ignoreColoredDisplay: true

# 将添加到每个商店物品上的描述文本。
iconsLore:
- '&c左键单击 &6- 购买, &c右键单击&6 - 出售'
- '&e购买价格: &a{buy_price}'
- '&e出售价格: &c{sell_price}'

# 页面标题的后缀。
pageSuffix: ' #{page}'

# 以下配置用于商店界面底部的功能按钮。
changeAmount:
  enable: true
  slot: 8
  id: iron_ingot
  name: '&e更改数量'
  lore: []

nextPage:
  slot: 6
  id: '351:10'
  inactiveId: '351:8'
  name: '&a下一页'
  inactiveName: '&8下一页'

previousPage:
  slot: 5
  id: '351:13'
  inactiveId: '351:8'
  name: '&c上一页'
  inactiveName: '&8上一页'

# 自定义按钮节点，例如返回按钮。
customNodes:
  '1':
    slot: 0
    id: arrow
    name: '&e返回'
    lore: []
    action:
    - 'menu'
    close: false

# 提示消息。
messages:
  noItem: '&c你需要拥有 {amount} 个 {item}'
  noMoney: '&c你需要 {money} 才能购买此物品'
  bought: '&c你购买了 {item} ({amount})，花费 {money}'
  sold: '&c你出售了 {item} ({amount})，获得 {money}'

# 音效。音效名称可在此查询：hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
sounds:
  bought: none
  sold: none
  noMoney: none
  noItem: none

shops.yml

用于定义具体的商店。

# 商店示例：方块商店
blocks:
  name: '&1方块' # 商店显示名称
  command: 'blocks' # 打开商店的命令参数
  rows: 6 # GUI 行数
  items:
  # 格式：物品ID 购买价格 出售价格
  - 4 7.5 1
  # 格式：物品ID:数据值 购买价格 出售价格
  - 98:1 12.0 2.4
  # 使用自定义物品，格式：$自定义物品名称 购买价格 出售价格
  - '$murdolator 300 150'

items.yml

用于定义自定义物品。

# 自定义物品示例：Murdolator
murdolator:
  id: diamond_sword:0 # 物品ID与数据值
  name: '&c&lMurdolator' # 显示名称
  lore: [] # 描述文本
  enchantments: # 附魔
    DAMAGE_ALL: 6
    FIRE_ASPECT: 1

❓依赖与要求

• 必需插件: Vault 及一个兼容的经济插件（如 EssentialsX、CMI 等）。
• 请确保在安装本插件前，服务器已正确安装并配置好上述依赖。