# 商店插件

{% hint style="info" %}

## **`为什么选择 StarShop ？`**

* **试衣间功能**，可以试穿 [**龙之时装**](https://plu.gitbook.io/star/shang-dian-cha-jian/lian-dong-cha-jian-long-zhi-shi-zhuang)，预览效果，支持部件和套装，时装可以叠加
* **购物车功能**，可以将想要购买的商品一次性加到购物者，通过在购物车结算 ，省去一个一个购买的繁琐，也可以不经过购物车直接购买
* **多数量购买**，可以**自定义多数量价格**，例如 一个300 十个2000
* 达到指定金额，参加**满减活动**，例如满300减50，可以自定义
* 可以在购物车结算时，使用**优惠券**，和满减活动不冲突，可以设置优惠券有效期，到期自动删除，通过指令给予
* **每日限购**，自定义刷新时间，变量提示
* **终身限购**某商品，变量提示
* 同时支持 **金币 ，点券 ，Mythic-item ，自定义货币**，自定义货币为插件自带，支持**PAPI**变量
* 商店**分类**，每个分类下面包含**子分类**，可以无限拓展，可以快速返回第一页，或到达最后一页
* 可以随时下架或上架某商品，可以上架**限时商品**，到期后自动下架
* 商品左上角显示**标签状态（例如，热销，限时，优惠，折扣等）**，可自定义
* 购买商品后可以**执行命令，支持 \[op] \[player] \[cmd]**
* 不同**权限**可以对应不同**折扣**
* 设置购买商品所需要的**权限**等
  {% endhint %}

```
#         Powered by StarLibrary         #

# 调试信息
Debug: false

# 若打开,物品购买成功后发放物品会使用Ds邮箱发送
DsEmail-Hook:
  is-open: false
  #邮件标题
  title: "&f[系统邮件]&6系统商店购物"
  #邮件内容
  content: "&f感谢您对服务器的支持,请点击下方收件~"

# 是否在玩家打开商店后,暂时的将玩家身上已有的套装隐藏,这样不会影响试衣间的观感
Hide-Fashion:
  is-open: true

# 同步：同步插件数据,指向一个文件夹即可,比如 D://我的世界服务端/Paper 1.12.2/plugins/HelloWorld
# 不需要删除或填none即可,需要注意的是斜杠必须是 / , 然后盘符后得是两个斜杠,别写错了噢~
# 数据库还没做,这个应该能满足大部分客户的需求了,有特别需要数据库的再做数据库
Synchronize: "none"

ShopingCart:
  # 玩家最多放入几个商品进购物车
  quantity: 5

# 几点钟刷新每日限购(二十四小时制 1-24)
Refresh: 4

# 标签配置,自由拓展删除都可
Label:
  1: "https://pic.imgdb.cn/item/62241e0b5baa1a80ab012e0f.png"
  2: "https://pic.imgdb.cn/item/62241e0b5baa1a80ab012e13.png"
  3: "https://pic.imgdb.cn/item/62241e3e5baa1a80ab014f35.png"
  4: "https://pic.imgdb.cn/item/62241e3e5baa1a80ab014f45.png"
  5: "https://pic.imgdb.cn/item/62241e3e5baa1a80ab014f4d.png"


# 折扣活动（这里的折扣只对点券商品有效) 第一个参数单笔满多少,第二个参数减多少点券,第三为活动名，活动力度从大往小写
Discount:
  - '300<->50<->满300减50'
  - '200<->30<->满200减30'
  - '100<->5<->满100减5'


# 自定义货币,可以无限拓展
# 支持用PAPI取玩家货币 %starshop_point_自定义货币ID%
Custom:
  # 货币Id: "展示名"
  11: "&e11"

Visible:
  # 玩家不满足购买权限的话是否隐藏商品
  permission: false
  # 不满足购买次数限制的商品,是否对该玩家隐藏
  frequency: false

# 优惠券(优惠券只对点券购买生效)
#   PS:如您已经给玩家A券,却在配置内删除A券的配置,那玩家不会显示有这张券哦
Coupon:
  # 自定义Id
  优惠券1:
    # 展示名
    dis-name: "[RPG]新用户专享"
    # 优惠券说明
    info: "无门槛-20优惠券"
    # 条件(满多少元能用)
    condition: 0
    # 优惠价格
    discount: 20
    # 到期时间(到这天就无法使用,不需要限制的话填0即可)
    maturity: "2022/04/05"

```

```
#         Powered by StarLibrary         #

# 文件同名
时装:
  # 商店名
  Dis-Name: "&f时\n装"
  # 商店子分类
  Type:
    - '帽子'
    - '衣服'
    - '裤子'
    - '鞋子'
    - '主手'

  # 商品Id(不要重复,也不能和ShopType文件夹内其他商店配置里的Id重复)
  商品1:
    # 修饰名 (填none的话,会取MM物品的Id)
    dis-name: "none"
    # 是否可视(就是能否在商店看到该商品,适用于如果目前想下架以后又想上架的话,可以先填false,这样下次上架就不用重新写配置了）
    visible: true
    # 类型,上方配置的选一个
    type: "帽子"
    # 自动下架时间,到了该时间商品不会展示 (格式: 2059/12/20) 不需要直接删除或填none即可
    auto-removal: "none"
    # 绑定的MM物品 (就是购买后发送什么给玩家,左边MM物品Id,右边数量)
    bind-mm: "坐骑<->1"
    is-give: false
    # 标签 (标签的图标在setting.yml自行配置噢,不用的话可以删除,或填none)
    label: "1"
    # 是否为时装物品 （时装物品旁边会多个试穿按钮）
    is-armour: false
    # 限购
    purchase-limit:
      # 限购模式(0:不作任何限制,1:每日限制购买,2:终身购买次数)
      type: 0
      # 限制的次数
      value: 0
    # 权限限制 （none = 不限制，或删除即可)
    permission: "none<->失败!该商品仅限VIP可购买"
    # 所需货币
    currency:
      # 填写, money,point,mm物品Id,自定义货币前方需要加<Custom>
      type: point
      # 上方填写的金币或点券的话这里代表的就是需要花费多少,如果上面写MM物品Id,那就是需要多少数量
      value: 500
      # 多购买方案,这里代表一次性购买5个只需2000元,10个只需8000,如果用不到删除本项或注释掉即可
      other:
        - '5<->2000'
        - '10<->8000'
    # 不同权限对应的折扣
    # 以下意思为 拥有vip.3权限话该商品享受6.3折折扣,折扣越大的权限写在越上面
    sale:
      - 'vip.3<->6.3<->&fVIP3'
    # 描述 (会加在上面绑定MM物品的Lore的最下面)（不需要的话删除或注释该项即可）
    describe:
      - '&7 啊哈'
    # 成功购买后执行的指令（不需要的话删除或注释该项即可）
    # 支持[op] [cmd] [p]
    # {p} 代表当前玩家名
    commands:
      - '[cmd]say {p} 11111111111111111111111111111111111111'


```