Permissions:
Learn which permissions EconomyShopGUI uses and what they mean.
Permission nodes:
These permissions define whether a player is able to buy/sell items to a specific shop section, the core permissions of EconomyShopGUI.
EconomyShopGUI.shop.<section>
TRUE
Gives access to buy/sell items in a specific shop section using the /shop GUI.
EconomyShopGUI.shop.all
TRUE
Gives permission to open all shop sections and buy/sell items
EconomyShopGUI.sellall.<section>
TRUE
Gives access to sell items in a specific shop section using the /sellall inventory
command.
EconomyShopGUI.sellall.all
TRUE
Allows players to sell items using the /sellall inventory
command to all shop sections
EconomyShopGUI.sellallitem.<section>
TRUE
This permission allows players to sell items using the /sellall <item>
in specific shop sections
EconomyShopGUI.sellallitem.all
TRUE
Allows players to sell items to all shop sections using the /sellall <item>
command
EconomyShopGUI.sellallhand.<section>
TRUE
Allows players to sell in a specific shop section with the /sellall hand
command
EconomyShopGUI.sellallhand.all
TRUE
Allows players to sell items using /sellall hand
to all shop sections
EconomyShopGUI.sellgui.<section>
TRUE
Allows players to sell items using the /sellgui
command in specific sections
EconomyShopGUI.sellgui.all
TRUE
Allows players to sell items to all shop sections using /sellgui
Per item permissions *Premium only
EconomyShopGUI.shop.<section>.item.<permission>
FALSE
A per item permission which allows you to buy/sell this specific item in the specific shop.
EconomyShopGUI.sellall.<section>.item.<permission>
FALSE
A per item permission which allows you to buy/sell this specific item using the /sellall
command
EconomyShopGUI.sellallitem.<section>.item.<permission>
FALSE
A per item permission which allows you to buy/sell this specific item using the /sellall item
command
EconomyShopGUI.sellallhand.<section>.item.<permission>
FALSE
A per item permission which allows you to buy/sell this specific item using the /sellall hand
command
EconomyShopGUI.sellgui.<section>.item.<permission>
FALSE
em permission which allows you to buy/sell this specific item using the /sellgui
command
How to setup and assign permissions:
Installing a permission plugin:
Installing a permissions plugin is that easy as dragging and dropping the file inside your server plugin's folder.
Download the plugin.
Drop the file inside your plugins folder
Restart the server.
Note: DO NOT install multiple permissions plugins. they will all fight with each other and cause you unending headaches. :/
Configuration:
Basic permissions you will need to assign to use EconomyShopGUI:
Since version v5.0.0 or v4.0.0 of the plugin, all required permissions are given by default and so you will not need to assign permissions to start.
Permissions update:
Please read this as updating the plugin to a newer version will cause your players not be able to sell items using /sellall and /sellgui features!
Since version 4.4 of EconomyShopGUI and version 2.5 of EconomyShopGUI Premium we have have updated our permissions from the plugin to allow servers to have better control over which shops your players should be able to sell items to using /sellgui and /sellall.
Before players would need the EconomyShopGUI.shop.<section>
or EconomyShopGUI.shop.all
permission node to sell items using /sellall
and /sellgui
but these have been split into seperate permissions for each command.
How to do it?
Basically if you don't care about which items your players can sell to shop, you will need to give your players the following permission nodes:
➖EconomyShopGUI.sellall.all
➖EconomyShopGUI.sellallitem.all
➖EconomyShopGUI.sellallhand.all
➖EconomyShopGUI.sellgui.all
If you are using LuckPerms as your permissions plugin(recomended), this can easily be done by executing the following commands:
➖ /lp group default permission set EconomyShopGUI.sellall.all true
➖ /lp group default permission set EconomyShopGUI.sellallitem.all true
➖ /lp group default permission set EconomyShopGUI.sellallhand.all true
➖ /lp group default permission set EconomyShopGUI.sellgui.all true
On the other hand if you have a special shop which is only meant for players that have a rank on your server, you should add the shops they should have access to as seperate permission nodes.
Added permissions since this update:
EconomyShopGUI.sellall.<section>
Gives access to sell items in a specific shop section using the /sellall
command.
EconomyShopGUI.sellall.all
Allows players to sell items using the /sellall
command to all shop sections
EconomyShopGUI.sellallitem.<section>
This permission allows players to sell items using the /sellall item
in specific shop sections
EconomyShopGUI.sellallitem.all
Allows players to sell items to all shop sections using the /sellall item
command
EconomyShopGUI.sellallhand.<section>
Allows players to sell in a specific shop section with the /sellall hand
command
EconomyShopGUI.sellallhand.all
Allows players to sell items using /sellall hand
to all shop sections
EconomyShopGUI.sellgui.<section>
Allows players to sell items using the /sellgui
command in specific sections
EconomyShopGUI.sellgui.all
Allows players to sell items to all shop sections using /sellgui
Placeholders:
To use placeholders you will need the PlaceholderAPI plugin. The placeholder expansion is hard coded into the plugin itself, so it isn't requried to install any expansion from the ECloud.
Item price placeholders:
Item price placeholders are used to display buy/sell prices of shop items in placeholders.
Buy prices:
%esgui_buyprice_<section>.<itemIndex>%
Sell prices:
%esgui_sellprice_<section>.<itemIndex>%
<section> is replaced with the item's section name
<itemIndex> is replaced with the item's index inside the shop
Example: page5.items.180
Shop placeholders:
Placeholders related to shop sections.
%esgui_shop_rotation_<section>%
Transaction placeholders:
Transaction placeholders are used to display the player/item which made the most amount of transactions in the shop. It is possible to get the top 1-10 players(or amount) purchasing/selling a single item within the current time frame. It is also possible to get the top 1-10 items(or amount) being purchased/sold in shop within the current time frame.
This totals at 240 placeholder combinations which can be used!
Replace <timeframe> by either MONTH, WEEK or DAY
Replace <ranking> by FIRST, SECOND, THIRD, FOURTH, FIFTH, SIXTH, SEVENTH, EIGTH, NINTH or TENTH
Top player purchasing items:
%esgui_<ranking>_player_most_bought_items_current_<timeframe>%
Player name which bought the most amount of items in the selected time frame
%esgui_<ranking>_player_most_bought_items_current_<timeframe>_amount%
The amount of items purchased by the player at this ranking in the selected time frame
Top player selling items:
%esgui_<ranking>_player_most_sold_items_current_<timeframe>%
Player name which sold the most amount of items the selected time frame
%esgui_<ranking>_player_most_sold_items_current_<timeframe>_amount%
The amount of items sold by the player at this ranking in the selected time frame
Top purchased items:
%esgui_<ranking>_most_bought_item_current_<timeframe>%
Item displayname which was purchased the most the selected time frame
%esgui_<ranking>_most_bought_item_current_<timeframe>_amount%
The amount of the item at this ranking and selected time frame which was purchased
Top sold items:
%esgui_<ranking>_most_sold_item_current_<timeframe>%
Item displayname which was sold the most the selected time frame
%esgui_<ranking>_most_sold_item_current_<timeframe>_amount%
The amount of the item at this ranking and the selected time frame which was sold
Note that the transaction placeholders require the option advanced-transaction-log:
inside the config.yml to be enabled.
Last updated
Was this helpful?