[PLUGIN] ShopGUI+ [1.7-1.14]

etc

1. How do you add more pages?
Adding a new page is as simple as adding a "page: x" entry where x is the page number. When there's at least 1 item on a page it will be automatically added to the gui. Slot numbers start from 0 for every page.
Example: http://pastebin.com/xjpWWUBf

2. I'm getting a white /shop [reload] message or Shop with id blocks not found every time I try to access the shop
It means the plugin didn't load up correctly. Please check your server startup log for errors. It's located in the /logs/latest.log file or the server console. You can PM me the log if you need help.

3. I'm getting an "ERROR Could not pass event InventoryClickEvent to ShopGUIPlus v1.5.3" error after updating to 1.5.0 or later
Most likely you haven't updated your config.yml when updating to the latest version of the plugin. You have to either update it according to this and this update notes or delete your config.yml so the plugin will generate a new up-to-date one.

4. How do you make it so bought commands are executed by the player instead the console?
Simply add the runAsBuyer: true entry to your command item in shops.yml.
Example: http://pastebin.com/aUqvg651

5. Why do you have to use these weird material names instead of IDs?
You can use numeric IDs as well, just make sure you enter only the ID without any data value (it has to be set in a separate entry) like that:
http://pastebin.com/YZvX1Eyi

6. I can't find an item on the materials list, what do I do?
Some of the items have different material name than that one you know from the game and some require changing the data value (damage value) of the item. Please look for such items here.

7. My players receive stacked weapons/armor/potions, how can I fix it?
You can make multiple weapons/armor/potions unstack by adding unstack: true entry to the item.
Example: http://pastebin.com/tJEmxW0g

8. I'm getting an ArrayOutOfBounds error, how can I fix it?
Make sure you don't have any button (like back, next page, previous page buttons) on a slot higher than the size of the shop inventory.

9. I'd like to change the size of one of my shops, how can I do that?
You can change the size of any of shop inventories in shops.yml. Simply add a "size: x" entry where x is the desired size (it has to be either 9, 18, 27, 36, 45 or 54). Example: http://pastebin.com/TtNtRtTh
More information: http://wiki.brcdev.net/ShopGUIPlus/Installation_&_configuration#Changing_sizes.2Fbuttons_of_shops

10. I'd like to display one item in the shop but actually sell another one, how can I do that?
You can set another item as a placeholder in order to sell a different item (even with a different lore or name) by adding additional a "placeholder" entry below specific item in shops.yml. Example: http://pastebin.com/bWU5Vygu

11. I'd like to make the buying/selling process faster, what can I do?
You can enable quickBuySell in your config.yml. This will result in the amount selection GUI not being closed after buying an item.

12. How do you edit the amount selection GUI buttons/slots?
Please refer to http://wiki.brcdev.net/ShopGUIPlus/Installation_&_configuration#Amount_selection_GUI_customization.

13. How do you use the per-item permissions?
It's explained here: http://wiki.brcdev.net/ShopGUIPlus/Installation_&_configuration#Using_per_item_permissions

14. How do you disable direct access to a shop (using the GUI or /shop <name>) so it can be accessed only by having it open from the console/by another plugin?
Simply add the denyDirectAccess: true entry to the shop in shops.yml. Then the only way for players to access the shop will be to have the /shop <player name> <shop name> executed by
the console/another player/plugin.
Example: http://pastebin.com/Gkerd04V

15. How do you remove custom name/lore from the item bought by players?
You can remove it by adding stripItemMeta: true entry to the item.
Example: http://pastebin.com/GLrDv9S3

16. How do you change the maximal item stack size (regardless of global settings from config.yml)?
Simply add a maxStackSize entry to desired item in shops.yml.
Example: http://pastebin.com/PF3W6M8s

