✨ 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, no config editing required
• Vault — Works with any Vault-compatible economy plugin
• SQLite / MySQL / MariaDB — SQLite out of the box, switch to MySQL when you're ready to scale
• 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

Players can set up their own shops in three simple steps:

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.

To edit your shop later, right-click the sign as the owner — you can change prices or close the shop from the edit menu.


⌨️ Commands

Player
Admin

Permissions

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

Requirements

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

Need Help?
Join the Discord or drop a message in the discussion tab.

• 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