程序包 org.bukkit.inventory

# 类 MerchantRecipe

java.lang.Object
org.bukkit.inventory.MerchantRecipe

所有已实现的接口:
  `Recipe`

public class MerchantRecipe extends Object implements Recipe
Represents a merchant's trade.

Trades can take one or two ingredients, and provide one result. The ingredients' ItemStack amounts are respected in the trade.

A trade has a maximum number of uses. A `Villager` may periodically replenish its trades by resetting the `uses` of its merchant recipes to `0`, allowing them to be used again.

A trade may or may not reward experience for being completed.

During trades, the `MerchantRecipe` dynamically adjusts the amount of its first ingredient based on the following criteria:

- `Demand`: This value is periodically updated by the villager that owns this merchant recipe based on how often the recipe has been used since it has been last restocked in relation to its `maximum uses`. The amount by which the demand influences the amount of the first ingredient is scaled by the recipe's `price multiplier`, and can never be below zero.
- `Special price`: This value is dynamically updated whenever a player starts and stops trading with a villager that owns this merchant recipe. It is based on the player's individual reputation with the villager, and the player's currently active status effects (see `PotionEffectType.HERO_OF_THE_VILLAGE`). The influence of the player's reputation on the special price is scaled by the recipe's `price multiplier`.

The adjusted amount of the first ingredient is calculated by adding up the original amount of the first ingredient, the demand scaled by the recipe's `price multiplier` and truncated to the next lowest integer value greater than or equal to 0, and the special price, and then constraining the resulting value between `1` and the item stack's `maximum stack size`.

- ## 构造器概要

  构造器
  构造器
  说明
  `MerchantRecipe(@NotNull ItemStack result, int maxUses)`
  `MerchantRecipe(@NotNull ItemStack result, int uses, int maxUses, boolean experienceReward)`
  `MerchantRecipe(@NotNull ItemStack result, int uses, int maxUses, boolean experienceReward, int villagerExperience, float priceMultiplier)`
  `MerchantRecipe(@NotNull ItemStack result, int uses, int maxUses, boolean experienceReward, int villagerExperience, float priceMultiplier, int demand, int specialPrice)`

- ## 方法概要

  修饰符和类型
  方法
  说明
  `void`
  `addIngredient(@NotNull ItemStack item)`
  `void`
  `adjust(@Nullable ItemStack itemStack)`
  Modifies the amount of the given `ItemStack` in the same way as MerchantRecipe dynamically adjusts the amount of the first ingredient during trading.
  `@Nullable ItemStack`
  `getAdjustedIngredient1()`
  Gets the `adjusted` first ingredient.
  `int`
  `getDemand()`
  Get the demand for this trade.
  `@NotNull List<ItemStack>`
  `getIngredients()`
  `int`
  `getMaxUses()`
  Get the maximum number of uses this trade has.
  `float`
  `getPriceMultiplier()`
  Gets the price multiplier for the cost of this trade.
  `@NotNull ItemStack`
  `getResult()`
  得到这个配方的结果.
  `int`
  `getSpecialPrice()`
  Get the special price for this trade.
  `int`
  `getUses()`
  Get the number of times this trade has been used.
  `int`
  `getVillagerExperience()`
  Gets the amount of experience the villager earns from this trade.
  `boolean`
  `hasExperienceReward()`
  Whether to reward experience to the player for the trade.
  `void`
  `removeIngredient(int index)`
  `void`
  `setDemand(int demand)`
  Set the demand for this trade.
  `void`
  `setExperienceReward(boolean flag)`
  Set whether to reward experience to the player for the trade.
  `void`
  `setIngredients(@NotNull List<ItemStack> ingredients)`
  `void`
  `setMaxUses(int maxUses)`
  Set the maximum number of uses this trade has.
  `void`
  `setPriceMultiplier(float priceMultiplier)`
  Sets the price multiplier for the cost of this trade.
  `void`
  `setSpecialPrice(int specialPrice)`
  Set the special price for this trade.
  `void`
  `setUses(int uses)`
  Set the number of times this trade has been used.
  `void`
  `setVillagerExperience(int villagerExperience)`
  Sets the amount of experience the villager earns from this trade.

  ### 从类继承的方法 java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## 构造器详细资料

  - ### MerchantRecipe

    public MerchantRecipe(@NotNull @NotNull ItemStack result, int maxUses)

  - ### MerchantRecipe

    public MerchantRecipe(@NotNull @NotNull ItemStack result, int uses, int maxUses, boolean experienceReward)

  - ### MerchantRecipe

    public MerchantRecipe(@NotNull @NotNull ItemStack result, int uses, int maxUses, boolean experienceReward, int villagerExperience, float priceMultiplier)

  - ### MerchantRecipe

    public MerchantRecipe(@NotNull @NotNull ItemStack result, int uses, int maxUses, boolean experienceReward, int villagerExperience, float priceMultiplier, int demand, int specialPrice)

