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.

The <section> part in permssion nodes is replaced with the actual name of the shop category. This is defined by the name of the shop/section configuration.

Permission nodeDefaultDescription

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

Permission nodeDefaultDescription

EconomyShopGUI.shop.<section>.item.<permission>

FALSE

A per item permission which allows you to buy/sell this specific item when set.

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.

These are the permission nodes you need to add to a group or a specific player in your permissions plugin. 1a. EconomyShopGUI.shop.all Allows access to all shops defined in the shops.yml file -OR- 1b. EconomyShopGUI.shop.<section> Allows access to a specific shop defined in the shops.yml file (Replace <section> with the section's name in the shops file!)

How to setup and assign permissions:

Note: Some permissions plugins are CaSe SeNsItIvE! be sure to have the right Character's upper-case or lower-case where written in the table(s) above!

Installing a permission plugin:

Installing a permissions plugin is that easy as dragging and dropping the file inside your server plugin's folder.

  1. First you need to go to your permissions plugin page. We recommend LuckPerms, LP's /lp editor command and webpage is easy to use.

  2. Research how to use the permissions plugin of your choice and be sure it is updated and compatible with your version of Minecraft. [Simple Luckperms Tutorial here]

  3. Download the plugin.

  4. Drop the file inside your plugins folder

  5. Restart the server.

Note: DO NOT install multiple permissions plugins. they will all fight with each other and cause you unending headaches. :/

Configuration:

We are not going to explain how to setup permissions in detail as everyone will want to setup their server differently. But if you watch a video on YT or many others you can search for, you can learn how to setup your permissions/ranks plugin just how you want it!

See the list of Basic permissions you will need (above) for ESGUI after installing/setting up your permissions plugin.

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.allEconomyShopGUI.sellallitem.allEconomyShopGUI.sellallhand.allEconomyShopGUI.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:

Permisson node:Description:

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

Last updated