MiniShop 1.5.2

Another Admin's GUI Shop plugin

  1. KickVN
    Tested Minecraft Versions:
    • 1.8
    Introduction
    I've searched all the GUI shop plugin on spigot but I didn't see any plugin as I want. So I decided to create my own.
    The plugin simply let the you create a GUI shop and players can buy/sell their item in a fast way..

    Feature:
    - Easy to use
    - Easy to config (even with the plain yml file). Of course, we have commands to help you config faster.
    - Categories
    - Click in the GUI to buy and click in the Inventory to sell
    - Buy different amount with different click type
    - Unlimited categories
    - Sell your custom item
    - "Discount" permission

    Screenshot
    [​IMG]
    [​IMG]
    Requirement:
    Vault
    Installation:
    1. Download the plugin and put it in plugins folder
    2. Start your server or load the plugin to let the plugin generate the config. But the plugin can't run now and will cause error.
    3. Restart the server or Reload the plugin so it can read the config after generating.
    4. Edit the config to what you want.
    Commands:
    Command: /minishop,/mshop,/shop,/mn
    /shop
    - Open the GUI
    /shop help - View all MiniShop's command
    /shop reload - Reload the config
    /shop createcategory <name>
    - Create a new category with the item in your hand - same as /shop cc
    /shop additem <category> <buy_price> [sell_price]

    - Add the item in your hand to the category. - same as /shop ai
    /shop createitem <id>

    - Create a custom item with the item in your hand - same as /shop ci
    /shop addcustomitem <category>
    <custom_item_id> <buy_price> [sell_price]

    - Add existed custom item to the category - same as /shop aci
    /shop category <category>
    - Open the shop with that category selected - same as /shop c
    Permissions:

    Code (YAML):

        MiniShop.command.*
    :
            description
    : Gives access to all commands
            children
    :
                MiniShop.command.open
    : true
                MiniShop.command.reload
    : true
                MiniShop.command.createcategory
    : true
                MiniShop.command.additem
    : true
        MiniShop.command.open
    :
            description
    : Allows you to open the GUI.
            default
    : true
        MiniShop.command.reload
    :
            description
    : Allows you to reload the config.
            default
    : op
        MiniShop.command.createcategory
    :
            description
    : Allows you to create a new category.
            children
    :
                MiniShop.command.cc
    : true
            default
    : op
        MiniShop.command.additem
    :
            description
    : Allows you to add a new item to a category.
            children
    :
                MiniShop.command.ai
    : true
            default
    : op
        MiniShop.command.addcustomitem
    :
            description
    : Allows you to add a existed custom item to a category.
            children
    :
                MiniShop.command.aci
    : true
            default
    : op
        MiniShop.command.createitem
    :
            description
    : Allows you to create a custom item.
            children
    :
                MiniShop.command.ci
    : true
            default
    : op
        MiniShop.command.category
    :
            description
    : Allows you to open the shop with that category opened by default.
            children
    :
                MiniShop.command.c
    : true
            default
    : op
        MiniShop.category.*
    :
            description
    : Allows you to use all the categories.
            default
    : op
        MiniShop.category.<category_id>
    : Allows you to see and open that category
        MiniShop.discount.<node>
    : Allows you to get the discount amount in the config.
     
    Configurations:
    Code (YAML):

    #Sell the item that changed name or has lore
    sellSpecialItem
    : false
    #Amount of different mouse types
    amount
    :
      left
    : 1
      right
    : 16
      shift
    : 64
    #Top glasses color. Just change the number, don't remove or put a new line.
    topGlass
    :
    - 3
    - 3
    - 3
    - 3
    - 3
    - 3
    - 3
    - 3
    - 3
    #Bottom glasses color. Just change the number, don't remove or put a new line.
    bottomGlass
    :
    - 4
    - 4
    - 4
    - 4
    - 4
    - 4
    - 4
    #Discount nodes
    #Add as more as you want. Give players the permission MiniShop.discount.<node> to let player have that discount.
    discount
    :
      fifty
    : 50
      total
    : 100
    #The navigation's items
    navigation
    :
      cateNext
    :
        id
    : PAPER
        name
    : "&aNext"
        lore
    :
       - Next categories page
      catePrevious
    :
        id
    : PAPER
        name
    : "&aBack"
        lore
    :
       - Previous categories page
      itemNext
    :
          id
    : PAPER
          name
    : "&aNext"
          lore
    :
         - Next items page
      itemPrevious
    :
          id
    : PAPER
          name
    : "&aBack"
          lore
    :
         - Previous items page
    #Transaction log
    transactionLog
    :
      enable
    : true
      #Expired in days
      expire
    : 7
      #Remove expired log?
      expiredRemove
    : true
    #More lore on the item
    itemMoreLore
    :
    - "&aClick the item in your inventory to sell"
    #messages
    messages
    :
      menuName
    : "&cShop"
      successBuy
    : "Successfully bought {amount} {item} for {money}$"
      successSell
    : "Successfully sold {amount} {item} for {money}$"
      noMoney
    : "&cYou don't have enough {money}$"
      buyLore
    : "&6Buy: {money}$"
      sellLore
    : "&6Sell: {money}$"
      leftClickLore
    : "&aLeft click = Buy {amount}"
      rightClickLore
    : "&bRight click = Buy {amount}"
      shiftClickLore
    : "&cShift click = Buy {amount}"
      specialItem
    : "&cCan not sell this special item"
      cantSell
    : "&cCan not sell this item"
      cantBuy
    : "&cCan not buy this item"
      successReload
    : "&aSuccessfully reloaded"
      onlyPlayer
    : "&cThis command can only be ued by player"
      existCategory
    : "&cCan't create! That category is exist!"
      existCustomItem
    : "&cCan't create! That custom item is exist!"
      successCreateCate
    : "&aSuccessfully created category"
      successCreateItem
    : "&aSuccessfully created item"
      successAddItem
    : "&aSuccessfully added item"
      noPermission
    : "&cYou don't have permission to use this command"
      noCategory
    : "&cNo category found"
      buyLog
    : "[{time}] {player} bought {amount} {item} for {money}$"
      sellLog
    : "[{time}] {player} sold {amount} {item} for {money}$"
     
    Note: This is just an example. So it's really mess. If you have a better config and want to share, you can send it to me. I really appreciate.
    Code (YAML):

    #Name of the category's item
    name
    : "Example Category"
    #Id of the item
    item
    : STONE:2
    #Lore of the category's item
    lore
    :
    - Example category
    #List item to buy/sell
    list
    :
     #The id of the item. Find here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
      DIAMOND_SWORD
    :
     #buy: the cost to buy. 0 mean can't buy
      #sell: the money you'll receive. 0 mean can't sell
        buy
    : 5
        sell
    : 0
      #Can use data number too
      "STONE:2"
    :
        buy
    : 2
        sell
    : 1
      #custom item. this is the id of the item in items folder.
      exampleitem
    :
        buy
    : 2
        sell
    : 1
      DIAMOND_CHESTPLATE
    :
        buy
    : 0
        sell
    : 1
      ACACIA_DOOR_ITEM
    :
        buy
    : 2
        sell
    : 1
      ACACIA_FENCE
    :
        buy
    : 2
        sell
    : 1
      ACACIA_FENCE_GATE
    :
        buy
    : 2
        sell
    : 1
      ACACIA_STAIRS
    :
        buy
    : 2
        sell
    : 1
      ACTIVATOR_RAIL
    :
        buy
    : 2
        sell
    : 1
      ENDER_PEARL
    :
        buy
    : 2
        sell
    : 1
      ANVIL
    :
        buy
    : 2
        sell
    : 1
      APPLE
    :
        buy
    : 2
        sell
    : 1
      ARMOR_STAND
    :
        buy
    : 2
        sell
    : 1
      ARROW
    :
        buy
    : 2
        sell
    : 1
      BAKED_POTATO
    :
        buy
    : 2
        sell
    : 1
      BANNER
    :
        buy
    : 2
        sell
    : 1
      BEACON
    :
        buy
    : 2
        sell
    : 1
      BED
    :
        buy
    : 2
        sell
    : 1
      GOLD_AXE
    :
        buy
    : 2
        sell
    : 1
      BEDROCK
    :
        buy
    : 2
        sell
    : 1
      BLAZE_ROD
    :
        buy
    : 2
        sell
    : 1
      BOAT
    :
        buy
    : 2
        sell
    : 1
      BONE
    :
        buy
    : 2
        sell
    : 1
      EMERALD_BLOCK
    :
        buy
    : 2
        sell
    : 1
      CACTUS
    :
        buy
    : 2
        sell
    : 1
      GOLD_ORE
    :
        buy
    : 2
        sell
    : 1
      FENCE
    :
        buy
    : 2
        sell
    : 1
      CHEST
    :
        buy
    : 2
        sell
    : 1
      COOKED_FISH
    :
        buy
    : 2
        sell
    : 1
      DIAMOND_AXE
    :
        buy
    : 2
        sell
    : 1
      DIAMOND_HOE
    :
        buy
    : 2
        sell
    : 1
      DIAMOND_PICKAXE
    :
        buy
    : 2
        sell
    : 1
     
    Code (YAML):

    name
    : "Example custom item"
    id
    : DIAMOND_SWORD
    lore
    :
    - A lore
    - Another lore
    #Enchantment id: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html
    #Struct: <enchantment_id> <level>
    enchantment
    :
    - DAMAGE_ALL 1
    - LUCK 1
     
    How to create a new category
    You'll see a categories folder in the plugin's folder. All categories is in here.
    To create a new one, you just have to create a new .yml file and follow the struct of the example.
    Another way is use /shop cc. Hold an item in hand and use this command to create a new category. Then the name,lores and item id of this item will be in the category.
    How to add item to the category
    You can edit the category's .yml file. It's really easy. Just take a look at the example category and you'll know.
    And same as category, you can use /shop ai to add the item to the category.
    How to create a custom item and add it to shop
    You just have to create a .yml file inside items folder. The name of the file will be the id of the item. And then you can take a look at the exampleitem.yml to know the struct.
    Another simple way is use the command /shop createitem <id> to create a custom item according to the item in your hand.
    To add the custom item to the shop, you can put the id of the item (name of the file) in the category's config just like the material id. Or you can use the command /shop addcustomitem <category_id> <custom_item_id> <buy> [sell]

    Feel free to tell me if you have something to discuss.

