EconomyShop by ilius

⚡ 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

- Categories — Players browse categories, buy and sell through inventory menus - Categories — Quantity selector with price breakdown before every transaction - Categories — Right-click any shop item to sell, with tax shown before you confirm - Categories — Pick unlimited stock or set a cap with automatic restocking - Categories — Take a cut on every transaction, fully configurable - Categories — Admin shop sales, chest shop sales, and Categories sales all feed into one chart per item - Categories — Custom items show their real names, not raw material IDs - Categories — Organize your shop however you want with custom icons

Chest Shops

- Transaction tax — Players place a chest, add a sign, and set prices through a GUI - Transaction tax — Let customers buy from you, sell to you, or both - Transaction tax — Everything is handled through the setup and edit menus - Transaction tax — Customers pick exactly how many they want - Transaction tax — Charge players to open a shop, or make it free - Transaction tax — Cap how many shops each player can run - Transaction tax — Take a percentage from every chest shop sale

For Server Owners

- Granular permissions — Create categories, add items, set prices, toggle features — all through menus - Granular permissions — Works with any Vault-compatible economy plugin - Granular permissions — SQLite out of the box, switch to MySQL when you're ready - Granular permissions — Every message, every GUI label, every button — all in one language file - Granular permissions — Dollar signs, gold, coins, whatever fits your server - Granular permissions — Placeholders for scoreboards and tab lists - Granular permissions — Restrict shop access to certain regions - Granular permissions — Per-rank shop limits and chest shop caps - Granular permissions — Runs on Folia without any extra setup - Granular permissions — 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. The setup GUI opens anywhere in the world 2. The setup GUI opens 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

- Optional: (or Purpur, Folia, etc.) - Optional: + an economy plugin - Optional: LuckPerms, PlaceholderAPI, WorldGuard, Optional:, %%MD1%%

---

💬 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.*