Package net.fabricmc.fabric.api.object.builder.v1.trade

Interface TradeOfferHelper.WanderingTraderOffersBuilder

Enclosing class:

TradeOfferHelper

@NonExtendable
@Experimental
public static interface TradeOfferHelper.WanderingTraderOffersBuilder

A builder for rebalanced wandering trader offers.

Experimental feature. This API may receive changes as necessary to adapt to further experiment changes.

See Also:

• TradeOfferHelper.registerRebalancedWanderingTraderOffers(Consumer)

Field Summary

Fields

Modifier and Type	Field	Description
static final Identifier	BUY_ITEMS_POOL	The pool ID for the "buy items" pool.
static final Identifier	SELL_COMMON_ITEMS_POOL	The pool ID for the "sell common items" pool.
static final Identifier	SELL_SPECIAL_ITEMS_POOL	The pool ID for the "sell special items" pool.

Method Summary

Modifier and Type	Method	Description
default TradeOfferHelper.WanderingTraderOffersBuilder	addAll(Identifier id, Collection<? extends TradeOffers.Factory> factories)	Adds trade offers to the offer list.
default TradeOfferHelper.WanderingTraderOffersBuilder	addAll(Identifier id, TradeOffers.Factory... factories)	Adds trade offers to the offer list.
default TradeOfferHelper.WanderingTraderOffersBuilder	addOffersToPool(Identifier pool, Collection<TradeOffers.Factory> factories)	Adds trade offers to an existing pool identified by an ID.
TradeOfferHelper.WanderingTraderOffersBuilder	addOffersToPool(Identifier pool, TradeOffers.Factory... factories)	Adds trade offers to an existing pool identified by an ID.
default TradeOfferHelper.WanderingTraderOffersBuilder	pool(Identifier id, int count, Collection<? extends TradeOffers.Factory> factories)	Adds a new pool to the offer list.
TradeOfferHelper.WanderingTraderOffersBuilder	pool(Identifier id, int count, TradeOffers.Factory... factories)	Adds a new pool to the offer list.

Field Details

BUY_ITEMS_POOL

static final Identifier BUY_ITEMS_POOL

The pool ID for the "buy items" pool. Two trade offers are picked from this pool.

In vanilla, this pool contains offers to buy water buckets, baked potatoes, etc. for emeralds.

SELL_SPECIAL_ITEMS_POOL

static final Identifier SELL_SPECIAL_ITEMS_POOL

The pool ID for the "sell special items" pool. Two trade offers are picked from this pool.

In vanilla, this pool contains offers to sell logs, enchanted iron pickaxes, etc.

SELL_COMMON_ITEMS_POOL

static final Identifier SELL_COMMON_ITEMS_POOL

The pool ID for the "sell common items" pool. Five trade offers are picked from this pool.

In vanilla, this pool contains offers to sell flowers, saplings, etc.

Method Details

pool

TradeOfferHelper.WanderingTraderOffersBuilder pool(Identifier id,
 int count,
 TradeOffers.Factory... factories)

Adds a new pool to the offer list. Exactly count offers are picked from factories and offered to customers.

Parameters:

id - the ID to be assigned to this pool, to allow further modification

count - the number of offers to be picked from factories

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IllegalArgumentException - if count is not positive or if factories is empty

pool

default TradeOfferHelper.WanderingTraderOffersBuilder pool(Identifier id,
 int count,
 Collection<? extends TradeOffers.Factory> factories)

Adds a new pool to the offer list. Exactly count offers are picked from factories and offered to customers.

Parameters:

id - the ID to be assigned to this pool, to allow further modification

count - the number of offers to be picked from factories

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IllegalArgumentException - if count is not positive or if factories is empty

addAll

default TradeOfferHelper.WanderingTraderOffersBuilder addAll(Identifier id,
 Collection<? extends TradeOffers.Factory> factories)

Adds trade offers to the offer list. All offers from factories are offered to each customer.

Parameters:

id - the ID to be assigned to this pool, to allow further modification

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IllegalArgumentException - if factories is empty

addAll

default TradeOfferHelper.WanderingTraderOffersBuilder addAll(Identifier id,
 TradeOffers.Factory... factories)

Adds trade offers to the offer list. All offers from factories are offered to each customer.

Parameters:

id - the ID to be assigned to this pool, to allow further modification

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IllegalArgumentException - if factories is empty

addOffersToPool

TradeOfferHelper.WanderingTraderOffersBuilder addOffersToPool(Identifier pool,
 TradeOffers.Factory... factories)

Adds trade offers to an existing pool identified by an ID.

See the constants for vanilla trade offer pool IDs that are always available.

Parameters:

pool - the pool ID

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IndexOutOfBoundsException - if pool is out of bounds

addOffersToPool

default TradeOfferHelper.WanderingTraderOffersBuilder addOffersToPool(Identifier pool,
 Collection<TradeOffers.Factory> factories)

Adds trade offers to an existing pool identified by an ID.

See the constants for vanilla trade offer pool IDs that are always available.

Parameters:

pool - the pool ID

factories - the trade offer factories

Returns:

this builder, for chaining

Throws:

IndexOutOfBoundsException - if pool is out of bounds