Prize Bot
Prize Bot
Docs / Auctions

Auctions

Create an auction

Ask a server manager to configure auction settings before the first auction. If a host role is set, you need that role or Manage Server permission to create auctions. Without a host role, anyone who can use the command can host.

  1. Run /settings auctions. Set the results channel with log_channel, then choose an auction mode and its destination category or channel.
  2. Run /auction create. Enter an item, a starting bid, and a duration, such as 1h.
  3. Add any optional rules below. Submit the command to start the auction. With Server Premium, set schedule to delay the start.
  4. Members run /bid in the auction channel or thread. Prize Bot updates the auction message as members bid.

When the auction ends, Prize Bot posts the result to the configured log channel. See Claims for prize delivery and Notifications for result DMs. Use Status boards to show active auctions and giveaways together.

Create auctions in bulk

Requires Server Premium.

  1. Open your server’s Auctions page in the dashboard and select Bulk create.
  2. Paste one item per line, then select Review defaults.
  3. Set the shared defaults, first start time, duration, and gap between auctions. Select Review rows.
  4. Check each row, correct any errors, then select Create … queued auctions. The batch appears in Queue.

Auction modes

Choose how auctions are displayed in your server. Configure via the dashboard or /settings auctions.

Channel (default)

Prize Bot creates a channel for each auction and deletes the channel when the auction ends.

Single

All auctions use one shared channel. If several auctions are active, /bid asks the bidder to select an auction.

Forum

Prize Bot creates a post in the selected forum channel. The post stays after the auction ends. Choose Forum when the destination is a Discord forum channel.

Thread

Prize Bot creates a thread in a regular text channel and archives the thread when the auction ends.

Auction types

  • Standard (default): the highest valid bid wins when the timer ends, provided the bid meets any target price.
  • Dutch: the price falls toward the floor price. The first accepted bid wins immediately.
  • Silent: hides the active high bid and bidder until the end. Set this separately from pricing with bid_visibility.

Commands

/auction create

Create a new auction.

item Name of the item being auctioned (required)
bid Starting bid amount (required)
duration How long the auction runs, e.g. 1h, 30m, 1d (required)
description Description of the item
currency One-time currency symbol for this auction
use_currency Winner pays with their currency balance
integer_only Only allow whole number bids
increment_min Minimum bid increment
increment_max Maximum bid increment
buyout Price to instantly win the auction
target_price Hidden minimum price (no winner if not reached)
target_price_visible Show the target price on the auction message
bid_role Role a member must have to bid
bid_visibility Use silent to hide the high bid and bidder until the auction ends
pricing Use dutch for a falling-price auction where the first accepted bid wins
dutch_floor_price Lowest price a Dutch auction can fall to
category Category to create the auction channel in
image Attach an image to the auction
schedule Delay before auction starts, e.g. 24h (Server Premium)
/bid [amount]

Place a bid in the current auction channel or thread. If several auctions are active in that channel, select the auction when prompted.

/auction queue

View scheduled auctions.

/auction end

End the auction in the current channel early.

/auction edit

Modify an active auction.

item Change the item name
host Change the auction host
bid Change the current bid
winner Set the current winner
extend Change the remaining time; use a negative duration to shorten it
description Change the description
currency Change the currency symbol
currency_side Left or right of amount
buyout Change the buyout price
target_price Change the hidden target price
target_price_visible Show the target price on the auction message
bid_role Role a member must have to bid
bid_visibility Switch between public and silent bid display
pricing Switch between standard and Dutch auction pricing
dutch_floor_price Change the Dutch floor price
image Change the image

Configuration

Open your server’s Auctions page in the dashboard for all settings. Use /settings auctions for the command settings below. Dashboard-only settings are marked:

log_channel Channel where auction results are posted when they end
category Category to create auction channels in
category_lock Dashboard-only toggle that forces auctions into the configured category
host_role Role allowed to create auctions. Manage Server permission bypasses this requirement. Leave empty to allow any command user.
alert_role Role to ping when auctions start
result_dms Dashboard-only toggle for end-of-auction DMs to the winner and recent bidders
integer_only Only allow whole number bids
use_currency Winner pays with their currency balance
snipe_range Remaining time to trigger anti-snipe (e.g. 5m)
snipe_extension Time to add when anti-snipe triggers (e.g. 2m)
snipe_limit Maximum extra time anti-snipe can add across all extensions
snipe_cap Maximum total auction runtime from start to finish, including extensions
mode How auctions are displayed (see Auction modes above)
channel Target channel for single/thread/forum modes
channel_prefix Prefix for auction channel names

Configure anti-snipe

Anti-snipe gives other bidders time to respond to a late bid. A bid within the configured range can extend the auction, subject to your limits.

  1. Set snipe_range to the remaining time that triggers an extension, such as 5m.
  2. Set snipe_extension to the extension duration, such as 2m.
  3. In the dashboard, choose a Snipe Mode. Add to Current End Time adds the duration to the existing end time. Extend From Bid Time measures the duration from the qualifying bid.
  4. Optionally set snipe_limit to cap the total extra time, and snipe_cap to cap the total runtime from the start.

Example: if an auction starts at 1:00 PM with a snipe limit of 10 minutes and a snipe cap of 2 hours, anti-snipe can add up to 10 extra minutes total, but the auction can never run past 3:00 PM.