Documentation
Economy and progressFree

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.
  • /sell sells 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 /sell even 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.