# EconomyShopGUI - Overview

## What is EconomyShopGUI(ESGUI) and what can it do?

This plugin is a fully customizable GUI shop plugin that your players can use to buy items from, and sell items to the server. \
There are numerous features and configuration options in the plugin, such as a DiscordSRV hook, discounts/multipliers, player transaction logs, seasonal pricing, multiple supported economy's, ...\
The best part being is that it is possible to add/edit/remove shop items/category's using ingame commands, no configs files required, nor server restarts to edit the shop!

### **Key features:**

* Add/edit/delete items and shop category's with [in-game commands](https://wiki.gpplugins.com/economyshopgui/basics/commands#commands), no config files needed!
* Add as many shop [category's ](https://wiki.gpplugins.com/economyshopgui/file-configuration/sections.yml)as you like. Example: Blocks, Redstone, Potions, Food, Mob Drops, etc...
* Support for [sub sections](https://wiki.gpplugins.com/economyshopgui/file-configuration/sections.yml#sub-shops)
* Add unlimited items to the [shops](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml)
* Browse and install premade shop layouts from our [Marketplace](https://layouts.gpplugins.com/)
* Add [discounts ](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#discounts-1)and/or sell [multipliers ](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#sell-multipliers)using permissions.
* [Seasonal pricing](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#seasonal-pricing) per item or per shop
* Use multiple currencies at the same time using [per section ](https://wiki.gpplugins.com/economyshopgui/file-configuration/sections.yml#specific-currency)or [per item](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#economy) currencies.
* [DiscordSRV hook](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#discordsrv-hook) to log shop transactions to a discord channel.
* Add different [goat horns](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#instrument), [enchantments](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#enchantments), [potion effects](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#potion-types), [spawner types](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#spawner-type), [knowledge books](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#recipe), [player heads](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#skull-owner), [stew effects](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#stew-effect), [armor trims](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#armor-trim), [ominous bottles](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#ominous-strength), [fireworks](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#duration-colors-fade-colors-flicker-trail-shape-required-specific-item-firework), [leather armor with RGB colors](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#armor-color-required-specific-item-any-leather-armor-piece), ... and many more item types
* Bedrock players [support ](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#bedrock)thru GeyserMC/Floodgate
* Support for 3rd party spawners from 10+ directly [supported spawner plugins](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#spawner-provider).
* Customize the look of the shop by changing the [option items](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#option-items)/[navigation bars](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#navigation-bars) or with [fill items](https://wiki.gpplugins.com/economyshopgui/file-configuration/sections.yml#mainshop-fill-item)
* [Placeholder expansion](https://wiki.gpplugins.com/economyshopgui/basics/permission#basic-permissions-1) with custom placeholders totalling at 100+ placeholder combinations.
* [Multiple language](https://wiki.gpplugins.com/economyshopgui/file-configuration/languages#currently-supported-languages) support
* Set a list of [banned gamemodes](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#banned-gamemodes)
* Specific click actions for [different click type](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#click-mappings)s per shop
* Support for [NPC Shops](https://wiki.gpplugins.com/economyshopgui/basics/how-to#how-to-make-an-npc-shop)
* Support for [physical shops](https://wiki.gpplugins.com/economyshopgui/basics/how-to#how-to-use-shopstands) in your world
* Support of Minecraft versions 1.8.x - 1.21.x with default shop files for each version
* [Discord](https://discord.com/invite/nPyuB4F) support server
* Multiple [economy providers](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#economy-provider) supported
* [Transaction log file](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#transactions) to keep track of your economy
* Execute [commands](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#commands) when players purchase/sell items *<mark style="color:yellow;">\*Premium Only</mark>*
* Add custom items with [Component](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#components)/[NBT data](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#nbt-data) to shops *<mark style="color:yellow;">\*Premium Only</mark>*
* Specific item economy's, specify a [per item economy/currency](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#economy) *<mark style="color:yellow;">\*Premium Only</mark>*
* Support for custom [item economy](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#economy-provider)'s, puchase/sell shop items for ingame items *<mark style="color:yellow;">\*Premium Only</mark>*
* Multiple [buy](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#buy-prices) and [sell](https://wiki.gpplugins.com/economyshopgui/file-configuration/shops.yml#sell-prices) prices support for items to add different ways to buy/sell the item *<mark style="color:yellow;">\*Premium Only</mark>*
* [Limit the amount of items](https://wiki.gpplugins.com/economyshopgui/basics/limited-items) for each player or globally *<mark style="color:yellow;">\*Premium Only</mark>*
* [Dynamic](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#dynamic-pricing)[Pricing](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#dynamic-pricing) which allows different item prices according supply and demand *<mark style="color:yellow;">\*Premium Only</mark>*
* Full <mark style="color:blue;">PlaceholderAPI</mark> support inside item names/lore, aswell as shop tiles/navigation bar items *<mark style="color:yellow;">\*Premium Only</mark>*
* Direct support for item enchantments from <mark style="color:blue;">EcoEnchants</mark>, <mark style="color:blue;">AdvancedEnchantments</mark>, <mark style="color:blue;">ExcellentEnchants</mark> and [CrazyEnchantments ](https://www.spigotmc.org/resources/crazy-enchantments.16470/)*<mark style="color:yellow;">\*Premium Only</mark>*
* [MySQL](https://wiki.gpplugins.com/economyshopgui/file-configuration/config.yml#mysql) support to sync limited stock or DynamicPricing between multple servers *<mark style="color:yellow;">\*Premium Only</mark>*

## Shops Examples: <a href="#shops-images" id="shops-images"></a>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx-X8mi6dLha8lw5vs%2FMain%20Menu%20(Premium).png?alt=media&#x26;token=9702c73b-1c62-463a-9d0a-8d1f37b89193" alt="Default Main Menu (files in the /sections/ folder)(*Top row items are Premium only section examples)"></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx0pm1Lr6k1NVfuMD4%2FBlocks.png?alt=media&#x26;token=ff2dcd6a-e8d1-4478-af45-45d94b0f6a88" alt="Default Blocks Page1 (files in the /shops/ folder)(*Shift+Click to edit item only available in Premium version)"></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx-qGlyRVQyvGSGzip%2FOres.png?alt=media&#x26;token=c3ed89ac-cfbc-48b7-8375-13bfd42e759b" alt=""></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx-xT84kAP2V7eFg_B%2FOthers.png?alt=media&#x26;token=19a50f1d-8701-45ce-905d-7b717c999d48" alt=""></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx00jS-FQZPd5sPd8r%2FPotions%20and%20Tipped%20Arrows.png?alt=media&#x26;token=a979fea6-217c-4d56-a891-740282575590" alt=""></div>

### In-Game Item Editor - \*Premium Only: <a href="#in-game-item-editor" id="in-game-item-editor"></a>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx0VS4XlNGInlWNymN%2FItemEditor-Main.PNG?alt=media&#x26;token=1da92169-1825-4874-91cd-5306cd215c47" alt="Item Editor Main menu"></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MjZq82V_aqVRHEs8D_L%2F-Mj_BdSUT9sCbeeR_-YJ%2FSchermafbeelding%202021-09-14%20183819.png?alt=media&#x26;token=67d71c95-b6a4-44f4-a43b-bc62efd66126" alt="Item editor options"></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx0fSOtNuxrsuU60uv%2FCommands%20(Premium).png?alt=media&#x26;token=b88c36f3-07e1-458d-b08d-1a2308d92ffe" alt="Example item with command assigned to it"></div>

<div align="left"><img src="https://4049796578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6QXvrDDroId1RhlXgl%2F-MXwZ58BwTdom3uGj_83%2F-MXx0jJ0ioOvt9pEc5HC%2FNBT%20Items%20(Premium).png?alt=media&#x26;token=0bce9047-4f29-408e-aa54-abb8bbdfe0a6" alt="Custom item with NBT data tag(s)"></div>

## Where to get it:&#x20;

#### Free Version:

* [GPPlugins](https://gpplugins.com/plugin/economyshopgui)
* [SpigotMC](https://www.spigotmc.org/resources/economyshopgui.69927/)&#x20;
* [BukkitDev](https://dev.bukkit.org/projects/economyshopgui) (24hr delay when new version released)
* [Polymart](https://polymart.org/resource/456)

#### Premium Version:

* [GPPlugins](https://wiki.gpplugins.com/economyshopgui/broken-reference)
* [SpigotMC](https://www.spigotmc.org/resources/economyshopgui-premium.104414/)
* [Polymart](https://polymart.org/resource/economyshopgui-premium.908)

## Plugin showcase videos:

* English by SoulStriker: <https://www.youtube.com/watch?v=zhDAtuROTfk>
* Dutch by BelgiumGames: <https://www.youtube.com/watch?v=G6CBSwxBJGE>
* German by Produktecheck: (Outdated) <https://www.youtube.com/watch?v=a-Y_-bJ58Kg>
* Spanish by Ajneb97: <https://www.youtube.com/watch?v=U7-raDmZXj4>

If you want to create a video on how to use this plugin and feature it here, be sure to send us a message on [Discord](https://discord.com/invite/nPyuB4F)!

## \*Notes:

* *\*1*: Max items IS unlimited, However, adding an outrageous number of items may have adverse effects on plugin or server performance. (we have not observed this being an issue yet)
* *\*2*: Vanilla Mobs only. ESGUI does NOT change any mob spawning behavior, it only changes the mobtype of the spawner when placed.
* *\*Premium Only*: Premium version has additional features not available in the free version. Please upgrade and support the developers if you need those extra features! The Free version will always support vanilla functionality and compatibility.
