Oferty Sprzedaży

This topic covers the ingame TradeOffers offered by Villagers/Merchants.

Handlowiec

A Merchant is a container for TradeOffers. Its most common variant is the Villager. The Merchant interface can be used to open trading windows.

TradeOffers can be added to and removed from Merchants using TradeOfferData.

TradeOffer

Oferta handlowa składa się z

  • a primary/first buying ItemStackSnapshot

  • an optional secondary buying ItemStackSnapshot

  • a selling ItemStackSnapshot

  • już wykorzystane użycia

  • maksymalne dostępne użycia

  • a flag to indicate whether experience orbs are spawned on trade

TradeOffers can be created using a Builder or a TradeOfferGenerator.

TradeOfferBuilder

TradeOfferBuilders are mainly used if you want to dynamically create TradeOffers on the fly.

The following code block builds a new TradeOffer that allows Players to trade five DIRT into three GRASS block items. This trade offer has four initial uses, after that the Merchant might need some time to offer this TradeOffer again.

TradeOffer offer = TradeOffer.builder()
    .firstBuyingItem(ItemStack.of(ItemTypes.DIRT, 5))
    .sellingItem(ItemStack.of(ItemTypes.GRASS, 3))
    .uses(0)
    .maxUses(4)
    .canGrantExperience(false)
    .build();

TradeOfferListMutator

A TradeOfferListMutator is an interface that is invoked during Villager level ups. It can be used to replace existing TradeOffers (e.g. higher tier) and add new TradeOffers. Its simplest and only API provided variant is the TradeOfferGenerator. The different TradeOfferListMutators for each level and Career can be configured in the VillagerRegistry.

Informacja

The TradeOffer list in Villagers might be generated lazily when the trading inventory is opened for the first time.

TradeOfferGenerator

TradeOfferGenerators are simple templates for new TradeOffers. They are a variant of the TradeOfferListMutator that will only add new entries and does not alter or remove any existing TradeOffers on that villager.

TradeOfferGenerator tradeOfferGenerator = TradeOfferGenerator.builder()
        .setPrimaryItemGenerator(random -> ItemStack.of(ItemTypes.DIRT, random.nextInt(3) + 5))
        .setSellingGenerator(random -> ItemStack.of(ItemTypes.GRASS, 5))
        .startingUses(VariableAmount.baseWithVariance(2, 1))
        .maxUses(VariableAmount.fixed(5))
        .experienceChance(0.5)
        .build();

This TradeOfferGenerator will randomly generate TradeOffers that will

  • kup 5-8 DIRT

  • sprzedaj 5 GRASS

  • ma 2-4 pozostałe początkowe zastosowania

  • 5 maksymalnych użyć

Szansa, że wygenerowana TradeOffer przekaże doświadczenie wynosi 50%.

Informacja

You can use ItemStackGenerators to dynamically apply enchantments or other custom data to the buying and selling items.

VillagerRegistry

The VillagerRegistry can be obtained from the GameRegistry. It will be used to configure the TradeOfferListMutator that will be applied on a Villager’s level-up.

VillagerRegistry villagerRegistry = this.game.getRegistry().getVillagerRegistry();
List<TradeOfferListMutator> generators = new ArrayList<>(villagerRegistry.getMutatorsForCareer(Careers.FARMER, 1));
generators.addAll(additionalFarmerLevel1TradeOffers());
villagerRegistry.setMutators(Careers.FARMER, 1, generators);

The lowest specifiable level-up mutator is level 1. This is equivalent to a newly spawned Villager.

Informacja

Changes to the VillagerRegistry will be lost on server restart and won’t have any impact on the TradeOffers from Villagers that have levelled up in the past.