- ## 方法详细资料

  - ### getResult

    @NotNull public @NotNull ItemStack getResult()
    从接口复制的说明: `Recipe`
    得到这个配方的结果.

    原文: Get the result of this recipe.

    指定者:
      `getResult` 在接口中 `Recipe`
    返回:
      `ItemStack`

  - ### addIngredient

    public void addIngredient(@NotNull @NotNull ItemStack item)

  - ### removeIngredient

    public void removeIngredient(int index)

  - ### setIngredients

    public void setIngredients(@NotNull @NotNull List<ItemStack> ingredients)

  - ### getIngredients

    @NotNull public @NotNull List<ItemStack> getIngredients()

  - ### getAdjustedIngredient1

    @Nullable public @Nullable ItemStack getAdjustedIngredient1()
    Gets the `adjusted` first ingredient.
    返回:
      the adjusted first ingredient, or `null` if this recipe has no ingredients
    另请参阅:
      - `adjust(ItemStack)`

  - ### adjust

    public void adjust(@Nullable @Nullable ItemStack itemStack)
    Modifies the amount of the given `ItemStack` in the same way as MerchantRecipe dynamically adjusts the amount of the first ingredient during trading.
    This is calculated by adding up the original amount of the item, the demand scaled by the recipe's `price multiplier` and truncated to the next lowest integer value greater than or equal to 0, and the special price, and then constraining the resulting value between `1` and the `ItemStack`'s `maximum stack size`.
    参数:
      `itemStack` - the item to adjust

  - ### getDemand

    public int getDemand()
    Get the demand for this trade.
    返回:
      the demand

  - ### setDemand

    public void setDemand(int demand)
    Set the demand for this trade.
    参数:
      `demand` - the new demand

  - ### getSpecialPrice

    public int getSpecialPrice()
    Get the special price for this trade.
    返回:
      special price value

  - ### setSpecialPrice

    public void setSpecialPrice(int specialPrice)
    Set the special price for this trade.
    参数:
      `specialPrice` - special price value

  - ### getUses

    public int getUses()
    Get the number of times this trade has been used.
    返回:
      the number of uses

  - ### setUses

    public void setUses(int uses)
    Set the number of times this trade has been used.
    参数:
      `uses` - the number of uses

  - ### getMaxUses

    public int getMaxUses()
    Get the maximum number of uses this trade has.
    返回:
      the maximum number of uses

  - ### setMaxUses

    public void setMaxUses(int maxUses)
    Set the maximum number of uses this trade has.
    参数:
      `maxUses` - the maximum number of time this trade can be used

  - ### hasExperienceReward

    public boolean hasExperienceReward()
    Whether to reward experience to the player for the trade.
    返回:
      whether to reward experience to the player for completing this trade

  - ### setExperienceReward

    public void setExperienceReward(boolean flag)
    Set whether to reward experience to the player for the trade.
    参数:
      `flag` - whether to reward experience to the player for completing this trade

  - ### getVillagerExperience

    public int getVillagerExperience()
    Gets the amount of experience the villager earns from this trade.
    返回:
      villager experience

  - ### setVillagerExperience

    public void setVillagerExperience(int villagerExperience)
    Sets the amount of experience the villager earns from this trade.
    参数:
      `villagerExperience` - new experience amount

  - ### getPriceMultiplier

    public float getPriceMultiplier()
    Gets the price multiplier for the cost of this trade.
    返回:
      price multiplier

  - ### setPriceMultiplier

    public void setPriceMultiplier(float priceMultiplier)
    Sets the price multiplier for the cost of this trade.
    参数:
      `priceMultiplier` - new price multiplier