Recent Updates

  1. 1.5.2
  2. 1.5.1
  3. 1.5

Recent Reviews

  1. Warfield
    Warfield
    5/5,
    Version: 1.5.1
    Hi,

    When will the new update please Version 1.10
    Nice plugin
    Good jobs man

    I love you <3

    By Below_Zero
  2. Kevotas2
    Kevotas2
    5/5,
    Version: 1.5.1
    very good project, but you can put: if the inventory is full it does not get buy please.............
  3. HenrikoMagnifico
    HenrikoMagnifico
    5/5,
    Version: 1.4
    Absolutely OUTSTANDING plugin! The best shop plugin out there, guaranteed! I don't have much negative to say, but if you want some criticism, a way to set up player shops with this would be be wondrous! A way to set up shops like in ShopGUI+ would be best (but free, since that is a paid resource and is very expensive!) Thanks for your great work. ~Henriko
    1. KickVN
      Author's Response
      Thanks for the review.
      But I don't know what the way to set up like in ShopGUI+ is. Can you explain more?
  4. NoHoPeLess
    NoHoPeLess
    5/5,
    Version: 1.2
    Best adminshop plugin out there! Thank you so much for this amazing FREE plugin thats works like a charm!
    1. KickVN
  5. wangzixing
    wangzixing
    5/5,
    Version: 1.2
    the best admin's shop
    If can support playerpoints. It's perfect
    For example .Set the createitem is Vault or points
    1. KickVN
      Author's Response
      Thanks for the review. I'll think about it.