17. How do you sell multiple permissions?
Simply add a permissions list to the shop item and list there all permissions. You can add the force flag if you want to allow players to buy the entire set of permissions even if they already have one or more of them (they won't be able to buy if they have all of them though).
Example: http://pastebin.com/nrzEz0Zz

18. How do you edit the format of displayed price?
(1.3.3 version and above only) You can add following settings at the bottom of your config.yml and edit them as you wish: http://pastebin.com/69RX1hpB

19. How do you edit the receipt message sent after buying/selling an item?
(1.3.4 version and above only) You can define the custom messages at the bottom of the shop item (messageBuy, messageSell, messageSellAll). Same placeholders apply as in the default messages from lang.yml.
Example: http://pastebin.com/98XSJrs0

20. How do you limit the item stack size players are able to enchant at once?
(1.3.5 version and above only) Simply add an entry named enchantmentStackSizeLimit with the value of the limit.
Example: http://pastebin.com/tvdqTYfJ

21. How do you set a different name of each page of the shop?
(1.3.7 version and above only) Add an entry named namePerPage below name. You can set as many names as you wish (the format is PAGE: NAME)
Example: http://pastebin.com/Zmdc03My

22. How do you sell spawners?
It's explained here (it requires SilkSpawners/PickUpSpawners/EpicSpawners/SpawnerSilk): http://wiki.brcdev.net/ShopGUIPlus/Installation_&_configuration#Mob_spawners

23. How do you disallow selling items with name/lore different from the shop item's ones?
Simply add a "compareMeta: true" setting to your shop item in shops.yml.
Example: http://pastebin.com/DsVWWC4h

24. How do you change the /shop command?
You can't completely change it, you can only add aliases using the spigot's built-in commands.yml file (you can find in the root directory of your server).
Example: http://pastebin.com/LvqrGVg3

25. How do you add "Owned"/"Not owned" tag to permission shop items?
Simply add %owned% placeholder to shopItemLoreFormat -> permission in config.yml. It will be replaced with an appropriate tag.
Example: http://pastebin.com/ubDZh7zB

27. How do you hide only one of the "Owned"/"Not owned" tags from permission shop items?
If you want to have only one of them displayed simply set the other one to blank in lang.yml. The example below shows how to have only the "Owned" tag displayed.
Example: http://pastebin.com/QieD3NLb

27. How do you set up the plugin to use Gringotts currency?
The plugin uses the main economy on your server, make sure it's Gringotts. Note: You need Vault as well.

28. How do you set up the price modifiers?
It's explained at the wiki: http://wiki.brcdev.net/ShopGUIPlus/Price_modifiers

29. How do you add an alias /sellhand for /sell hand (with no space inbetween)?
You can add it in commands.yml in the root folder of your server like that: https://pastebin.com/B7Rh15tt

30. How do you enable compareMeta and/or stripItemMeta globally for all items?
Add the following section to your config.yml and adjust it to your needs: https://pastebin.com/MexHAhkX

31. How do you make /sell hand sell all items of the type from the inventory instead of the single one being held in the hand?
Set sellsAllItems to true in the sellHand section in config.yml.

32. How do you allow/block access to particular shop in particular worlds?
You can add either worldsWhitelist (to whitelist allowed worlds) or worldsBlacklist (to blacklist blocked worlds) entry to the shop in shops.yml.
Example #1 (this will allow access in world_nether only):
https://pastebin.com/Lk0p5yZH
Example #2 (this will allow access in any world except world_nether):
https://pastebin.com/SULMAUSW

33. How do you fill shop and/or main menu with certain item, eg. a glass pane?
Main menu - set the item in shopMenuFillItem section in config.yml, example: https://pastebin.com/Y5zV2p4M
Shop menu - set the item in fillItem in each shops section in shops.yml, example: https://pastebin.com/kjQAg3xS

34. How do you require players to have certain permissions before they are able to purchase the item?
You can add requiredPermissions list to an item in shops.yml.
Example: https://pastebin.com/zh21u74e

35. How do you add an item just for decoration of the shop of no other purpose?
You can add item with type DUMMY (since 1.18.2 version of the plugin). Such items can't be bought or sold, they can be used for commands on click though.
Example: https://pastebin.com/2yQyfAJP

36. How do you execute commands when player clicks/buys/sells an item?
For commands executed by the player you can add any of following to an item: commandsOnClick, commandsOnBuy, commandsOnSell
For commands executed by the server console you can use: commandsOnClickConsole, commandsOnBuyConsole, commandsOnSellConsole
OnClick gets executed when a player clicks an item in the shop menu (can be used for linking to other shops/plugins)
OnBuy/OnSell get executed after a player buys/sells the item
Example: https://pastebin.com/2q6yBMmG

37. How to add commands on item click to the main /shop menu?
You can use both commandsOnClick and commandsOnClickConsole described above in the main menu as well. You can use it both for an item actually opening a shop or a placeholder item with type DUMMY.
Example: https://pastebin.com/hiMhzvDs

38. How do you add custom economy plugin support?
You can use the EconomyProvider (see section API above for link) to implement your own economy handler. Then you need to use the ShopGuiPlusApi#registerEconomyProvider method to register it and set the economyType in config.yml to CUSTOM.

39. How do you change the click cooldown inside GUIs?
You can change it by adding a clickCooldown entry to gui section in config.yml. The value is click cooldown in milliseconds (250 ms is default).
Example: https://pastebin.com/EvX9MDaG