FAQ & Read Me - start here!

Getting Started with ESGUI:

ESGUI is made up of 4 main files that are fully configurable, and is where everything about the plugin and shop items are stored. Unless you are only using commands to configure your shops, you will need to access your files and know how they work.

1. The Config.yml - this is where you configure How ESGUI should function. Any changes made to this file may require a server restart.

   • More about this file here!

2. The Sections configurations - These configs can be used to configure the shop category(section) items inside the main menu which link to the shop itself.

   • More about these files here!

3. The Shops configurations (most used files, you'll be here alot)- These configs store all item information for every shop item in a specific section.

   • More about these files here!

4. Last, and least used file is the languages file in the LanguageFiles folder.

   • Depending on which one you have configured ESGUI to use in the config.yml, this is where you can make changes to the messages and text lines of ESGUI's interface.

   • More about these files here!

5. You will also need to install a supported economy provider to use EconomyShopGUI.

Dependencies:

1. Economy Plugin - You will need to use an economy plugin, currently the plugin supports the following economy providers listed here.

   1. (Note: You only need one of these plugins for basic usage, but you can use multiple for multiple currencies. Other Vault Based Economy Plugins not listed here may also work with some limitations)

2. Permissions Plugin - A permissions plugin is optional, but recommended. Blocking access to certain shop category's or items requires one, see our guide here on how to use a permissions plugin.

FAQ (Frequently Asked Questions):

It's Broken Questions:

1. ___(this or that)___ doesn't work!

   • Please check Troubleshooting for common issues and how to resolve them!

2. Only OPped players can access the shops:

   • Setup Permissions, and Ensure you have only ONE permissions plugin.

3. Why are all my spawners pig spawners?

   • There is a conflicting plugin or you have misconfigured the plugin. See TS16 here.

4. Why are there Barrier blocks in my shops?

   • There are invalid or misconfigured items in your shops file. See TS15 here.

5. Plugin is disabled or is showing an internal error:

   • Check for missing dependencies or errors in files!

6. Enchantments not keeping their level in an anvil:

   • Non-Vanilla Enchantment levels (unsafe enchants) will be removed by vanilla MC when the item is used in an anvil. We cannot fix this.

General Questions:

1. How/where do I find ESGUI's files? (config.yml, shops, sections, and language files)

   • In General How-To's here!

2. How do I upgrade to premium?

   • In General How-To's here!

3. How do I change the tool(s) for silk-touching a spawner?

   • In the config.yml here!

4. How do I add a shop?

   • Use the ingame edit command

   • Use the config files, this will require to create a sections and shops config with the same name

5. How do I change the plugin's language?

   • In the Config.yml language-file setting

6. How do I change the currency symbol?

   • You can change it to w/e you want inside the language file you are using.

7. How do I setup discounts?

   • In the config.yml

Shops/Item questions:

1. How do I ___(configure items)___ ?

   • change the material of items? - With Command(s) | Editing YML file(s)

   • change the buy or sell price of items? - With Command(s) | Editing YML file(s)

   • change/add/remove the displayname of items? - With Command(s) | Editing YML file(s)

   • change/add/remove the name of items? - With Command(s) | Editing YML file(s)

   • add/remove enchantments to items? - With Command(s) | Editing YML file(s)

   • add/remove potion effects to items? - With Command(s) | Editing YML file(s)

   • add/remove lore to items? - With Command(s) | Editing YML file(s)

   • set the mob of a spawner? - With Command(s) | Editing YML file(s)

   • set the recipe of a knowledge_book? - With Command(s) | Editing YML file(s)

   • set the texture of a player_head? - With Command(s) | Editing YML file(s)

   • add/remove custom items (NBT data)? - With Command(s) | Editing YML file(s) *Premium Feature

   • add/remove commands to/from items? - With Command(s) | Editing YML file(s) *Premium Feature

2. How do I add or remove items from shops?

   • Use the ingame edit command to add/edit/remove items.

   • Use the shops config from the shop category.

3. How do I make an item non-buyable/sellable?

   • Set it's buy or sell price to a negative #. Ex: sell: -1

4. How do I make a Voucher item/Paper Money?

   • In How-To's here

Section/Main Menu Questions:

1. How do I remove or add a section (main menu item/shop)?

   • Use the ingame edit command to add/edit/remove sections.

   • Or: Remove the sections AND shops config.

     • It is important to remove both files, else a example shop will be created.

2. How do I disable a shop without removing it?

   • Disable it in the sections config

3. How do I change ___(this or that)___ of the main menu/sections?

   • Edit the sections config, and /sreload

   • You may also use the /eshop commands to edit shop sections

4. How do I make a hidden shop?

   • In How-To's here

5. How to disable the back button?

   • In config.yml

Permissions Questions:

1. How do I use permissions?

   • Learn how to setup permissions here.

2. What permissions do I need?

   • See Basic Permissions here.

3. Only OPped players can access the shops:

   • Setup Permissions.

Compatibility Questions:

1. What plugins are compatible with ESGUI? - Must be enabled in config.yml to work!

   1. Compatible Silk-Spawner Plugins:

      • See a list of compatible spawner plugins here

   2. Compatible economy plugins:

      1. See a list here

   3. Compatible item plugins: *Premium feature

      1. See a list here

   4. Placeholder support:

      1. See the available placeholders here

   5. Seasonal prices per season

      1. See how to configure seasonal prices here

2. How do I change what can be used to break spawners?

   • Configure it in the config.yml

3. Can I use ESGUI with an eco plugin other than EssentialsX?

   • Yes! You can use any supported Vault plugin or a supported economy plugin listed here.

4. Can I use items as currency(in exchange for items) in the shop?

   • Yes, but this requires the premium version of the plugin where you can setup physical item economys.

Advanced administration questions:

1. Is the source code available? - No.

2. Will the source code ever be available? - No.

3. Can you decompile, modify or make changes the plugin?

   • No.

   • "EconomyShopGUI" aka "ESGUI" is the Intellectual Property (IP) of GP Plugins and may not be modified.

   • Sharing of the plugin is only permitted for the free version. The Premium version is NOT to be shared or otherwise manipulated per the posted Terms Of Service (TOS).

   • You may only use the Premium version on servers YOU OWN.

Upgrading from free to premium

Upgrading your plugin from free to premium is super easy, there are two ways to do this: Either copy all changes manually(not recommended) to the premium version's files or use the import command (recommended).