Random visits
Pick the days and UTC hours it may come, how many visits per day, the gap between them and how long it stays. The exact time stays a surprise, even after a restart.
Discord merchant bot: a wandering trader with surprise visits
The Wandering Merchant brings a little surprise to your server economy. At a random moment inside the hours you choose, it arrives in one of your channels, offers a few items drawn from a stock pool you build, and leaves after a set time with a short summary of what it sold. It is off by default and needs the Shop and the Bank.
market-squareDiscord preview
What you get
Fresh offers every time
Each visit draws a few different items from your pool by weight. Mark an item as rare and it shows up far less often, with a ✨ next to it.
Its own prices
Every pool entry has its own price in coins, cheaper or dearer than the Shop. Shop sales and other discounts don’t apply: the merchant’s price is the price.
Limited stock, never oversold
Set the stock per visit and a per-member limit. Each purchase locks the offer first, so two members racing for the last unit can never both get it.
Merchant-only items
Switch an item off in the Shop and keep it in the pool: now only the merchant sells it. Every unit is a normal Shop purchase, so inventory, refunds, the Market and trades just work.
Console and Flows
See every visit with what sold and who bought, summon the merchant now, and react in Flows when it arrives, leaves or makes a sale.
How it works
Turn on the Shop and the Bank
The merchant sells Shop items for Bank coins. Open https://console.botgg.app, enable both, then turn on the Wandering Merchant in the Engagement section.
Build the stock pool
Pick plain Shop items and set a price, the stock per visit, a per-member limit and a weight for each. Mark the special ones as rare.
Set the channels and windows
Choose the channels it may visit, an optional role to ping, the visit windows, visits per day, how long it stays and how many offers it brings. A live preview shows the message in the bot’s language.
Members buy while it is here
The visit message has a button per offer. A member presses one, picks how many and pays from their Bank balance. When time is up, the message changes to a short summary.
A limited-time shop that comes to your members
The Shop is always open, so members can plan every purchase. The merchant is different: it turns up when nobody expects it, brings only a few offers and leaves again, so a chat that is active at the right moment gets the rare deal. Each visit lands at a random point inside your windows, and several visits in one day are spread out instead of bunched together.
Members can type /merchant at any time. While a visit is live it shows the channel, the offers with stock left and when the merchant leaves, with a button to jump to the message. When the merchant is away it only says when the next window opens, never the exact time.
- Visit windows by weekday and UTC hour, with presets for every day, evenings and weekends
- Up to 25 units in one purchase, within the stock left and the per-member limit
- A random channel from your list for every visit, plus an optional ping role
- Name, emoji, greeting, image and color of your own merchant
Safe purchases on top of your Shop
Every unit the merchant sells goes through the same purchase path as the Shop: its own purchase row, its own Bank transaction and the usual Shop log entry. A purchase is all or nothing, the Shop’s own stock and per-member limit still count, and a price that changed after the buy card was shown is refused instead of charged. Merchant prices are at least 1 coin, so every unit counts as paid for your server’s paid-coin rules. Only plain items can be sold here; roles, colors and staff-delivered items stay in the Shop.
In the console, the Visits tab shows 30-day totals, the live or planned visit and a history with every purchase, and Summon now brings the merchant at once. The Server Doctor warns when the merchant is on but has no stock, no channel or no permission to post. Pool entries per server: 10 on Free, 50 on Pro.
Slash commands
Generated from the bot’s real command definitions. Full list on the commands page.
/merchantSee the Wandering Merchant: what they sell now, or when they may come byFree vs Pro
Every feature works on the Free plan. Pro raises the limits and unlocks extras.
| Limit | Free | Pro |
|---|---|---|
| Merchant stock pool entries | 10 | 50 |
| Merchant visits per day | 2 | 6 |
| Merchant channels | 1 | 5 |
Frequently asked questions
How do I add a wandering merchant to my Discord server?
Enable the Shop and the Bank in the web console, turn on the Wandering Merchant, add a few Shop items to its stock pool and choose its channels and visit windows. It plans its first visit by itself.
Can members find out when the merchant comes?
/merchant tells them when the next visit window opens, not the exact time, so the surprise stays. Staff see the planned time in the console, and an optional ping role lets members get notified when it arrives.
Do Shop sales or the Deal of the day lower merchant prices?
No. The merchant charges the price you set for each pool entry. Shop sales, the Deal of the day and the Server Weather discount don’t apply to it.
Can the merchant sell items that aren’t in the Shop?
Every offer is a plain Shop item, but it can be one you switched off in the Shop. Then members can’t buy it with /shop or /buy, and the merchant is the only one who sells it.
What happens if two members buy the last unit at once?
Each purchase locks the offer before it checks the stock, so the clicks are handled one after another. The first member gets the unit and the second sees that it’s sold out. Nobody pays for something they don’t get.
How many visits and channels can I have?
Visits per day: up to 2 on Free and 6 on Pro. Merchant channels: 1 on Free, 5 on Pro. See pricing for every plan limit.
Ready to level up your server?
Add BotGG for free, then switch features on in the web console.