VillagerTradeLimiter/README.md
PretzelJohn afacf4adc8 Version 1.5.1:
* Add toggleable Shopkeepers support
* Made Citizens support toggleable

To-do:
* Add enchantments, data, etc. to ingredients and result
* Add config editor GUI in-game
2022-01-21 20:56:44 -05:00

8.0 KiB

VillagerTradeLimiter (VTL)

by PretzelJohn

Description:

This Minecraft plugin limits the villager trade deals that players can get.
Click here to see this plugin on Spigot.

Some information has moved to the Wiki!


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.
    database.mysql: Whether to use MySQL for the database (true) or SQLite (false)
    database.host: The IP address or domain name of your MySQL server. If the MySQL database is on the same server as your Minecraft server, leave this as 127.0.0.1
    database.port: The port number of your MySQL server. Usually 3306.
    database.database: The name of your MySQL database, or schema. You must create a database (schema) before using this plugin!
    database.username: The username to access your MySQL database.
    database.password: The password to access your MySQL database.
    database.encoding: If your MySQL database uses an encoding other than utf8, change this.
    database.useSSL: If your MySQL database can use SSL connections, set this to true!
    IgnoreCitizens: Whether to ignore Citizens NPCs from the Citizens plugin. If set to true, Citizens NPCs won't be affected by this plugin.
    IgnoreShopkeepers: Whether to ignore Shopkeepers NPCs from the Shopkeepers plugin. If set to true, Shopkeepers NPCs won't be affected by this plugin.
    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
    .Cooldown: Sets the time between restocks for the trade, and applies to ALL villagers. Once the player reaches the MaxUses, the cooldown begins. The trade is disabled for all villagers until the cooldown expires.
    FORMAT: <Number><interval>
    EXAMPLE: 30s = 30 seconds, 5m = 5 minutes, 4h = 4 hours, 7d = 7 days
    .Item1.Material:
    .Item2.Material:
    .Result.Material:
    Sets the material of the 1st or 2nd item in the trade
    WARNING: This cannot be undone!
    .Item1.Amount:
    .Item2.Amount:
    .Result.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