ItemShops [BSP] - Create fancy GUI shops with minimal effort - ItemShops - 便捷GUI商店插件

ItemShops 是一款能够轻松创建精美物品商店的插件。它基于 BossShopPro，只需简单配置即可生成功能完善的收购与出售商店，并支持多种自定义选项。

💡核心特性

• 生成精美的物品商店界面
• 玩家可选择 购买、填满背包、出售 或 全部出售（买卖功能可单独禁用）
• 支持 高级商店样式 或 简易商店样式
• 可创建无限种商店，并能与 BossShopPro 的原生商店组合使用
• 支持附魔、药水效果等特殊物品
• 可自定义每个物品及商店的外观
• 配置简单，上手快速

样式预览

• 高级样式
• 简易样式
• 高级样式（禁用出售功能）

首次加载 ItemShops 时，它会自动生成配置文件和一个示例商店（位于 /plugins/BossShopPro/shops）。您可以使用命令 /itemshop 打开该商店。

🎮物品配置基础

每个物品的基本配置格式如下

stone:
  Worth: 3.0
  Item:
  - type:STONE
  - amount:64

物品只需一个 价值 (Worth) 值，买卖价格将根据此值自动计算：

• 购买价格 = 价值 (Worth) × 价格乘数 (在 config.yml 中定义)
• 出售收益 = 价值 (Worth) × 收益乘数 (在 config.yml 中定义)

固定价格与收益

您也可以为物品设置固定的买卖价格，只需添加 PriceBuy 或 RewardSell 行即可覆盖自动计算的值。

示例：设置固定价格

stone:
  PriceBuy: 5.0    # 固定购买价
  RewardSell: 1.0  # 固定出售价
  Item:
  - type:STONE
  - amount:64

示例：混合设置

polishedgranite:
  Worth: 3.0       # 用于计算未覆盖的项
  PriceBuy: 7.0    # 覆盖购买价
  Item:
  - type:STONE
  - durability:2
  - amount:64

物品信息配置

除了价值，每个物品都需要一些基本信息

• type 或 id 是必需的（例如 type:STONE 或 id:1）
• 如果使用简易商店，则需要 amount；高级商店中此项会被忽略
• 您可以添加任何其他项目信息，例如：
• durability:<数值>：用于定义材料子ID
• 更多完整列表请参考：[链接](Link)

插件自带一个包含大量预定义物品的商店，您可以立即使用，也可以创建或扩展自己的商店。

🔧配置与设置

配置文件 (config.yml)

您可以在配置文件中调整商店的整体外观和行为。

# BossShopPro
# by Felix Neubauer
# 更多信息请访问：https://www.spigotmc.org/wiki/bossshoppro-addons

# PriceMultiplier:
# 玩家购买物品的价格 = 价值 (worth) × 价格乘数。
PriceMultiplier: 1.2

# RewardMultiplier:
# 玩家出售物品的收益 = 价值 (worth) × 收益乘数。
RewardMultiplier: 0.6

# WorthIsForOneUnit:
# 若启用，给定的价值仅针对一个物品单位。若禁用，则价值针对整个物品堆叠。
# 示例：
# 启用：64个原木的价值 = 64 × 给定价值
# 禁用：64个原木的价值 = 给定价值
WorthIsForOneUnit: true

# CurrencyType:
# 所有物品使用的货币类型。支持所有使用数字的货币（Money, Points, Exp）。
CurrencyType: money

# UseAdvancedStyle:
# 若启用，每个商店物品都将拥有自己的子商店，玩家可在其中指定要购买/出售的数量。
UseAdvancedStyle: true

# AllowSell:
# 若禁用，玩家只能购买不能出售物品。
# 此为全局设置，可在单个物品中通过添加 "AllowSell: <true/false>" 行来覆盖。
AllowSell: true

# AllowBuy:
# 若禁用，玩家只能出售不能购买物品。
# 此为全局设置，可在单个物品中通过添加 "AllowBuy: <true/false>" 行来覆盖。
AllowBuy: true

# AllowSellAll:
# 若启用，玩家可以一键出售背包中所有该类型的物品。
# 此为全局设置，可在单个物品中通过添加 "AllowSellAll: <true/false>" 行来覆盖。
AllowSellAll: true

