Go to file
PretzelJohn 446e677336 Version 1.4.4:
* Added feature to increase discounts by setting MaxDiscount to a number greater than 1.0
2021-12-23 02:17:49 -05:00
src Version 1.4.4: 2021-12-23 02:17:49 -05:00
.gitignore Version 1.4.0: 2021-12-15 15:30:01 -05:00
README.md Version 1.4.4: 2021-12-23 02:17:49 -05:00
pom.xml Version 1.4.4: 2021-12-23 02:17:49 -05:00

README.md

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 limit the maximum discount a player can get. (NOTE: 30% = 0.3)
    • Set to a number above 1.0 to increase the maximum discount a player can get. (NOTE: 250% = 2.5)
    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.
    MaxUses: The maximum number of times a player can make any trade before a villager is out of stock.
    Options:
    • Set to -1 to disable this feature and keep vanilla behavior
    • Set to 0 or higher to change the maximum number of uses for all items
  • 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
    WARNING: This cannot be undone!
    .Item1.Amount:
    .Item2.Amount:
    Sets the amount of the 1st or 2nd item in the trade
    WARNING: This cannot be undone!
  • For the default config.yml, see: src/main/resources/config.yml