Peddler | Offline Player Shops v1.0.0

Peddler
Peddler gives every player a real shop. A stall keeps buying and selling the items its owner picked even while that owner is offline, so trading never stops just because someone logged off. Buyers find every stall through one searchable, sortable directory that covers the whole server, and owners can grow into a rentable shopping district once they want a permanent spot.

Built for: Survival, SMP, and any server that wants a real player economy instead of a static shop plugin.

How a stall works

• A stall is anchored to a block, a barrel by default. Look at the block and run /peddler create to found it.
• Each stall holds stock (the physical items it has to sell) and a till (the money it holds). Buyers pay into the till. The stall pays out of the till when it buys from players.
• For every item the owner sets a sell price and a buy price separately. Set either one to zero to turn that side off.
• A stall keeps trading while its owner is offline. It stops selling an item once stock hits zero, and stops buying once the till cannot cover one more purchase.
• A 5% sales tax (configurable) is skimmed from every sale as a money sink. The buyer still pays full price.
• A one-time 250 cost founds a free-placed stall, and each player can run up to 3 stalls by default. Both numbers are configurable.
• The anchor block is protected by default: it cannot be broken, exploded, burned, or pushed by a piston while the stall stands.

The owner control panel
Right click a stall's anchor block to open its control panel. Add an offer straight from the item in your hand, deposit or withdraw the till, and read a transaction log of the stall's recent sales and purchases. Removing a stall refunds its stock and till in full. Staff with peddler.admin can open and moderate any stall the same way, including its log, without owning it.

Set your own prices

Each offer opens its own price editor. Sell price and buy price move independently with small and large step buttons, or can be turned off completely with one click. Stock deposits and withdrawals happen from the same menu.

One searchable, sortable directory

/peddler opens a server-wide directory of every live sell offer, with the price, stock, stall name, owner, and distance from wherever the buyer is standing. Sort by cheapest, priciest, item name, nearest, or newest, or search by item, stall, or owner name with /peddler search. Remote buying can be turned on so buyers purchase straight from the directory, or off so the directory only gives directions.

Shopping districts and rent

Define rentable plots in the config, each with its own anchor block and rent amount. Players rent a plot with /peddler district, paying the first rent period up front. Rent is then charged once a day by default straight from the stall's till, and from the owner's balance if the till falls short. A stall that misses 3 rent cycles in a row (configurable) has its plot released and returned as a normal stall for the owner. Rent leaves the economy completely, so it works as a money sink on a busy server.

Commands

• /peddler (aliases /pd, /shops, /stall) opens the shop directory.
• /peddler search <text> opens the directory filtered to a matching item, stall, or owner.
• /peddler create [name] founds a stall on the block you are looking at.
• /peddler manage opens the control panel for a stall you own.
• /peddler list lists your stalls and their locations.
• /peddler rename <name> renames the stall you are looking at.
• /peddler remove takes down the stall you are looking at and refunds its stock and till.
• /peddler district [plot] browses district plots, or rents one by id.
• /peddler balance [player] and /peddler pay <player> <amount> use the built-in economy.
• /peddler admin stalls, /peddler admin release <plotId>, and /peddler admin rentcollect are staff tools.
• /peddler reload reloads config.yml and messages.yml live.

Every command has tab completion.

Permissions

• peddler.use covers the directory, founding and managing stalls, and trading. Default: everyone.
• peddler.admin covers reload, the built-in economy tools, moderating any stall, and bypassing anchor protection. Default: operators.
• peddler.stalls.unlimited ignores the per-player stall limit. Default: nobody.

Configuration
The stall limit per player, the one-time creation cost, the max offers per stall, max stock, sales tax percent, price range and step sizes, the transaction log size, remote buying, and anchor block protection and materials are all in config.yml. Districts have their own toggle, rent interval, grace period, and plot list. All player-facing text is in messages.yml with full MiniMessage support. Run /peddler reload to apply changes without a restart.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• Vault and an economy plugin are optional. Without Vault, Peddler runs its own built-in economy.
• PlaceholderAPI is optional, for the %peddler_stalls%, %peddler_stall_limit%, %peddler_till%, %peddler_earnings%, and %peddler_directory% placeholders.

Installation

1. Put Peddler-1.0.0.jar in your plugins folder.
2. Start the server once to create config.yml and messages.yml.
3. Give a player a barrel, have them look at it, and run /peddler create.
4. Edit the config if you want, then run /peddler reload.

Try it first
Peddler is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to found a stall and try the directory before you buy.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.