Information

Features

• Unlimited Categories

• Unlimited Items

• Stock System per Item

• Purchase Limit per Item

• Fully Customizable menus

• PlaceholderAPI Support

• HEX Color Support

---

Commands

• /expshop - Open the Main EXP Shop Category, a category that has default: true will be the one opened.

• /expshop reload - Reloads the whole plugin - Permission: rivalexpshop.reload

• /expshop setstock {categoryID} {itemID} {stockNumber} - Modify current stock of specific item - Permission: rivalexpshop.admin

• /expshop setlimit {playerName} {categoryID} {itemID} {limitNumber} - Modify current limit of specific item for a specific player - Permission: rivalexpshop.admin

---

Placeholders

• %rivalexpshop_exp% - Shows raw exp amount

• %rivalexpshop_exp_formatted_decimal% - Shows exp amount with decimal points

• %rivalexpshop_exp_formatted_normal% - Shows exp amount formatted as 1k, 1M, 1B etc

---

Dated Categories

You have the capability to set a predetermined date for unlocking categories.

Date Format: yyyy-MM-dd h:mm:ss a

Example:

Under options: add

In item lore you can use the {time} and {until} placeholders to display the time till the category gets unlocked

---

pages:
  examplecategory:
    options:
      size: 27
      title: '&8Experience Shop'
      opening-date: 2023-08-31 12:59:00 AM # Date when the shop will be open to players
      filler:
        material: BLACK_STAINED_GLASS_PANE

---

Rotating Shops

Within all categories, you have the option to cycle items, allowing for a dynamic display. Additionally, you can mix both standard and rotating items within a single category.

Example:

Under options: add

In item lore you can use the {next-update} placeholder to display the time till next rotation of the category

For a item to become a rotating item it needs a chance: part added in the items settings under it's price:

pages:
  examplecategory:
    options:
      size: 27
      title: '&8Experience Shop'
      filler:
        material: BLACK_STAINED_GLASS_PANE
      rotating:
        enabled: true
        interval: 43200 # Interval in seconds
        slots: [12,13,14] # Slots in which rotating items will be displayed in
        message: # Sends a message whenever the shop updates, remove the message: and it wont be sent
          - '&8[&e&lEXP SHOP&8]&f The &eExperience Shop&f has now been updated! &6/xpshop'

---

Stock System

This system enables you to establish and maintain a stock of various items, granting you the ability to set specific quantity limits for individual items.

pages:
  examplecategory:
    options:
      size: 27
      title: '&8Experience Shop'
      filler:
        material: BLACK_STAINED_GLASS_PANE
  items:
      '1':
        material: LIME_DYE
        amount: 1
        name: '&2&l[!] &a&lVote Crate Key'
        lore:
          - ''
          - ' &3&l* &bPrice: &f{price} EXP'
          - ' &3&l* &bCurrent Stock: &f{current-stock}' # Display amount of items that can be bough
          - ' &3&l* &bMax Stock: &f{max-stock}' # Displays the max amount that can be bought
          - ''
          - '&7&o(( Click here to purchase ))'
        commands:
          use: true
          commands:
            - crate give p Vote 1 {player}
        stock: 
          use: true
          amount: 5
        price: 100
        slot: 1

---

Limit System

This system empowers you to create and manage an inventory of diverse items, affording you the option to impose particular purchase limits for individual items, thereby controlling the quantity a player can acquire.

pages:
  examplecategory:
    options:
      size: 27
      title: '&8Experience Shop'
      filler:
        material: BLACK_STAINED_GLASS_PANE
  items:
      '1':
        material: LIME_DYE
        amount: 1
        name: '&2&l[!] &a&lVote Crate Key'
        lore:
          - ''
          - ' &3&l* &bPrice: &f{price} EXP'
          - ' &3&l* &bAmount Purchased: &f{current-limit}' # Displays amount the player has purchased
          - ' &3&l* &bMax Limit: &f{max-limit}' # Displays the max amount the player can purchase
          - ''
          - '&7&o(( Click here to purchase ))'
        commands:
          use: true
          commands:
            - crate give p Vote 1 {player}
        limit: 
          use: true
          amount: 10
        price: 100
        slot: 1