# \u26a1 EconomyShop \u26a1<\/p>\n
**A clean, modern server shop & chest shop plugin for Paper 1.20+**<\/p>\n
   <\/p>\n
—<\/p>\n
### \ud83d\uded2 Browse & Buy
\nOpen the shop, pick a category, grab what you need. No chat commands, just click.<\/p>\n
<\/p>\n
### \ud83d\udcb0 Sell to Shop
\nRight-click any item in the shop to sell it back. Price, tax, and confirmation \u2014 all shown upfront.<\/p>\n
<\/p>\n
### \ud83d\udce6 Player Chest Shops
\nPlace a chest, slap a sign on it, and you’ve got a shop. Set your own prices through a simple GUI.<\/p>\n
<\/p>\n
### \ud83d\udecd\ufe0f Buy from Players
\nWalk up to any chest shop, click the sign, choose how many, done.<\/p>\n
<\/p>\n
### \ud83d\udcca Price History
\nEvery sale \u2014 whether it’s from the admin shop, a chest shop, or even AuctionHouse \u2014 feeds into the same price chart. 7, 14, and 30-day views with highs, lows, and averages.<\/p>\n
<\/p>\n
—<\/p>\n
## \u2728 What’s Included<\/p>\n
### Server Shop
\n– **All GUI, no commands** \u2014 Players browse categories, buy and sell through inventory menus
\n– **Confirmation screen** \u2014 Quantity selector with price breakdown before every transaction
\n– **Sell back to the server** \u2014 Right-click any shop item to sell, with tax shown before you confirm
\n– **Infinite or limited stock** \u2014 Pick unlimited stock or set a cap with automatic restocking
\n– **Sales tax** \u2014 Take a cut on every transaction, fully configurable
\n– **Shared price history** \u2014 Admin shop sales, chest shop sales, and AuctionHouse sales all feed into one chart per item
\n– **Datapack friendly** \u2014 Custom items show their real names, not raw material IDs
\n– **Categories** \u2014 Organize your shop however you want with custom icons<\/p>\n
### Chest Shops
\n– **Chest + sign = shop** \u2014 Players place a chest, add a sign, and set prices through a GUI
\n– **Separate buy & sell prices** \u2014 Let customers buy from you, sell to you, or both
\n– **No commands needed** \u2014 Everything is handled through the setup and edit menus
\n– **Quantity selector** \u2014 Customers pick exactly how many they want
\n– **Creation cost** \u2014 Charge players to open a shop, or make it free
\n– **Per-player shop limit** \u2014 Cap how many shops each player can run
\n– **Transaction tax** \u2014 Take a percentage from every chest shop sale<\/p>\n
### For Server Owners
\n– **Admin GUI** \u2014 Create categories, add items, set prices, toggle features \u2014 all through menus
\n– **Vault** \u2014 Works with any Vault-compatible economy plugin
\n– **SQLite \/ MySQL \/ MariaDB** \u2014 SQLite out of the box, switch to MySQL when you’re ready
\n– **Fully translatable** \u2014 Every message, every GUI label, every button \u2014 all in one language file
\n– **Configurable currency** \u2014 Dollar signs, gold, coins, whatever fits your server
\n– **PlaceholderAPI** \u2014 Placeholders for scoreboards and tab lists
\n– **WorldGuard** \u2014 Restrict shop access to certain regions
\n– **LuckPerms** \u2014 Per-rank shop limits and chest shop caps
\n– **Folia support** \u2014 Runs on Folia without any extra setup
\n– **Anti-exploit** \u2014 Transaction locks, dupe prevention, creative mode blocking, rate limiting
\n– **Granular permissions** \u2014 Give admins edit access without reload access, or the other way around<\/p>\n
—<\/p>\n
## \ud83d\udd17 Part of the ilius Economy Ecosystem<\/p>\n
EconomyShop is the server shop of the ilius economy stack. Pair it with:<\/p>\n
– **EconomyProvider** \u2014 Modern Vault economy with banknotes, baltop GUI, and transaction logging
\n– **AuctionHouse** \u2014 Player-to-player marketplace with price history, filters, and container preview<\/p>\n
All three plugins integrate seamlessly \u2014 same config style, same database support, same Discord. Use one or all three.<\/p>\n
—<\/p>\n
## \ud83c\udfd7\ufe0f How to Create a Chest Shop<\/p>\n
1. **Place a chest** anywhere in the world
\n2. **Place a sign** on or next to the chest and type `[Shop]` on the first line
\n3. **The setup GUI opens** \u2014 pick your item, set buy\/sell prices, and confirm<\/p>\n
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.<\/p>\n
—<\/p>\n
## \u2328\ufe0f Commands<\/p>\n
**Player**<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/shop` | Open the shop |
\n| `\/shop sell` | Sell items to the server |<\/p>\n
**Admin**<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/shop admin` | Open the admin shop editor |
\n| `\/shop admin reload` | Reload config, messages, and GUIs |<\/p>\n
—<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
| Permission | Description | Default |
\n|—|—|—|
\n| `economyshop.use` | Open the shop | true |
\n| `economyshop.sell` | Sell items to the shop | true |
\n| `economyshop.chestshop.create` | Create chest shops | true |
\n| `economyshop.chestshop.use` | Use other players’ chest shops | true |
\n| `economyshop.admin` | Full admin access | op |
\n| `economyshop.admin.edit` | Edit items and categories | op |
\n| `economyshop.admin.reload` | Reload config | op |<\/p>\n
—<\/p>\n
## \ud83d\udce5 Setup<\/p>\n
1. Drop the jar in `plugins\/`
\n2. Restart
\n3. Run `\/shop admin` to create categories and add items
\n4. Players open `\/shop` and start trading<\/p>\n
**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.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements
\n– **Paper 1.20+** (or Purpur, Folia, etc.)
\n– **Vault** + an economy plugin
\n– **Optional:** LuckPerms, PlaceholderAPI, WorldGuard, EconomyProvider, AuctionHouse<\/p>\n
—<\/p>\n
## \ud83d\udcac Need Help?
\nJoin the Discord or open an issue.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Pro Edition \u2014 Coming Soon<\/p>\n
Everything above, plus:<\/p>\n
– Dynamic Pricing \u2014 prices shift based on supply and demand
\n– Admin Dashboard with live stats and module toggles
\n– Transaction History GUI for players
\n– Chest Shop Statistics
\n– LuckPerms Rank-Based Discounts
\n– Display Entities \u2014 floating items above chest shops
\n– Stock Alert Notifications for shop owners<\/p>\n
*Part of the ilius economy ecosystem. Built for servers that take their economy seriously.*<\/p>\n","protected":false},"excerpt":{"rendered":"
Clean server shop and player chest shops with price history, sales tax, and full GUI management<\/p>\n","protected":false},"featured_media":61571,"template":"","meta":{"_minecraft_slug":"economyshop","_minecraft_project_id":"zR6c1YxT","_minecraft_author":"iliusIsOk","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":493,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"economyshop.zip","_minecraft_size_bytes":18316217,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T10:43:04.305571Z","_minecraft_date_created":"2026-04-14T23:13:34.568767Z","_minecraft_date_modified":"2026-05-14T10:50:14.410299Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/economyshop","_minecraft_icon_attachment_id":61571,"_minecraft_imported_at":"2026-06-03T13:54:40+00:00","_minecraft_import_hash":"934f13020a5fc3b057e26cb73f2e1d12","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,126,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-61570","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n