SpigotVIP ShopGUI+ 1.20.2

1. Why do I 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

2. 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.

3. 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

4. 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.

5. 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

6. 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

7. 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.

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

9. 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

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

11. 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

12. 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

13. 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

14. 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

15. 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

16. 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

17. 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

18. 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

19. 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

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

21. 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

22. 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

23. 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.

24. 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

25. 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

26. 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.

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