🛍️ DailyShop 插件允许玩家在每日商店中购买和出售物品。它具有可配置的 GUI 界面、多种货币支持和灵活的商品管理功能。支持多种 Minecraft 版本。

🛍️ DailyShop

🎯 介绍

DailyShop 是一个 Spigot/Paper 插件，它允许你创建每日轮换的商店，玩家可以在其中购买和出售物品。它旨在易于配置和使用，同时为服务器所有者提供强大的自定义选项。

⚙️ 主要特性

• 每日轮换的商店
• 可配置的 GUI 界面
• 支持多种货币 (Vault)
• 灵活的商品管理
• 多种 Minecraft 版本支持

🚀 如何安装

1. 将 DailyShop.jar 文件放入你的服务器的 plugins 文件夹中。
2. 重启服务器。
3. 使用 /ds reload 命令重新加载配置。

⌨️ 命令

• /ds: 打开主菜单。
• /ds reload: 重新加载配置文件。
• /ds open [shopID] [player]: 为指定玩家打开指定商店。
• /ds give [item] [player] [数量]:给予玩家一个shop item, 数量可选。
• /ds next: 强制商店刷新。需要dailyshop.admin 权限。

🔑 权限

• dailyshop.open: 允许玩家打开商店。默认所有玩家拥有。
• dailyshop.admin: 允许玩家使用管理命令，如 reload, open 等。

📝 配置

插件的配置文件位于 plugins/DailyShop/config.yml。你可以修改此文件以自定义商店的外观、商品和其他设置。

config.yml 示例

# general configuration options
settings:
  prefix: '&7[&aDailyShop&7] '                  # Plugin messages prefix
  first_time_open_shop: true                    # Open main menu when a player opens the shop for the first time
  language: EN                                  # messages file name. Don't include the .yml extension
  metrics: true                                 # bStats metrics

  # How the plugin will try to get the player's name
  #   - NAME: get the player's name directly from the player object
  #   - UUID: Get the player's name from a Mojang's endpoint using the player's UUID (more accurate)
  player_name_method: NAME

  # Shop items configuration
  shop:
    max_items_per_shop: 21                       # Max number of items per shop
    reset_time: 1                               # In-game hours to reset the shop
    timer:                                       # Items timer configuration
      enabled: true                              # Enables a timer in the item lore until the next shop reset
      format: "hh:mm:ss"                        # Timer format. Use Java's SimpleDateFormat
      color: "&a"                                # Timer color
      prefix: "&8Reset in: "                     # Timer prefix

  # When a player left clicks an item in a shop
  left_click:
    enabled: true                                 # Enables left click buy action
    price_variable: selling_price                  # Variable to be used for the price
    confirmation_pane: true                        # Open a confirmation pane before buying the item
    confirmation_pane_title: "&2Confirm Buy"       # Confirmation pane title

  # When a player right clicks an item in a shop
  right_click:
    enabled: true                                 # Enables right click sell action
    price_variable: buying_price                   # Variable to be used for the price
    confirmation_pane: true                        # Open a confirmation pane before selling the item
    confirmation_pane_title: "&2Confirm Sell"        # Confirmation pane title

  # When a player shift left clicks an item in a shop
  shift_left_click:
    enabled: false                                # Enables shift left click buy action
    price_variable: selling_price                  # Variable to be used for the price

  # When a player shift right clicks an item in a shop
  shift_right_click:
    enabled: false                                # Enables shift right click sell action
    price_variable: buying_price                   # Variable to be used for the price

  # Lore placeholders
  lore_placeholders:
    selling_price: "&aSelling Price: &e%selling_price% %money_symbol%"  # Selling price placeholder
    buying_price: "&aBuying Price: &e%buying_price% %money_symbol%"    # Buying price placeholder
    stock: "&aStock: &e%stock%"                                         # Stock placeholder
    remaining_stock: "&aRemaining Stock: &e%remaining_stock%"           # Remaining Stock placeholder
    max_stock: "&aMax Stock: &e%max_stock%"                              # Max Stock placeholder

  # global placeholders used in item lores
  global_placeholders:
    money_symbol: "$"                             # Money symbol to be used in item lores

  # If you want to keep the shop open after a player buys or sells an item
  keep_open_on_transaction: false

  # sounds played when buying or selling items
  sounds:
    buy: BLOCK_NOTE_BLOCK_PLING        # Sound played when buying an item
    sell: BLOCK_NOTE_BLOCK_PLING       # Sound played when selling an item

  # If the server uses a custom resource pack
  resource_pack:
    enabled: false
    url: "" # Your resource pack URL
    hash: "" # Your resource pack hash

