# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.gpplugins.com/economyshopgui/basics/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.