EzChestShop Plugin untuk Minecraft 1.16.5, 1.18.2

Discord Server

Bstats statistics of the plugin (Thank you for using our plugin)

EzChestShop Wiki

Story: Well, I used to play Minecraft multiplayer with my friends several years ago, and I thought 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.

Now main description:

EzChestShop [ECS] is a player chest shop(and admin cs) plugin designed for being easy to use, construct, and have GUI implementation. ECS is made 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.14, so don't try it out.

Dependencies:

EzChestShop doesn't require any dependencies, but if you want to charge a virtual currency instead of XP points, you will need:

Vault

an economy plugin that uses Vault API for handling the economy(Like EssentialsX)

Both of these plugins hardly break at version updates, so don't fear if they don't state that they're up to the latest MC version yet.

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:

images

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:

Although that's the easiest chest shop ever, I think there are some people having difficulties, follow this tutorial to make a shop:

• Put the item you want to sell or buy in your hand
• Look at a chest and execute /ecs create (buy price) (sell price) | ex: /ecs create 1000 0
• Done. You have successfully created a chest shop.

config.yml

Configuration:

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 Syntax allows the plugin to remove parts of the message if buy/sell are disabled.

holo-structure:

• "&fBuy: &a%buy% %currency% &f| &fSell: &c%sell% %currency%"
• "&d%item%"
• "[item]"

holo-structure-adminshop:

• "&fBuy: &a%buy% %currency% &f| &fSell: &c%sell% %currency%"
• "&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

locale_en (latest)

plugin uses this file in order to display messages in plugin

For hologram messages, you have to check config.yml

NOTE: DO NOT USE TAB in yml file as it can cause serious performance problems and it sometimes can break the plugin

Don't forget to rate if you liked EzChestShop

shop-gui: initialbuyprice: "&aInitial Buy price: &e%buyprice% %currency%" initialsellprice: "&cInitial Sell price: &e%sellprice% %currency%" admin-title: "&c%shopowner%'s chest shop &4(Admin view)" nonowner-title: "&c%shopowner%'s chest shop" owner-title: "&c%shopowner%'s chest shop" adminshop-title: "&cAdmin shop" buttons: sellone-title: "&cSell 1x" sellone-lore:

• "&7Sell for &e%price% %currency%"

sell64-title: "&cSell 64x" sell64-lore:

• "&7Sell for &e%price% %currency%"

buyone-title: "&aBuy 1x" buyone-lore:

• "&7Buy for &e%price% %currency%"

buy64-title: "&aBuy 64x" buy64-lore:

• "&7Buy for &e%price% %currency%"

adminview: "&c&lAdmin View" storage: "&e&lStorage" settings: "&b&lSettings" disabled-title: "&cDisabled" disabled-lore:

• "&7This option is disabled by "
• " &7the shop owner."

transactions: transactionButtonTitle: "&aTransaction logs" backToSettingsButton: "&eBack to settings" PaperTitleBuy: "&aBuy | %player%" PaperTitleSell: "&cSell | %player%" PaperLoreBuy:

• "&7Total Price: %price% "
• " &7Quantity: %count% "
• " &7Transaction Type: &aBought from you "
• " &e%time%"

PaperLoreSell:

• "&7Total Price: %price% "
• " &7Quantity: %count% "
• " &7Transaction Type: &cSold to you "
• " &e%time%"

lessthanminute: "&eless than a minute ago" minutesago: "&e%minutes% minute(s) ago" hoursago: "&e%hours% hour(s) ago" daysago: "&e%days% days ago" #settings gui section settings: GuiTitle: "&b&lSettings" statusOn: "&aOn" statusOff: "&cOff" buttons: toggleTransactions: Title: "&eToggle Transaction Message" Lore:

• "&7Current status: %status% "
• " &7If you keep this option on, "
• " &7you will recieve transaction "
• " &7messages in chat whenever someone "
• " &7buy/sell something from this shop"

disableBuying: Title: "&eDisable Buying" Lore:

• "&7Current status: %status% "
• " &7If you keep this option on, "
• " &7the shop won't let anyone buy "
• " &7from your chest shop."

disableSelling: Title: "&eDisable Selling" Lore: