EzChestShop Wiki Story: Well, I used to play Minecraft multiplayer with my friends several years ago, and I thought about how hard and limited are sign shops. Both complicated and not user-friendly for beginners as I remember I couldn't understand how to make one, or I couldn't sell things that were not from Minecraft like slimefun items. So I decided to use Minecraft's new update in order to make it easier, both for my players and for other server owners who are willing to keep their gameplay user-friendly, and that's how EzzzChestShop is made.
EzChestShop [ECS] is a player chest shop(and admin cs) plugin designed to be easy to use, construct, and have GUI implementation. ECS is compatible with major plugins like WorldGuard, Vault, and any economy plugin that uses Vault API. The plugin is designed not only for selling items but the reverse of that, so players can buy items from their chest shop. EzChestShop uses the newest Minecraft technology in order to store data and for some optional features, and it supports SQLite & MySQL for bigger servers. Furthermore, there won't be any data loss even if the server crashes.
The plugin doesn't support versions lower than 1.16, so don't try it out.
Dependencies:
Vault (Not necessary if you want to use XP-based economy)
an economy plugin that uses Vault API for handling the economy(Like EssentialsX)
AND PLEASE DO NOT LOAD/RELOAD THE PLUGIN WITH PLUGMAN/PLUGWOMAN or anything similar
Features:
Optimized especially for big servers with more than 150 players
Fully customizable
GUI IN-GAME Editor
Admin view - owner view - buyer & seller view
Friendly Interference(Sounds, easy-to-use GUI and etc...)
Easy guide for beginners
Async holograms and floating items - not a single tick get wasted.
Not limited - any item can be sold or bought LITERALLY ANYTHING
Compatible with almost any claim or region protector plugin.
Admin shops
Item preview (client-side)
Settings for each shop (you can copy and paste settings of each shop)
Tab-Complete support
Hex color support
Localized name support
Distance hologram system(togglable)
Permission-based (can limit players and let them create shops for a specific amount)
Shulker box, barrels, and trapped chest supports
Hopper and dispenser support + Redstone integration
Copy-able shop-settings! Set them up once and copy them over with /ecs settings copy|paste
Custom amount buy and sell
Shulker box shops can be picked up and placed somewhere else again.
Rotatable holograms(north, south, east, or west of the container)
Check profit command(player can easily access the information related to the chest shops that the player has)
Half-completed API for developers(like some events)
Special config for only holographic systems and it's like HTML lmao super cool try this out
Worldguard flags
Believe me a lot of other options but I have a word limit here.
and some other things that I don't even know exist but exist
Some pictures of GUI and plugin:
General GUI View:
Admin View part which is available for specific people having specific permission:
New update 1.4.0 main GUI:
Storage:
used for refilling or taking items from chest shop
new settings GUI:
Custom buy/sell amount GUI:
Configuration:
Code (YAML):
[/SIZE
][/B
] [SIZE=6
][/SIZE
][/B
] # EzChestShop plugin configuration # Before starting to config, please note that any usage of TABs in the config file may break the plugin so avoid using tabs and use space. # If you need help/found a bug, please join our Discord: https://discord.gg/rSfsqgCqBZ language: Locale_EN
shops:
hologram: # holograms are all shown in the async way and they won't waste a single tick / nor they are buggy like some other plugins show-holograms: true
# represents the holographic texts of chestshops. Use %item% to display the item's display name. # Use [item] for 1 Line to display the floating item. Use %buy% for buy price and %sell% for sell price. # %currency% is defined under economy.server-currency and %owner% represents the shops creator. # %maxbuy% & %maxsell% can be used to define the maximum amount a player can buy/sell to a shop at this time. # The HTML like <buy></buy> Syntax allows the plugin to remove parts of the message if buy/sell are disabled. holo-structure:
- "<buy>&fBuy: &a%buy%%currency%</buy><separator> &f| </separator><sell>&fSell: &c%sell% %currency%</sell>" -
"&d%item%" -
"[item]" holo-structure-adminshop:
- "<buy>&fBuy: &a%buy%%currency%</buy><separator> &f| </separator><sell>&fSell: &c%sell% %currency%</sell>" -
"&d%item%" -
"[item]" # Define a custom Line spacing multiplier. 1 is default. holo-line-spacing: 1
# hologram will get removed after x seconds if plugin doesn't detect any movement toward chest shop (default: 10) hologram-disappearance-delay: 10
# Allows players to rotate their Holograms to be displayed on different sides of the Block. allow-rotation: true
# an alternative hologram display system, which is slower but provides easier visibility of nearby shops. distance:
toggled: true
# Defines the range at which shops will render holograms (default: 10.0) range: 10.0
# Set if items should be rendered first and holograms only when looking at the shop directly. show-items-first: false
# Define which containers are applicable for chest shops: container:
chests: true
trapped-chests: true
barrels: true
shulkers: true
display: # define how the plugin should format displayed numbers, use: https://docs.oracle.com/en/java/javase/14/docs/api/java.base/java/text/DecimalFormat.html number-format:
gui: "###,###.##" chat: "###,###.##" hologram: "###,###.##" settings: # Define the default settings when creating a shop: defaults:
transaction-message: false
disable-buying: false
disable-selling: false
rotation: "up" share-profit: true
# If set to true, "/ecs create 12 0" will automatically disable selling(or buying if "/ecs create 0 12") zero-price-equals-disabled: true
# If set to true, this setting will require players to use a buy price that is greater than the sell price. buy-greater-than-sell: true
# If set to true Shulker shops will be given some Lore when mined (Set inside the language files) add-shulkershop-lore: true
economy: # Used to replace %currency% for the language files and the 2nd hologram line. server-currency: $
commands: # Register easier to remember alias on server startup: /shop and /adminshop alias:
ecs-shop: false
ecsadmin-adminshop: false
checkprofit-lines-per-page: 4
permissions: # If set to true, players require the permission "ecs.shops.limit.X" where X is the maximum amount of shops a player can create. create-shops: false
tasks: # Normally, This option is for when server(basically other plugins) remove the chest shop, in this case, it could result in some issues # if this is causing so much lag, you can turn this off (requires restart) check-for-removed-shops: true
[B
][SIZE=6
][/SIZE
]
Download Vault and an economy plugin(like EssentialsX) and put them there.
Start the server.
For player usage: /ecs | aliases: /cs - /ezchestshop (no permission needed)
/ecs create (buy price) (sell price)
/ecs settings [copy, paste, admins, toggle-buying, toggle-selling, toggle-message, toggle-shared-income] | I guess it doesn't need explanation, it just copies, pastes, or edits the settings of the chest shop you are looking at
/ecs remove | removes the chest shop
/cp | check your incomes/outcomes from all of the chest shops that the player owns | Permission for this one:
ecs.checkprofits
Additional permissions that you can give(limit): If you want to limit your players so that they can create a limited amount of shops, you can turn on the config.yml option:
Code (Text):
permissions:
create-shops: true
If set to true, this will require players to have the permission
ecs.shops.limit.X
where X is the maximum amount of shops a player can create.
Permission for number of custom hologram lines. Which X is the number of the lines:
Code (Text):
ecs.shops.hologram.messages.lines.X
Admin usage: permission
ecs.admin is basically the op of the plugin so it can access everything in the admin section but we have also some individual permissions for each
/ecsadmin
/ecsadmin remove | removing a chest shop |
ecs.admin.remove /ecsadmin reload | reloading the configuration |
ecs.admin.reload /ecsadmin create [buy price] [sell price] | creating admin shop |
ecs.admin.create and also the admin view of chest shops(basically access to everything in the container and settings of the container and some bypasses) |
ecs.admin.view
Chest shops can also be removed by breaking the chest. (can be modified in the config) EZ right?
Worldguard flags:
ecs-create-shop
ecs-create-admin-shop
ecs-remove-shop
ecs-remove-admin-shop
ecs-use-shop
ecs-use-admin-shop
That was all, hope you enjoy this plugin as I do for myself. This plugin is being used and tested by a network with a lot of survival players, so don't worry about glitches and bugs.
Bugs/Suggestions/Help - Contact: if you have found any bugs, errors, etc, or if you want to make a suggestion, feel free to contact me through Discord or Telegram:
Donation: If you have found my plugin interesting and want to support us, your donations are appreciated. A PayPal link is provided.
PLEASE READ THIS, BEFORE COMMENTING:
If you have found a bug, please first contact me, and if I didn't fix that, you are free to post a bad comment, and you are welcome.
If you want to make a suggestion or want compatibility/support with any plugin, do not post it in the comments section. In the discussions or by contacting me.
Reviewing a bad rating and then asking for help or etc... will not work and it doesn't help you at all nor will I help you.
.^_^
leave a like or comment down there if you think this resource is pretty good