VillagerTradeLimiter/README.md
PretzelJohn 98be139384 Version 1.4.0:
* Added 1.18 and 1.18.1 support
* Migrated to NBT-API (thanks Jowcey!)
* Added MaxUses setting (thanks Jowcey!)
* Added fixed price and currency settings for both ingredients (Item1 and Item2) of a trade (thanks Jowcey!)
* Fixed config updater (thanks tchristofferson!)
* Updated readme
2021-12-15 15:30:01 -05:00

5.6 KiB

VillagerTradeLimiter (VTL)

by PretzelJohn

Description:

This Minecraft plugin limits the villager trade deals that players can get when they cure a zombie villager.


Commands:

Command Alias Description
/villagertradelimiter /vtl shows a help message
/villagertradelimiter reload /vtl reload reloads config.yml

Permissions:

Permission Description Default User(s)
villagertradelimiter.* Allows players to use /vtl and /vtl reload OP
villagertradelimiter.use Allows players to use /vtl OP
villagertradelimiter.reload Allows players to reload config.yml and messages.yml OP

Config:

  • Global settings: These settings apply to all villagers and villager trades.

    Setting Description
    bStats: This helps me keep track of what server versions are being used. Please leave this set to true.
    DisableTrading: Whether to disable all villager trading for all worlds, some worlds, or no worlds. Options:
    • Add world names for worlds that you want to completely disable ALL villager trading.
    • Set to true to disable trading in all worlds.
    • Set to false or [] to disable this feature.
    MaxHeroLevel: The maximum level of the "Hero of the Village" (HotV) effect that a player can have. This limits HotV price decreases. Options:
    • Set to -1 to disable this feature and keep vanilla behavior
    • Set to a number between 0 and 5 to set the maximum HotV effect level players can have
    MaxDiscount: The maximum discount (%) you can get from trading/healing zombie villagers. This limits reputation-based price decreases. Options:
    • Set to -1.0 to disable this feature and keep vanilla behavior
    • Set to a number between 0.0 and 1.0 to set the maximum discount a player can get. (NOTE: 30% = 0.3)
    MaxDemand: The maximum demand for all items. This limits demand-based price increases. Options:
    • Set to -1 to disable this feature and keep vanilla behavior
    • Set to 0 or higher to set the maximum demand for all items

    WARNING: The previous demand information cannot be recovered if it was higher than the MaxDemand.
  • Per-item settings: (Overrides:)

    Setting Description
    <item_name>: Override the global settings by adding as many of these as you need. Enchanted books must follow the format of name_level (mending_1). All other items must follow the format of item_name (stone_bricks).
    .Disabled: Disables any trade that contains the item (true/false)
    .MaxDiscount: Sets the maximum discount for this item (-1.0, or between 0.0 to 1.0)
    .MaxDemand: Sets the maximum demand for this item (-1, or 0+)
    .MaxUses: Sets the maximum number of times a player can make the trade before the villager is out of stock
    .Item1.Material:
    .Item2.Material:
    Sets the material of the 1st or 2nd item in the trade
    .Item1.Amount:
    .Item2.Amount:
    Sets the amount of the 1st or 2nd item in the trade
  • For the default config.yml, see: src/main/resources/config.yml