The shop

Let members spend what they earn on items, roles, and one-of-a-kind codes. Free.

A shop gives members something to do with the Coins and XP they earn. They buy items, claim special roles, and grab one-time codes, and it's free.

What it does

You list items with a price; members buy them with /shop and /buy. A purchase can:

• grant a role (a "Supporter" tier, a cosmetic, channel access, your call), and/or
• hand out a code from a pool you upload (a Steam key, a discount code, a whitelist code).

Setting it up

In the admin panel, open Shop and add items. For each item set:

• Name and description.
• Currency: Coins (your server's economy balance), XP, or (crypto, optional) an on-chain token.
• Price.
• Stock, either a fixed quantity or unlimited.
• Delivery: Standard (an optional role grant) or Code pool.
• (Optional) a role to grant on purchase.

You can also restrict /shop and /buy to a single channel to keep things tidy.

Code-pool items

For a code-pool item you paste in a list of codes (one per line). Each purchase hands the buyer the next unused code, shown privately and sent to their DMs, and the item's stock is simply how many unused codes are left. When the pool runs dry, the item shows out of stock and no one is charged. Duplicate and blank lines are ignored, and you can top the pool up anytime. Codes are treated as sensitive: once handed out, a code's value is cleared from the database after a while (the who/when record stays).

Code pools are sold for Coins, XP, or Points only, not on-chain tokens.

Member experience

• /shop privately lists what's available with its complete description, price, and stock. Larger catalogs are split into several messages automatically, so you do not need to shorten useful item instructions to fit one Discord card.
• /buy <item> purchases it. For Coins, XP, or Points, it's instant: the currency is deducted and any role or code is delivered right away.
• (crypto, optional) For token-priced items, the member pays from their own wallet via a Solana Pay link/QR. Nothing is custodial, and the reward is delivered once payment is confirmed.

Tips

• A "Supporter" role priced in Coins is a popular, simple first item.
• Stock is shared across everyone (not per member), so use it for limited drops.
• Code pools are perfect for allowlist spots, giveaway keys, or partner discount codes.
• Token-priced items need your server's treasury wallet configured; most communities just use Coins or XP.