Ofertas de Intercambio
Este tema cubre el TradeOffer dentro del juego ofrecido por Villagers/Merchants.
Mercante
Un Merchant
es un contenedor para TradeOffers
. Su variable más común es el Villager
. La interfaz del Merchant
puede ser utilizada para abrir ventanas de intercambio.
Los TradeOffers
pueden ser añadidos a y removidos de los Merchants
usando TradeOfferData.
Oferta de Intercambio
Una oferta de intercambio consiste en
a primary/first buying ItemStackSnapshot
una segunda compra opcional
ItemStackSnapshot
una venta
ItemStackSnapshot
already used uses
usos maximos disponibles
una bandera indica si las particulas de experiencia se generan al intercambiar
El TradeOffers
puede ser creado usando a un Builder
o un TradeOfferGenerator.
ConstructordeOfertasdeIntercambio
Los TradeOfferBuilders``son usados principalmente si desea crear dinamicamente ``TradeOffers
sobre la marcha.
El siguiente bloque de códigos construye una nueva TradeOffer
que permite a Players
intercambiar cinco bloques DIRT
por tres bloques GRASS
. Esta oferta de intercambio tiene cuatro usos iniciales, luego de esto el Merchant
puede necesitar algo de tiempo para ofrecer de nuevo esta TradeOffer
.
TradeOffer offer = TradeOffer.builder()
.firstBuyingItem(ItemStack.of(ItemTypes.DIRT, 5))
.sellingItem(ItemStack.of(ItemTypes.GRASS, 3))
.uses(0)
.maxUses(4)
.canGrantExperience(false)
.build();
MuteadorDeListaDeOfertasDeIntercambio
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.
Nota
La lista de TradeOffer
en Villagers
podría generarse lentamente cuando se abre el inventario por primera vez.
TradeOfferGenerator
Los TradeOfferGenerators
son plantillas simples para el nuevo TradeOffers
. Son una variante del TradeOfferListMutator
que solo agregará nuevas entradas y no altera ni eliminará ningún TradeOffers
existente en ese aldeano.
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();
Este TradeOfferGenerator
generará aleatoriamente TradeOffers
que
comprar 5-8
DIRT
vender 5
GRASS
tiene 2-4 usos iniciales restantes
máximo 5 usos
La posibilidad de que el TradeOffer
generado otorgará experiencia es 50%.
Nota
Puedes usar ItemStackGenerators
para aplicar encantamientos dinamicamente u otros datos personalizados a los artículos de compra y venta.
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);
El mutador de nivel más bajo que se puede especificar es el nivel 1. Este es equivalente a un Villager
recién nacido.
Nota
Los cambios en el “VillagersRegistry” serán eliminados cuando se resetee el servidor y no tendrán ningún impacto en el “TradeOffers” de “Villagers” que hayan subido de nivel en el pasado.