![VillagerBarter [1.14 - 1.21.x]](https://www.spigotmc.org/data/resource_icons/125/125643.jpg?1748842748){kind=icon}
VillagerBarter
VillagerBarter is a Bukkit plugin that enables villagers to automatically barter with nearby dropped items based on their trading recipes. This plugin simulates the experience of bartering like how you do with Piglins.
Features
Version Support
VillagerBarter is designed for Minecraft 1.21.x and has been tested against Spigot and Paper for this version series. While it may work on earlier or later versions, compatibility is not guaranteed. For best results, use with Minecraft 1.21.4 or later within the 1.21 series.
Supported Professions
The following professions are allowed to perform barters:
Configuration
The plugin generates a configuration file on first run. You can control behavior per-world and per-profession. Below is an example configuration:
How It Works
Notes
VillagerBarter is a Bukkit plugin that enables villagers to automatically barter with nearby dropped items based on their trading recipes. This plugin simulates the experience of bartering like how you do with Piglins.
Features
- Villagers automatically check for nearby dropped items every 5 seconds.
- If a valid trade can be made using dropped items, the villager:
- Plays pickup and trade sounds.
- Faces the nearest player (if any).
- Drops the trade result item naturally.
- Increments the recipe usage count.
- Trades are limited to villagers of certain professions and levels (1–5).
- Supports multi-ingredient trades (up to 2 items).
Version Support
VillagerBarter is designed for Minecraft 1.21.x and has been tested against Spigot and Paper for this version series. While it may work on earlier or later versions, compatibility is not guaranteed. For best results, use with Minecraft 1.21.4 or later within the 1.21 series.
Supported Professions
The following professions are allowed to perform barters:
- Armorer
- Butcher
- Cartographer
- Cleric
- Farmer
- Fisherman
- Fletcher
- Leatherworker
- Librarian
- Mason
- Shepherd
- Toolsmith
- Weaponsmith
Configuration
The plugin generates a configuration file on first run. You can control behavior per-world and per-profession. Below is an example configuration:
Code (Text):
worlds:
world:
armorer:
enabled: true
search_radius: 3
delay_ticks: 60
min_level: 1
max_level: 5
world:
armorer:
enabled: true
search_radius: 3
delay_ticks: 60
min_level: 1
max_level: 5
- Every 5 seconds, the plugin scans all villagers in loaded worlds.
- If a villager is within the allowed professions and level range, it scans for nearby dropped items.
- If the dropped items match a valid recipe:
- Items are consumed.
- The villager simulates pickup behavior.
- The trade is performed and the result is dropped.
- The villager may face the nearest player.
- Recipes are updated to reflect usage.
Notes
- Items set for trading are made unpickable to avoid interference.
- Trades with maxed-out usage will be skipped.
- Villagers do not level up automatically, that is currently a bug and will be fixed in the next release
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
VillagerBarter [1.14 - 1.21.x] is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 155 times (via Spigot). Download it and open it directly in the game.