# AllowBuyAll:
# 若启用，玩家可以一键用该物品填满背包。
# 此为全局设置，可在单个物品中通过添加 "AllowBuyAll: <true/false>" 行来覆盖。
AllowBuyAll: true

# ShopItemLookSimple:
# 此处定义简易模式下的商店物品外观。
ShopItemLookSimple:
  MenuItem:
  - 'lore:&e点击 &2左键 &e购买 &b%reward% &e，花费 &c%price%&e。'
  - 'lore:&e点击 &2右键 &e出售 &c%price_right% &e，获得 &b%reward_right%&e。'
  - 'lore:&e点击 &2鼠标中键 &e出售 &c%price_middle% &e，获得 &b%reward_middle%&e。'
  MessageBuy: '&e你购买了 &3%reward% &e，花费 &c%price%&e'
  MessageSell: '&e你出售了 &c%price_right% &e，获得 &3%reward_right%&e。'
  MessageSellAll: '&e你出售了 &c%price_middle% &e，获得 &3%reward_middle%&e。'

# ShopItemLookAdvanced
# 此处定义高级模式下的商店物品外观。
ShopItemLookAdvanced:
  SubShop:
    Displayname: '&8ItemShop &8&l[right] &8%id%'
  Preview:
    MenuItem:
    - amount:%amount%
  Buy:
    MenuItem:
    - type:160:5
    - name:&a购买
    - amount:1
    - 'lore:&f数量: &e%amount%'
    - 'lore:&f花费: &e%price%'
    - 'lore:'
    - 'lore:&f&n点击购买。'
    Message: '&e你购买了 &3%reward% &e，花费 &3%price%&e。'
  Sell:
    MenuItem:
    - type:160:6
    - name:&c出售
    - amount:1
    - 'lore:&f数量: &e%amount%'
    - 'lore:&f收益: &e%reward%'
    - 'lore:'
    - 'lore:&f&n点击出售。'
    Message: '&e你出售了 &3%price% &e，获得 &3%reward%&e。'
  SellAll:
    MenuItem:
    - type:BUCKET
    - 'name:&c全部出售'
    - amount:1
    - 'lore:&f获得 &e%reward%。'
    - 'lore:'
    - 'lore:&f&n点击出售全部。'
    Message: '&e你出售了 &3%price% &e，获得 &3%reward%&e。'
  Back:
    MenuItem:
    - type:REDSTONE
    - amount:1
    - name:&c返回
    - 'lore:&f&n点击返回商店。'
    Message: ''
  Close:
    MenuItem:
    - type:BARRIER
    - amount:1
    - name:&c关闭
    - 'lore:&f&n点击关闭菜单。'
    Message: ''

示例商店文件

请将所有 ItemShops 商店文件放置在 plugins/BossShopPro/shops 文件夹中。

示例：ItemShop 商店

ShopName: ItemShop
DisplayName: '&8ItemShop (%page%/%maxpage%)'
Command: itemshop
signs:
  text: '[ItemShop]'
  NeedPermissionToCreateSign: true
itemshop:
  stone:
    Worth: 3.0
    Item:
    - type:STONE
    - amount:64
  granite:
    Worth: 3.0
    Item:
    - type:STONE
    - durability:1
    - amount:64
  # ... 更多物品

与 BossShopPro 商店组合示例

您可以将 ItemShop 与原生 BossShopPro 商店组合在同一个文件中。

ShopName: CombinedShop
DisplayName: '&8CombinedShop (%page%/%maxpage%)'
Command: combinedshop
signs:
  text: '[CShop]'
  NeedPermissionToCreateSign: true
itemshop:
  stone:
    Worth: 3.0
    Item:
    - type:STONE
    - amount:64
  granite:
    Worth: 3.0
    Item:
    - type:STONE
    - durability:1
    - amount:64
shop:
  Back:
    MenuItem:
    - lore:&8返回主菜单
    - name:&c返回
    - amount:1
    - type:REDSTONE
    RewardType: SHOP
    Reward: shop
    PriceType: NOTHING
    Price: 10.0
    Message: ''
    ExtraPermission: ''
    InventoryLocation: 9

❓更多信息与依赖

• 有关如何设置的更多详细信息，请查看 BossShopPro 的项目页面或 Wiki。
• 此插件需要 BossShopPro 才能运行！