What are auctions?

Auctions are shop-like signs that can be used to sell items in an auction manner. i.e. allowing players to bid & outbid each other, and the winner buys the items.

note

Auctions is currently in beta, which means that specifics around auctions might still change and issues could arise. To limit the spread of any exploits that might occur, creating auctions is limited to premium users only for the duration of the beta.

How to create an Auction

Auctions can only be created:

• in claimed land
• on a shop plot (/plot set shop)
• chest or barrel, where there is empty space in front for a sign

It is important to note that auction items are not kept in the container. They are withdrawn by the server and saved virtually. The owner can retrieve the items by simply breaking the container, and ending the auction.

Command Usage: /auction create {duration days} {starting bid} [outbid amount] [instant sell price]

Fields:

• Duration: How many days this auction should go for (1 to 7 days)
• Starting: The minimum amount a bid can be (1g or more)
• Outbid [optional]: Specify the minimum amount players must outbid existing bids by. Default 1g.
• Instant [optional]: Specify an instant selling price for this auction. Allows players to /auction buy to immediately end the auction & win the items at that price. Default -1 (disabled)

Price fields can be modified at anytime using /auction modify {field} {new amount}. E.g. /auction modify outbid 3

This is also available in the form of buttons by right-clicking an auction you own

How to participate in an Auction

1. Preview the items
   /auction preview or right-click the auction
2. Check the minimum bid you can make
   
   Auction information available in /auction info as well as left-clicking an auction.
   If the auction has no bids, you can bid the starting amount (or higher). If the auction has any bids, you must outbid the current bid with the required outbid amount set by the auction.
3. Make your bid
   Use /auction bid {amount} or click the "Bid" button in Auction info.
   If you were charged successfully, your bid will be registered. Otherwise, you'll get an error message.

How do bids work

When you bid on an auction, your bid amount is immediately withdrawn from your balance. This is to avoid fake-bids and keep things fair.

• You can at anytime revoke your bid with /auction revoke and receive a refund.
• If you get outbid, you will be notified if you're online, or the next time you log on.
• If you'd like to increase your bid, you will only pay the difference from your current bid. You cannot decrease your bid.
• When the auction ends. if you won, you will receive your items in /claim. Otherwise, you will be refunded your bid.

Different ways auctions can end

1. Default way
   The auction duration passing
2. Owner intervention
   Auction owners can end auctions early using /auction end
3. Instant-sale
   If the auction has instant selling enabled, any player may use /auction buy to immediately buy the items at that price.
4. Container broken
   As mentioned above, if the owner breaks the container, the items will directly be returned to them.
   However, if the auction container is broken by anyone other than the owner, the items will drop naturally at that location.
5. Chunk overclaimed
   Since when a chunk gets overclaimed all items in containers are returned to the mayor, same logic applies to auctions.

Common logic for all endings
Everyone who did not win the items receives their bid back.