⚡ EconomyShop ⚡

A clean, modern server shop & chest shop plugin for Paper 1.20+

---

🛒 Browse & Buy

Open the shop, pick a category, grab what you need. No chat commands, just click.

💰 Sell to Shop

Right-click any item in the shop to sell it back. Price, tax, and confirmation — all shown upfront.

📦 Player Chest Shops

Place a chest, slap a sign on it, and you've got a shop. Set your own prices through a simple GUI.

🛍️ Buy from Players

Walk up to any chest shop, click the sign, choose how many, done.

📊 Price History

Every sale — whether it's from the admin shop, a chest shop, or even AuctionHouse — feeds into the same price chart. 7, 14, and 30-day views with highs, lows, and averages.

---

✨ What's Included

Server Shop

• All GUI, no commands — Players browse categories, buy and sell through inventory menus
• Confirmation screen — Quantity selector with price breakdown before every transaction
• Sell back to the server — Right-click any shop item to sell, with tax shown before you confirm
• Infinite or limited stock — Pick unlimited stock or set a cap with automatic restocking
• Sales tax — Take a cut on every transaction, fully configurable
• Shared price history — Admin shop sales, chest shop sales, and AuctionHouse sales all feed into one chart per item
• Datapack friendly — Custom items show their real names, not raw material IDs
• Categories — Organize your shop however you want with custom icons

Chest Shops

• Chest + sign = shop — Players place a chest, add a sign, and set prices through a GUI
• Separate buy & sell prices — Let customers buy from you, sell to you, or both
• No commands needed — Everything is handled through the setup and edit menus
• Quantity selector — Customers pick exactly how many they want
• Creation cost — Charge players to open a shop, or make it free
• Per-player shop limit — Cap how many shops each player can run
• Transaction tax — Take a percentage from every chest shop sale

For Server Owners

• Admin GUI — Create categories, add items, set prices, toggle features — all through menus
• Vault — Works with any Vault-compatible economy plugin
• SQLite / MySQL / MariaDB — SQLite out of the box, switch to MySQL when you're ready
• Fully translatable — Every message, every GUI label, every button — all in one language file
• Configurable currency — Dollar signs, gold, coins, whatever fits your server
• PlaceholderAPI — Placeholders for scoreboards and tab lists
• WorldGuard — Restrict shop access to certain regions
• LuckPerms — Per-rank shop limits and chest shop caps
• Folia support — Runs on Folia without any extra setup
• Anti-exploit — Transaction locks, dupe prevention, creative mode blocking, rate limiting
• Granular permissions — Give admins edit access without reload access, or the other way around

---

🔗 Part of the ilius Economy Ecosystem

EconomyShop is the server shop of the ilius economy stack. Pair it with:

• EconomyProvider — Modern Vault economy with banknotes, baltop GUI, and transaction logging
• AuctionHouse — Player-to-player marketplace with price history, filters, and container preview

All three plugins integrate seamlessly — same config style, same database support, same Discord. Use one or all three.

---

🏗️ How to Create a Chest Shop

1. Place a chest anywhere in the world
2. Place a sign on or next to the chest and type [Shop] on the first line
3. The setup GUI opens — pick your item, set buy/sell prices, and confirm

The sign updates automatically with your item name and prices. To restock, just open the chest and add more items. Other players click the sign to buy.

---

⌨️ Commands

Player

Command	Description
/shop	Open the shop
/shop sell	Sell items to the server

Admin

Command	Description
/shop admin	Open the admin shop editor
/shop admin reload	Reload config, messages, and GUIs

---

🔑 Permissions

Permission	Description	Default
economyshop.use	Open the shop	true
economyshop.sell	Sell items to the shop	true
economyshop.chestshop.create	Create chest shops	true
economyshop.chestshop.use	Use other players' chest shops	true
economyshop.admin	Full admin access	op
economyshop.admin.edit	Edit items and categories	op
economyshop.admin.reload	Reload config	op

---

📥 Setup

1. Drop the jar in plugins/
2. Restart
3. Run /shop admin to create categories and add items
4. Players open /shop and start trading

Want MySQL instead of SQLite? Open config.yml, set storage.type to mysql, then fill in host, port, database, username, and password under the storage.mysql section. Restart and you're done.

---

📦 Requirements

• Paper 1.20+ (or Purpur, Folia, etc.)
• Vault + an economy plugin
• Optional: LuckPerms, PlaceholderAPI, WorldGuard, EconomyProvider, AuctionHouse

---

💬 Need Help?

Join the Discord or open an issue.

---

🚀 Pro Edition — Coming Soon

Everything above, plus:

• Dynamic Pricing — prices shift based on supply and demand
• Admin Dashboard with live stats and module toggles
• Transaction History GUI for players
• Chest Shop Statistics
• LuckPerms Rank-Based Discounts
• Display Entities — floating items above chest shops
• Stock Alert Notifications for shop owners

Part of the ilius economy ecosystem. Built for servers that take their economy seriously.