⚡ 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.