EasyShops2.0

EasyShops2.0 is a plugin that allows tha players to create very customizable shops easily

EasyShops2.0
Create shops has never been so easy
No more than a few clicks

Really customizable!

Buying and selling can't be more intuitive!

Find out when someone buys or sells at your shops!

Let every player choose how they want to interact with the shops!

If you have found a bug, report it here: https://forms.gle/fyAQrN9djiXr3bAM8
If you have an idea that you'd like to see in the plugin, suggest it here: https://forms.gle/wQcuYKWaa7qLdZdp7

IMPORTANT: THIS PLUGIN USES VAULT

Features

• Every message is customizable
• 3 diferent modes for the shops (buy, sell and buy and sell)
• Posibility to create shops in double chests
• Use shulker boxes with the shops to have extra espace
• The shops are fully customizable
• Modes like the admin mode (shop doesn't consume items or money) and allow everything mode (You can sell everything to a shop, you can change the prices and suports custom items)
• Every player can interact with the shops as they want (If they want to edite them with the chat or with a menu, if they want to buy or sell with the chat or with a menu, etc.)
• Sounds and particle effects that coy can configurate in the config
• Comands to get guided or teleported to a shop
• Many more things

You can read more about this features down the page

Creating a shop

To create a shop you need space, the block in front of and on top of the chest that will be the shop need to be air.
To create a shop you have to do left click while you are shifting in a chest with the item to sell/buy in your main hand.
In the menu you can select a price and a mode. In the buy mode you can select also a limit, to select a limit do click in the golden nugget, to go back to select a price do click in the hopper.
If you have the permission easyShops.adminMode you will be able to set the shop in admin mode, this means that the shop will not consume any items or money.
You shuldn't be able to create shops in the worlds banned in the config and in areas where you cant interact.

Editing a shop
To edit a shop you have to do left click while you are shifting in a shop.
If you click the item that the shop buys/sells the item will be changed to the item that you are holding in your main hand.
If you have the permission easyShops.editOthersShops you can change the owner of the shop.
To add a player click the head and then the 'Add player' button and send the name of the player in the chat.
To remove a player click the head and then the 'Remove player' button and click the head of the player to remove.
A shop can't have more than 43 players added.
The player added just can open the chest where the shop is.
Here the admin mode is replaced with the admin menu. You can read about this down.
The rest works as if you were creating a new shop.

Deleting a shop
Enter the edit shop menu and click the barrier, then click 'Accept'
You can also break the chest of the sign of the shop.

Buyng and selling
To buy or sell you have to do right click while you are shifting in a shop.
Depending if you have enabled or no the option 'Buy with chat' in the /easyshops options menu you will buy or sell with the chat or with an inventory.

Admin menu

The admin menu is a menu made for the admins, in this menu the admins can modify almost everything of a shop.

• Change the lines

The papers are used to modify the lines of the sign of the shop, in the torch you can see a preview. Also, if you click the torch you will edite all the lines at ones.

• Sign type

Clicking the glass panes you can change the type of the sign of the shop, if you click the sign it will turn into the default sign type (oak sign). This feature is only disponible for minecraft 1.14 and higer versions.

• Allow everything

If enabled, the players will be able to sell every item to the shop.

By clicking the torch you will see how much money you will earn. This mode does not suport the content inside shulker boxes (at the moment), but it suports custom items that you can especify with /es admin addCustomItem <item price> while you have the item in your main hand. If you enable this the shop will set its mode to sell and will enable the admin mode.

• Set owner name

The text that you set when using this option will be used in the sign when you use the variable %owner%.

• Admin mode

If enabled the shop will not consume any items or money.

Players allowed
The players allowed are just players that can open and add or thake items from the chest that your shop is in.

/easyshops options

- Buy with chat :
If enabled when buying or selling insted of doing it with a menu you will do it with the chat.
- Limit to your stock :
If enabled when buying/selling with the menu you won't be able to select more items that you can sell or that fit in your inventory
- Limit to the amount you can pay :
If enabled when buying with the menu you won't be able to select more items that you can pay
- Create edite with chat :
If enabled insted of creating and editing shops with a menu you will do it with ths chat
- Resend message :
If enabled when ediiting the shop with the chat you will get again the message to edite the shop
- Use beam :
If enables a laser will gide you to a shop when using the /gotoshop comand, if not you will be gided by an invisible slime

Configuration file
- generate-items : Summons an item on top of a every shop
- check-shops : When the plugin starts checks all shops, if it finds a shops that is in a prohibited state the shop gets removed
- admin-shop-dont-get-messages : The shops in admin mode don't recive messages when someone buys/sells on them
- owner-can-buy-sell : Allows the owner of teh shop to buy/sell on it. If the shop is in admin mode owner-can-buy-sell-admin has preference
- owner-can-buy-sell-admin : Allows the owner of teh shop to buy/sell on it if its in admin mode
- use-roman-numbers : When displaying the a shop info in the chat use roman numbers
- default-options : Set the default options for all players
- banned-worlds : List with the name of the worlds where you can't create shops
- banned-items : List with the id of the items that can't be used to create a shop.
- create-edite : To configure the values of the panels of the menus when creating/editing
- buy-sell : To configure the values of the panels of the menus when buying/selling
- souds-and-particles : Customize the sounds and particles that the shops have
- enable-bStats : Enable bStats when the plugin starts
- check-update-on-join : When an op player or a player with the permission easyShops.checkUpdateOnJoin joins the server the plugin will check for an update, if it founs one, sends a message to the player

#Summons an item at the top of the shop   
generate-items   :  true 

 #Check every shop when the plugin enables. Can cause lag   
check-shops   :  true 

 #Don't send the messages when someone buys or sells  
 #to an admin shop   
admin-shop-dont-get-messages   :  true 

 #The owner can buy/sell on his shops?   
owner-can-buy-sell   :  false 

 #The owner can buy/sell on his admin shops?   
owner-can-buy-sell-admin   :  true 

 #Then showing the information of an item  
 #while buying/selling show the  
 #level of the enchantments as roman numbers   
use-roman-numbers   :  true 

 #Enable bStats   
enable-bStats   :  true 

 #When an op player or a player with the permission  
 #easyShops.checkUpdateOnJoin joins the server  
 #the plugin will check for an update   
check-update-on-join   :  true 

 #Sounds and particles used  
 #for when the player interats  
 #with shops   
souds-and-particles  :  
    list-with-particles   :  https://tinyurl.com/y53375jf  
    list-with-sounds   :  https://tinyurl.com/pzfzn3j  
    particles  :  
        block-action  :  
            display   :  true  
            particle   :  BARRIER  
            amount   :  1  
        shop-delete  :  
            display   :  true  
            particle   :  EXPLOSION_NORMAL  
            amount   :  20  
        shop-created-edited  :  
            display   :  true  
            particle   :  VILLAGER_HAPPY  
            amount   :  20  
    sounds  :  
        sell  :  
            display   :  true  
            sound   :  ENTITY_CHICKEN_EGG  
            volume   :  100  
            pitch   :  1  
        buy  :  
            display   :  true  
            sound   :  ENTITY_ITEM_PICKUP  
            volume   :  100  
            pitch   :  1  
        block-action  :  
            display   :  true  
            sound   :  ENTITY_VILLAGER_NO  
            volume   :  100  
            pitch   :  1  
        cancel-ation  :  
            display   :  true  
            sound   :  BLOCK_CHEST_CLOSE  
            volume   :  100  
            pitch   :  1  
        click-inventory  :  
            display   :  true  
            sound   :  BLOCK_DISPENSER_FAIL  
            volume   :  100  
            pitch   :  1  
        create-edite-shop  :  
            display   :  true  
            sound   :  ENTITY_PLAYER_LEVELUP  
            volume   :  100  
            pitch   :  2  
        delete-shop  :  
            display   :  true  
            sound   :  ENTITY_GENERIC_EXPLODE  
            volume   :  100  
            pitch   :  1 


 #Change the values of the options in the  
 #create and edite menus  
 #You can use decimals   
create-edite  :  
    white-concrete  :  
        display   :  true  
        value   :  1  
    magenta-concrete  :  
        display   :  true  
        value   :  5  
    light-blue-concrete  :  
        display   :  true  
        value   :  10  
    yellow-concrete  :  
        display   :  true  
        value   :  50  
    lime-concrete  :  
        display   :  true  
        value   :  100  
    pink-concrete  :  
        display   :  true  
        value   :  500  
    gray-concrete  :  
        display   :  true  
        value   :  1000  
    orange-concrete  :  
        display   :  true  
        value   :  5000  
    light-gray-concrete  :  
        display   :  true  
        value   :  10000  
    cyan-concrete  :  
        display   :  true  
        value   :  100000 

 #Change the values of the options in the  
 #buy and sell menus  
 #You can't use decimals   
buy-sell  :  
    white-concrete  :  
        display   :  true  
        value   :  1  
    magenta-concrete  :  
        display   :  true  
        value   :  5  
    light-blue-concrete  :  
        display   :  true  
        value   :  10  
    yellow-concrete  :  
        display   :  true  
        value   :  50  
    lime-concrete  :  
        display   :  true  
        value   :  100  
    pink-concrete  :  
        display   :  true  
        value   :  500  
    gray-concrete  :  
        display   :  true  
        value   :  1000  
    orange-concrete  :  
        display   :  true  
        value   :  5000  
    light-gray-concrete  :  
        display   :  true  
        value   :  10000  
    cyan-concrete  :  
        display   :  true  
        value   :  100000 

 
default-options  :  
    use-chat   :  false  
    limit-to-player-stock   :  true  
    limit-to-player-can-pay   :  true  
    create-edite-with-chat   :  false 

 #Worlds where you can't create shops   
banned-worlds   : 
    - 'worldName' 
    - 'worldName' 
    - 'worldName' 

 #Items that can't be used on shops   
banned-items   :   #Check the items list in messages.yml  
    - 'itemId' 
    - 'itemId' 
    - 'itemId'

Messages file
IMPORTANT: The variables between ! don't display with the message and need to be at the begining of the line. They are used to give the plugin information about what action it has to make. There can only be one for line.