Shop
A buy and sell menu by category, with /sell and /worth, rank discounts, dynamic prices, stocks and daily limits.
The Shop module gives your server a complete admin shop. Players buy and sell items from a menu sorted by category, sell their loot with /sell, and check prices with /worth. You build the whole shop from the web editor, and you can go further with rank discounts, prices that follow supply and demand, limited stocks and daily limits.
The shop works with the economy module: while it is disabled, the shop cannot buy or sell.
Features
- Menu by category: a main menu with your categories, then one page of items per category.
- Buy and sell in one click: left click buys one lot, shift left click buys a stack, right click sells one lot, shift right click sells everything of that item. The Q key opens a menu to choose the exact quantity.
/sellsells the item in hand, the whole inventory, or what the player drops in a sell chest.- Ready to use: the shop comes with five categories (Blocks, Ores, Food, Farming, Mob drops) and their items, which you can change freely.
- Exact items: sell an item with its custom name, enchantments and data by capturing it from a player's hand.
- Commands as products: sell ranks, perks or keys by running console commands instead of giving items.
- Rank perks: a discount on purchases and a multiplier on sales, rank by rank.
- Dynamic prices: prices go up when players buy and down when they sell, then slowly come back to normal.
- Stocks and limits: a stock shared by the whole network that refills over time, and a daily limit per player.
- Statistics and history of every purchase and sale.
- Safe trades: an item can never be sold for more than it costs to buy, renamed or enchanted items are not bought back at the price of a plain item, and items from a sale that could not finish are given back.
Setting it up
Open the Shop module in the web editor. The Shop tab has four views: Shop, Prices, Statistics and Commands.
Shop view
The top of the view shows the main menu as players see it in game. Drag a category to move it, click it to edit it. Category adds a new one.
| Category field | What it does |
|---|---|
| ID | Unique short name, also used by /shop <category>. Letters a to z, digits and _. |
| Icon | Item shown in the main menu. |
| Name | Name shown to players. Color codes are allowed. |
| Slot | Position in the main menu, 0 to 53, or -1 for the first free slot. |
| Permission | Permission needed to see the category. Empty means everyone. |
Below, the items of the selected category appear as cards. Drag the cards to change their order in game, click a card to edit it. Item adds a new one.
| Item field | What it does |
|---|---|
| Category | Category the item belongs to. |
| Item | The Minecraft item. |
| Lot size | Number of items bought or sold together. |
| Display name | Custom name. Empty shows the game name in the player's language. |
| Buy price | Price of the whole lot. 0 means it cannot be bought. |
| Sell price | Price paid to the player for the whole lot. 0 means it cannot be sold. |
| Currency | Currency of the prices. |
| Permission | Permission needed to see and buy the item. Empty means everyone. |
| Stock | Items available for the whole network. 0 means unlimited. Player sales refill it. |
| Refill every | How often the stock goes back to full, for example 6h or 1d. Empty means never. |
| Daily limit per player | Number of items a player can buy per day. 0 means no limit. |
| Dynamic price | The item follows supply and demand when dynamic prices are on. |
| Commands instead of items | For ranks and perks. One command per line, run by the console. {player} is the name of the buyer and {uuid} their UUID. These products cannot be sold back. |
| Item from the game | Sells an exact item. A player holds it in hand, then you click Take it from a player's hand, or run /shop capture <id> in game. |
When an item has a stock, Refill the stock fills it right away.
Prices view
- Price list: every item in one table, filtered by category. Select items to multiply their buy price, sell price or both, or to turn their dynamic price on or off in one go.
- Sell only prices: items players can sell with
/selleven though the shop does not show them. The price is for one item. - Dynamic prices: the settings below, and Reset prices to put every dynamic price back to its normal value.
Statistics view
Choose a period (today, 7, 30 or 90 days) to see the money in from purchases, the money out from sales, the balance, the number of transactions, the most bought items and the items most sold by players. History lists every transaction, with a search by player or item.
The purchases and sales of each player are also shown in their profile in Players.
Commands view
The three commands of the shop: /shop, /sell and /worth. Open a card to change its aliases, permission, worlds and, rank by rank, access, cooldown and price (see commands). Two limits are set here, rank by rank:
| Limit | Command | What it does | Default rows |
|---|---|---|---|
| Shop discount (%) | /shop |
Discount on every purchase, from 0 to 90 %. | vip 5 %, mvp 10 % |
| Sell price multiplier | /sell |
Multiplies what the player gets when selling, from 0 to 10. | vip 1.1, mvp 1.25 |
The discount and multiplier apply everywhere in the shop, not only to the command they are set on. A rank that is not allowed to use /sell also does not see the sell button in the shop menu.
Settings tab
General
| Setting | What it does | Default |
|---|---|---|
| Full inventory | What happens when a purchase does not fit in the inventory: Refuse the purchase or Drop the rest at the feet. | Refuse the purchase |
| Max items per purchase | Upper bound of the quantity menu and of a single purchase (up to 2304). | 576 |
| Confirm sales from the chest | After closing the /sell chest, the player sees the total and confirms or takes the items back. |
On |
| Keep the history (days) | How long transactions are kept. 0 keeps them forever. | 90 |
Dynamic prices
| Setting | What it does | Default |
|---|---|---|
| Dynamic prices | Turns dynamic prices on for the items that have Dynamic price checked. | Off |
| Change per trade (%) | Price change for each lot bought or sold. | 0.5 |
| Lowest price (%) | Lowest price, as a percentage of the normal price. | 50 |
| Highest price (%) | Highest price, as a percentage of the normal price. | 200 |
| Return to normal (% per hour) | How fast prices come back to normal. | 10 |
Commands
The commands of this module can have their aliases, permission, cooldown, price, worlds and rank rules changed in the editor. See commands.
| Command | What it does | Default permission |
|---|---|---|
/shop |
Opens the shop menu. Alias: /market. |
inglis.shop.shop |
/shop <category> |
Opens a category directly. | inglis.shop.shop |
/shop capture <id> |
Makes the item in your hand the exact item sold as <id>. |
inglis.shop.admin (operators) |
/sell or /sell gui |
Opens a chest: put items inside and close it to sell them. | inglis.shop.sell |
/sell hand |
Sells the item in your hand. | inglis.shop.sell |
/sell all |
Sells every sellable item of your inventory. Armor and the second hand are not touched. | inglis.shop.sell |
/worth |
Shows the sell price of the item in your hand, per item, per stack and for what you hold, and its buy price. Alias: /price. |
inglis.shop.worth |
Tips
- Daily limits reset at midnight, server time.
- If you set a sell price higher than the buy price, the editor warns you: the shop caps it at the buy price so players cannot earn money by buying then selling.
- Give rare items a stock with a refill delay to create scarcity, and turn on dynamic prices for common resources so that farms do not flood the economy.
- Use Sell only prices for mob drops or crops you want players to sell without showing them in the shop.