This Minecraft plugin limits the villager trade deals that players can get.
Supports Spigot, Paper, and Purpur servers from 1.14.1 to the current version.
Click here to see this plugin on Spigot.
Some information has moved to the Wiki!
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. |
IgnoreHeldItems: |
A list of item types where, when the player interacts with a villager while holding one of these items, VTL doesn't affect the interaction. This is used for compatibility with other plugins, like the custom spawn eggs in SafariNet. Options:
|
DisableTrading: |
Whether to disable all villager trading for all worlds, some worlds, or no worlds. Options:
|
MaxHeroLevel: |
The maximum level of the "Hero of the Village" (HotV) effect that a player can have. This limits HotV price decreases. Options:
|
MaxDiscount: |
The maximum discount (%) you can get from trading/healing zombie villagers. This limits reputation-based price decreases. Options:
|
MaxDemand: |
The maximum demand for all items. This limits demand-based price increases. Options:
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:
|
Per-item override 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> Examples: 30s = 30 seconds, 5m = 5 minutes, 4h = 4 hours, 7d = 7 days |
.Item1.Material:.Item2.Material:.Result.Material: |
Sets the material of the 1st, 2nd, or result item in the trade WARNING: This cannot be undone! |
.Item1.Amount:.Item2.Amount:.Result.Amount: |
Sets the amount of the 1st, 2nd, or result item in the trade WARNING: This cannot be undone! |
For the default config.yml, see src/main/resources/config.yml