🛒 物品

这里是两个物品的配置：

items:
  A:
    price-mode: CLASSIC_ALL
    product-mode: CLASSIC_ALL
    products:
      1:
        material: STRING
        amount: 1
        give-actions:
          1:
            type: message
            message: '你获得了一根线!'
    buy-prices:
      1:
        match-placeholder: '%player_health%'
        amount: '1.65'
        placeholder: '{amount}$'
        start-apply: 0
    sell-prices:
      1:
        match-placeholder: '%player_health%'
        amount: '1.65'
        placeholder: '{amount}$'
        start-apply: 0
        give-actions:
          1:
            type: console_command
            command: 'eco give {player} {amount}'
  B:
    price-mode: CLASSIC_ALL
    product-mode: CLASSIC_ALL
    products:
      1:
        material: FEATHER
        amount: 1
    buy-prices:
      1:
        economy-plugin: Vault
        amount: '0.55'
        placeholder: '{amount}$'
        start-apply: 0
    sell-prices:
      1:
        economy-plugin: Vault
        amount: '0.52'
        placeholder: '{amount}$'
        start-apply: 0

物品/商品 ID

鉴于我们需要在商店的 layout 部分填入物品，其 ID 必须为单字符。

全局选项

• display-item：展示在商店菜单中的物品，可以与玩家实际获得的物品不同。虚拟物品必须设置 display-item 选项，否则它们就无法在商店菜单中显示。真实物品必须设置 config.yml 文件中 display-item 下的 auto-set-first-product 为 true 以允许你删除这个选项。启用后，若 display-item 未设置，那么出售的第一个真实物品将会被当做图标。该部分配置会使用到“物品格式”的配置。可选（若不设置则使用首个物品）
  • display-item.modify-lore：是否修改物品描述。可选（默认为 true）
• display-name：设置物品在 {product} 与增量购买菜单中显示的名称。可选。
• add-lore：为该物品设置额外描述，若不设置则使用配置文本中的默认值。可选。
• bedrock：见此。
• buy-more：设置该商品是否可以打开增量购买菜单，必须先删除商店的 buy-more 选项才可以让该设置生效！可选。
• price-mode：价格模式。可填入 ANY、ALL、CLASSIC_ANY 和 CLASSIC_ALL。必选。
• product-mode：物品模式，可填入的参数与上述相同。若设置了物品部分则必选。

模式	ANY	ALL	CLASSIC_ANY	CLASSIC_ALL
物品给予	随机给予符合条件的物品。	给予所有物品。	与 ANY 相同。	与 ALL 相同。
收取货币/物品	收取符合条件且数量足够的首个货币/物品。	玩家需要满足所有条件并拥有所有对应物品或货币才可出售。	与 ANY 相同。	与 ALL 相同。
给予货币（即出售）	发放符合条件的货币。	给予所有种类货币。	与 ANY 相同。	与 ALL 相同。
货币支持	支持动态定价与 apply 设置。	与 ALL 相同。	价格必须每次相同。	与 CLASSIC_ALL 相同。
性能影响	在出现大量买卖操作时可能占用较高。	与 ALL 相同。	与其他商店插件相差无几！	与 CLASSIC_ANY 相同。

• buy-actions：购买商品后执行的一系列动作。使用“动作格式”。可选。
• sell-actions：出售商品后执行的一系列动作。使用“动作格式”。可选。
• fail-actions：交易操作失败后执行的一系列动作。使用“动作格式”。可选。在上述示例中我们将它放在了 general-configs 部分下，设置了交易失败播放音效。
• buy-conditions：玩家购买该商品所需达到的条件。使用“条件格式”。可选。
• sell-conditions：玩家出售该商品所需达到的条件。使用“条件格式”。可选。
• buy-limits：设置购买或出售的最大次数；可选。若未设置，商品购买次数不作限制。
  • buy-limits.global：全局购买限制；可选。
  • buy-limits.default：若玩家未到达下述的任意条件，他们就会使用该限制；若设置了 buy-limits，则该项为必选参数。
• buy-limits.<条件 ID>：达到该要求的玩家将会使用该限制。可在“条件格式”章节找到对应的格式。例如：

buy-limits:
  default: 10
  vip: 20
buy-limits-conditions:
  vip:
    - 'permission: test.permission'

• sell-limits: 与 buy-limits 设置相同，但是是为出售使用的。

单条目选项

该部分配置包含如下选项：

• buy-prices
• sell-prices
• products

这些选项会单独介绍，请点此浏览。

交易次数重置选项

该部分配置包含如下选项：

• buy-times-reset-mode
• buy-times-reset-time
• buy-times-reset-time-format
• sell-times-reset-mode
• sell-times-reset-time
• sell-times-reset-time-format

这些选项会单独介绍，请点此浏览。

动态值

你可以在商店配置的 buy-prices、sell-prices 的 amount 部分与 buy-limits、sell-limits 的值中插入变量与数学计算格式。

另外在 buy-prices 与 sell-prices 部分下，你还可以设置两个新的选项：

• max-amount：最高价格。用于动态定价。可选。
• min-amount：最低价格。用于动态定价。可选。

需要注意的是，如果你需要使用 PlaceholderAPI 拓展的变量，则你需要使用新格式。如下所示：

    buy-prices:
      1:
        economy-plugin: Vault
        amount: '15 - {sell-times-player} * 0.1 + %ultimateshop_farming_B_sell-times-player% * 0.1'
        # 我们使用不带花括号“{}”的新格式.
        placeholder: '{amount}$'
        start-apply: 0

另外，如果你的物品位于打开的菜单中，你还需要将 menu.shop.click-update 选项设置为 true。否则出售物品 B 之后不会自动更新价格。

子按钮

有些时候，你可能需要在不同菜单中设置相同的物品，或者想要为同一个物品设置多个按钮。as-sub-button 选项就可以帮到你。只需在此设置另一个物品 ID，之后这个按钮就会被当做对应物品。

• display-item：支持为子按钮设置不同的显示物品。
• as-sub-button：可以在此填入 物品 ID 或 商店 ID;;物品 ID。

子按钮的示例可以在“商店”章节找到，你可以在其开头示例配置中 items 部分的 C 见到。