Struct MerchantOffer 

#[non_exhaustive]
pub struct MerchantOffer {
    pub base_cost_a: ItemCost,
    pub cost_b: Option<ItemCost>,
    pub result: ItemStack,
    pub uses: i32,
    pub max_uses: i32,
    pub reward_exp: bool,
    pub special_price_diff: i32,
    pub demand: i32,
    pub price_multiplier: f32,
    pub xp: i32,
}

A merchant offer copied at an API boundary, not a reference into the game’s trade table.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

base_cost_a: ItemCost

Undiscounted first payment.

cost_b: Option<ItemCost>

Optional second payment.

result: ItemStack

Items received in exchange.

uses: i32

Trades already performed since restocking.

max_uses: i32

Trades allowed before the offer is out of stock.

reward_exp: bool

Whether completing this trade awards experience.

special_price_diff: i32

Player-specific price adjustment.

demand: i32

Demand accumulated during restocking.

price_multiplier: f32

Multiplier for demand and reputation price adjustments.

xp: i32

Villager experience awarded by this trade.

Implementations

impl MerchantOffer

pub fn new( base_cost_a: ItemCost, cost_b: Option<ItemCost>, result: ItemStack, max_uses: i32, xp: i32, price_multiplier: f32, ) -> MerchantOffer

Construct an unused offer with explicit payments, output, limits and experience. Discounts and demand begin at zero; completing it rewards experience.

pub fn cost_a_count(&self, host: &dyn Host) -> Option<u32>

The adjusted first payment count, or none if its item metadata is unavailable.

pub fn cost_a(&self, host: &dyn Host) -> Option<ItemStack>

First payment with demand and discounts applied.

pub fn cost_b(&self) -> Option<ItemStack>

The optional second payment.

pub fn out_of_stock(&self) -> bool

Whether this offer has exhausted its uses.

pub fn update_demand(&mut self)

Apply MerchantOffer.updateDemand to this snapshot.

pub fn satisfied_by( &self, host: &dyn Host, a: Option<&ItemStack>, b: Option<&ItemStack>, ) -> bool

Whether both payment slots satisfy this snapshot’s current price.

pub fn take( &self, host: &dyn Host, a: &mut Option<ItemStack>, b: &mut Option<ItemStack>, ) -> bool

Consume local payment values if satisfied. This does not change the game’s trade state.

Trait Implementations

impl Clone for MerchantOffer

fn clone(&self) -> MerchantOffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MerchantOffer

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

Formats the value using the given formatter.

impl PartialEq for MerchantOffer

fn eq(&self, other: &MerchantOffer) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MerchantOffer

impl Wire for MerchantOffer

const MIN: usize

Minimum encoded size, used to reject impossible collection lengths.

fn put(&self, out: &mut Writer)

Encodes this value, recording failures on the writer.

fn put_owned(self, out: &mut Writer)

Consumes owned data when a resource’s ownership must cross the boundary.

fn take(input: &mut Reader<'_>) -> Result<MerchantOffer, WireError>

Decodes one value, leaving any following bytes for the caller.