Struct AuctionHouse 

pub struct AuctionHouse {
    pub listings: HashMap<u64, Listing>,
    pub bids: HashMap<u64, Vec<Bid>>,
    pub pending_mail: Vec<MailMessage>,
    pub listing_fee_rate: f32,
    pub cut_rate: f32,
    /* private fields */
}

Player-driven auction house.

Fields

listings: HashMap<u64, Listing>

bids: HashMap<u64, Vec<Bid>>

pending_mail: Vec<MailMessage>

Pending mail messages to be delivered to players.

listing_fee_rate: f32

Fraction of sale price taken as listing fee.

cut_rate: f32

Fraction of sale price taken as auction house cut.

Implementations

impl AuctionHouse

pub fn new() -> Self

pub fn post_listing( &mut self, seller_id: impl Into<String>, item_id: impl Into<String>, quantity: u32, quality: u8, buyout_price: Option<Currency>, min_bid: Currency, duration_secs: f32, current_time: f32, seller_currency: &mut Currency, ) -> Result<u64, String>

Post a new listing.

Returns Ok(listing_id) or Err with a reason. seller_currency is charged the listing fee upfront.

pub fn highest_bid(&self, listing_id: u64) -> Option<&Bid>

Get the current highest bid for a listing.

pub fn place_bid( &mut self, listing_id: u64, bidder_id: impl Into<String>, amount: Currency, current_time: f32, bidder_currency: &mut Currency, ) -> Result<(), String>

Place a bid on a listing.

Validates bid > current highest (and >= min_bid). Refunds the previous highest bidder. bidder_currency is debited the bid amount.

pub fn place_bid_str( &mut self, listing_id: u64, bidder_id: &str, amount: Currency, current_time: f32, bidder_currency: &mut Currency, ) -> Result<(), String>

Place a bid with explicit bidder_id string (preferred API).

pub fn buyout( &mut self, listing_id: u64, buyer_id: &str, current_time: f32, buyer_currency: &mut Currency, ) -> Result<(String, u32, u8), String>

Instant buyout of a listing.

buyer_currency is debited the buyout price. Seller receives payout minus AH cut via mail.

pub fn tick(&mut self, current_time: f32)

Advance time: expire listings, award to highest bidder, handle mail.

pub fn search( &self, current_time: f32, item_id: Option<&str>, max_price: Option<u64>, quality_min: Option<u8>, ) -> Vec<&Listing>

Search for active listings matching criteria.

• item_id: optional filter by item
• max_price: optional maximum buyout price in copper
• quality_min: optional minimum quality

pub fn listings_for_item( &self, current_time: f32, item_id: &str, ) -> Vec<&Listing>

All active listings for a specific item, sorted by buyout price ascending.

pub fn drain_mail(&mut self) -> Vec<MailMessage>

Drain pending mail messages (call this to deliver them to the mail system).

pub fn active_listing_count(&self, current_time: f32) -> usize

Number of active listings.

Trait Implementations

impl Clone for AuctionHouse

fn clone(&self) -> AuctionHouse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AuctionHouse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AuctionHouse

fn default() -> Self

Returns the “default value” for a type.