> For the complete documentation index, see [llms.txt](https://wiki.gpplugins.com/economyshopgui/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.gpplugins.com/economyshopgui/basics/faq.md).

# FAQ & Read Me - start here!

## Getting Started with ESGUI: <a href="#getting-started" id="getting-started"></a>

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](/economyshopgui/basics/commands.md#editshop) to configure your shops, you will need to access your files and know how they work.

1. The [Config.yml](/economyshopgui/file-configuration/config.yml.md) - 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!](/economyshopgui/file-configuration/config.yml.md)
2. The [Sections ](/economyshopgui/file-configuration/sections.yml.md)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!](/economyshopgui/file-configuration/sections.yml.md)
3. The [Shops](/economyshopgui/file-configuration/shops.yml.md) 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!](/economyshopgui/file-configuration/shops.yml.md)
4. Last, and least used file is the [languages file](/economyshopgui/file-configuration/languages.md) in the `LanguageFiles` folder.&#x20;
   * Depending on which one you have configured ESGUI to use in the [config.yml](/economyshopgui/file-configuration/config.yml.md#language-option), this is where you can make changes to the messages and text lines of ESGUI's interface.
   * [More about these files here!](/economyshopgui/file-configuration/languages.md)
5. You will also need to install [a supported economy provider](/economyshopgui/file-configuration/config.yml.md#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](/economyshopgui/basics/permission.md#setup-permissions).

## FAQ (Frequently Asked Questions):

### It's Broken Questions:

1. \_\_\_(this or that)*\_\_\_* doesn't work!&#x20;
   * Please check [Troubleshooting](/economyshopgui/basics/troubleshooting.md) for common issues and how to resolve them!
2. Only OPped players can access the shops:
   * [Setup Permissions](/economyshopgui/basics/permission.md#basic-permissions), and Ensure you have only ONE [permissions plugin](/economyshopgui/basics/permission.md#installing-a-permission-plugin).
3. Why are all my spawners pig spawners?
   * There is a [conflicting plugin or you have misconfigured the plugin. See TS16 here](/economyshopgui/basics/troubleshooting.md#ts-16-pig-spawners).
4. Why are there Barrier blocks in my shops?
   * [There are invalid or misconfigured items in your shops file. See TS15 here.](/economyshopgui/basics/troubleshooting.md#ts-15-you-have-barrier-blocks-in-your-shop)
5. Plugin is disabled or is showing an internal error:
   * [Check for missing dependencies or errors in files](/economyshopgui/basics/troubleshooting.md#ts-14-plugin-is-disabled-errors)!
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](/economyshopgui/file-configuration/config.yml.md), [shops](/economyshopgui/file-configuration/shops.yml.md), [sections](/economyshopgui/file-configuration/sections.yml.md), and [language](/economyshopgui/file-configuration/languages.md) files)
   * In [General How-To's here!](/economyshopgui/basics/how-to.md#plugin-files)
2. How do I upgrade to premium?
   * In [General How-To's here!](/economyshopgui/basics/how-to.md#upgrade-to-premium)
3. How do I change the tool(s) for silk-touching a spawner?
   * In the [config.yml here!](/economyshopgui/file-configuration/config.yml.md#spawner-break-materials)
4. How do I add a shop?
   * Use the ingame edit command
   * Use the config files, this will require to create a [sections ](/economyshopgui/file-configuration/sections.yml.md)and [shops ](/economyshopgui/file-configuration/shops.yml.md)config with the same name
5. How do I change the plugin's language?
   * In the [Config.yml](/economyshopgui/file-configuration/config.yml.md#language-option) language-file setting
6. How do I change the currency symbol?
   * You can change it to w/e you want inside the [language file ](/economyshopgui/file-configuration/languages.md#language-file-example)you are using.
7. How do I setup discounts?
   * In the [config.yml](/economyshopgui/file-configuration/config.yml.md#discounts)

### Shops/Item questions:

1. How do I \_\_\_(configure items)\_\_\_ ?
   * change the **material** of items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#material)
   * change the **buy** or **sell** price of items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#buy)
   * change/add/remove the **displayname** of items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#display-name)
   * change/add/remove the **name** of items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#name)
   * add/remove **enchantments** to items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#enchantments)
   * add/remove **potion effects** to items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#potion-types)
   * add/remove **lore** to items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#lore)
   * set the **mob of a spawner**? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#spawner-type)
   * set the **recipe of a knowledge\_book**? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#recipe)
   * set the **texture of a player\_head**? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#skull-owner)
   * add/remove **custom items (NBT data)**? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#nbt-data) *<mark style="color:yellow;">\*Premium Feature</mark>*
   * add/remove **commands** to/from items? - [With Command(s)](/economyshopgui/basics/commands.md) | [Editing YML file(s)](/economyshopgui/file-configuration/shops.yml.md#commands) *<mark style="color:yellow;">\*Premium Feature</mark>*
2. How do I add or remove items from shops?
   * Use the ingame [edit](/economyshopgui/basics/commands.md#editshop) command to add/edit/remove items.
   * Use the [shops ](/economyshopgui/file-configuration/shops.yml.md)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](/economyshopgui/basics/how-to.md#how-to-store-share-money-as-an-item)

### 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](/economyshopgui/file-configuration/sections.yml.md) **AND** [shops ](/economyshopgui/file-configuration/shops.yml.md)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 ](/economyshopgui/file-configuration/sections.yml.md)config
3. How do I change \_\_\_(this or that)*\_\_\_* of the main menu/sections?
   * Edit the [sections](/economyshopgui/file-configuration/sections.yml.md) 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](/economyshopgui/basics/how-to.md#how-to-make-a-hidden-shop-workaround)
5. How to disable the back button?
   * [In config.yml](/economyshopgui/file-configuration/config.yml.md#disable-back-button)

### Permissions Questions:

1. How do I use permissions?
   * &#x20;[Learn how to setup permissions here](/economyshopgui/basics/permission.md#setup-permissions).
2. What permissions do I need?
   * [See Basic Permissions here](/economyshopgui/basics/permission.md#basic-permissions).
3. Only OPped players can access the shops:
   * [Setup Permissions](/economyshopgui/basics/permission.md#basic-permissions).

### Compatibility Questions:

1. What plugins are compatible with ESGUI? *- Must be enabled in* [*config.yml*](/economyshopgui/file-configuration/config.yml.md#silkspawners-compatibility) *to work!*
   1. Compatible Silk-Spawner Plugins:
      * [*See a list of compatible spawner plugins here*](/economyshopgui/file-configuration/config.yml.md#spawner-provider)
   2. Compatible economy plugins:
      1. See a list [here](/economyshopgui/file-configuration/config.yml.md#economy-provider)
   3. Compatible item plugins: *<mark style="color:yellow;">\*Premium feature</mark>*
      1. See a list [here](/economyshopgui/file-configuration/shops.yml.md#material)
   4. Placeholder support:
      1. See the available placeholders [here](/economyshopgui/basics/how-to.md#using-the-placeholderapi-expansion)
   5. Seasonal prices per season
      1. See how to configure seasonal prices [here](/economyshopgui/file-configuration/config.yml.md#seasonal-pricing)
2. How do I change what can be used to break spawners?
   * [Configure it in the config.yml](/economyshopgui/file-configuration/config.yml.md#spawner-break-materials)
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](/economyshopgui/file-configuration/config.yml.md#economy-provider).
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](/economyshopgui/basics/how-to.md#how-to-create-custom-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?&#x20;
   * **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).&#x20;
   * 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).](/economyshopgui/basics/how-to.md#upgrade-to-premium)