logo

ClosingTimeCountdown

ClosingTimeCountdown defines the duration (in milliseconds) used to control how long an item stays in its closing phase โ€” and how long that phase is extended when new bids are received.

๐Ÿ”ง Required When: closingMethod = OVERLAPPING

Any sale using the OVERLAPPING closing method must set this value.
It ensures that every item in the sale has a clear, consistent rule for how long it can stay open once it begins closing.

๐Ÿ”„ How It Works

  • When an item enters ITEM_CLOSING, its closingEnd is initialized as:
    • closingEnd = closingStart + closingTimeCountdown
  • If a bid is placed after closingStart but before closingEnd, the countdown is reset:
    • closingEnd = now() + closingTimeCountdown
๐Ÿง  This creates an anti-sniping mechanism โ€” every valid bid placed in the final moments of an auction resets the clock, giving other bidders a fair chance to respond.

๐Ÿงช Example

If closingTimeCountdown = 120000 (2 minutes):
  • At 10:00:00 โ†’ item enters closing
    • โ†’ closingEnd = 10:02:00
  • A bid is placed at 10:01:15
    • โ†’ closingEnd = 10:03:15
  • Another bid comes at 10:02:45
    • โ†’ closingEnd = 10:04:45
โณ The auction keeps extending โ€” but never more than 2 minutes ahead of the current time.

Powered by Notaku