# Items that will be displayed in the main menu
main_menu:
  title: "&6DailyShop"                  # Main menu title
  items:
    shops:                               # Shops item configuration
      material: EMERALD                   # Shops item material
      name: "&aShops"                     # Shops item name
      lore:                               # Shops item lore
        - "&7Click here to see the shops"
      slot: 13                          # Shops item slot in the main menu
    configuration:                       # Configuration item configuration
      material: COMPASS                   # Configuration item material
      name: "&aConfiguration"             # Configuration item name
      lore:                               # Configuration item lore
        - "&7Click here to configure the shop"
      slot: 49                          # Configuration item slot in the main menu. -1 to disable it
      permission: dailyshop.admin       # Permission to see the item

# GUI Configuration
gui:
  # General GUI configuration
  general:
    title: "&6Shop %shop%"                                             # Shop GUI title. %shop% is the shop's ID
    size: 54                                                          # Shop GUI size (9, 18, 27, 36, 45, 54)
    fill:                                                             # Fill the empty slots with a specific item
      enabled: false                                                  # Enables the fill item
      material: BLACK_STAINED_GLASS_PANE                              # Fill item material
      name: "&a"                                                       # Fill item name
    order:                                                            # Order of the items in the shop
      type: default                                                   # Type of order (default, grid)
      start_x: 2                                                      # Start X position in the grid order
      start_y: 1                                                      # Start Y position in the grid order
      inc_x: 1                                                        # Increment X position in the grid order
      inc_y: 0                                                        # Increment Y position in the grid order
      max_x: 7                                                        # Max X position in the grid order
      max_y: 4                                                        # Max Y position in the grid order
    close_item:                                                       # Close item configuration
      enabled: true                                                   # Enables the close item
      material: BARRIER                                                 # Close item material
      name: "&cClose"                                                  # Close item name
      lore:                                                           # Close item lore
        - "&7Click here to close the shop"
      slot: 49                                                        # Close item slot in the shop
    refresh_item:                                                     # Refresh item configuration
      enabled: false                                                  # Enables the refresh item
      material: SUNFLOWER                                               # Refresh item material
      name: "&aRefresh"                                                # Refresh item name
      lore:                                                           # Refresh item lore
        - "&7Click here to refresh the shop"
      slot: 45                                                        # Refresh item slot in the shop
    back_item:                                                        # Back item configuration
      enabled: true                                                   # Enables the back item
      material: SPECTRAL_ARROW                                          # Back item material
      name: "&aBack"                                                   # Back item name
      lore:                                                           # Back item lore
        - "&7Click here to go back"
      slot: 48                                                        # Back item slot in the shop
    stock_item:                                                     # Stock item configuration
      enabled: true                                                   # Enables the stock item
      material: RED_STAINED_GLASS_PANE                                # Stock item material
      name: "&aStock"                                                  # Stock item name
      lore:                                                           # Stock item lore
        - "&7Click here to manage the stock"
      slots: [46, 47, 50, 51, 52]                                     # Stock item slots in the shop

  # Confirmation GUI configuration
  confirmation:
    title: "&6Confirmation"                                          # Confirmation GUI title
    size: 27                                                          # Confirmation GUI size (9, 18, 27, 36, 45, 54)
    fill:
      enabled: true
      material: BLACK_STAINED_GLASS_PANE
      name: "&a"
    confirm_item:                                                     # Confirm item configuration
      material: LIME_WOOL                                             # Confirm item material
      name: "&aConfirm"                                                # Confirm item name
      lore:                                                           # Confirm item lore
        - "&7Click here to confirm"
      slot: 11                                                        # Confirm item slot in the confirmation GUI
    cancel_item:                                                      # Cancel item configuration
      material: RED_WOOL                                              # Cancel item material
      name: "&cCancel"                                                 # Cancel item name
      lore:                                                           # Cancel item lore
        - "&7Click here to cancel"
      slot: 15                                                        # Cancel item slot in the confirmation GUI

# Shops Configuration
shops:
  shop:                                              # Shop ID
    display_name: "&aDefault Shop"                   # Shop display name
    items: [ ]                                       # Shop items
    world: world                                     # World where the shop can be opened
    x: 0                                             # X coordinate where the shop can be opened
    y: 0                                             # Y coordinate where the shop can be opened
    z: 0                                             # Z coordinate where the shop can be opened

# Items Configuration
items:
  DIAMOND:                                           # Item ID
    display_name: "&aDiamond"                        # Item display name
    material: DIAMOND                                # Item material
    lore:                                            # Item lore
      - "&7This is a diamond"
      - "%selling_price%"
      - "%buying_price%"
    selling_price: 10                                # Item selling price
    buying_price: 5                                  # Item buying price

🤝 支持

如果你在使用 DailyShop 时遇到任何问题，请访问 GitHub 仓库 寻求帮助。