Barter
Barter adds a reputation system to villager trading. Every trade a player completes builds standing with that villager type, standing moves the player up through configurable tiers, and each tier unlocks a discount plus extra trades that are not in vanilla Minecraft. The result is a trading system that rewards players for actually using it instead of a flat one-time unlock.
Built for: Survival and SMP servers that want villager trading to feel like a system with progress, not a one-off exchange.
How reputation works
Extra trades per profession
Server owners add extra trades per villager profession in config.yml: any material in, any material out, any amount, any tier requirement, and a max use count before the trade needs to restock. An admin panel (/barter gui) browses every profession and its configured trades without opening a single file.
Each trade shows its cost, the reputation tier required to unlock it, and how many uses it has before restocking. The panel is read-only, browsing only, so staff can check the setup without risking a misclick changing anything.
Extra trades in the actual trade window
Once a player reaches the right tier, the extra trades appear in the normal villager trade window alongside the vanilla ones, discounted by whatever their current tier grants. Nothing about the trade window looks modded. It is still the villager the player already knows how to use.
Checking your standing
/barter rep shows a player their current tier, their point total, and how many points remain to the next tier. /barter top lists the server's highest standing players.
Restocking
Barter can refresh the trades of villagers it manages on a fixed timer, separate from the vanilla workstation refresh. Only villagers a player has opened while the plugin is active are touched, and only villagers in loaded chunks, so the cost stays bounded on a busy server.
Commands
Permissions
Configuration
Points per trade, the first-trade bonus, the gain cooldown, every tier's point threshold and discount, the restock timer, sounds, and the action bar toggle are all in config.yml with a comment on every option. Extra trades per profession are configured the same file: material, amount, result, tier requirement, max uses, and villager experience granted. All player-facing text is in messages.yml with full MiniMessage support. Run /barter reload to apply changes without a restart.
PlaceholderAPI
If PlaceholderAPI is installed, Barter registers %barter_points%, %barter_tier%, %barter_next_tier%, and %barter_points_to_next%.
Requirements
Installation
Try it first
Barter is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to trade with a villager and check your standing before you buy.
Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.
Barter adds a reputation system to villager trading. Every trade a player completes builds standing with that villager type, standing moves the player up through configurable tiers, and each tier unlocks a discount plus extra trades that are not in vanilla Minecraft. The result is a trading system that rewards players for actually using it instead of a flat one-time unlock.
Built for: Survival and SMP servers that want villager trading to feel like a system with progress, not a one-off exchange.
How reputation works
- A completed trade grants reputation points, with a bonus the first time a player trades with a brand new villager.
- A short cooldown between reputation gains from the same villager stops a player from farming one trade for unlimited standing.
- Five tiers ship by default: Wary, Known, Trusted, Honored, and Revered. Each tier needs more points and grants a bigger discount on the emerald (or first ingredient) cost of every trade.
- Reaching a tier also unlocks any extra trade configured to require it.
- A tier-up plays a sound and shows in chat and the action bar, both configurable.
Extra trades per profession
Server owners add extra trades per villager profession in config.yml: any material in, any material out, any amount, any tier requirement, and a max use count before the trade needs to restock. An admin panel (/barter gui) browses every profession and its configured trades without opening a single file.
Each trade shows its cost, the reputation tier required to unlock it, and how many uses it has before restocking. The panel is read-only, browsing only, so staff can check the setup without risking a misclick changing anything.
Extra trades in the actual trade window
Once a player reaches the right tier, the extra trades appear in the normal villager trade window alongside the vanilla ones, discounted by whatever their current tier grants. Nothing about the trade window looks modded. It is still the villager the player already knows how to use.
Checking your standing
/barter rep shows a player their current tier, their point total, and how many points remain to the next tier. /barter top lists the server's highest standing players.
Restocking
Barter can refresh the trades of villagers it manages on a fixed timer, separate from the vanilla workstation refresh. Only villagers a player has opened while the plugin is active are touched, and only villagers in loaded chunks, so the cost stays bounded on a busy server.
Commands
- /barter (aliases /bt, /trades) opens the admin panel for staff, or shows your own standing for everyone else.
- /barter rep [player] shows your own standing, or another player's for staff.
- /barter top lists the top 10 players by reputation.
- /barter gui opens the admin panel directly.
- /barter give <player> <amount> adds or removes reputation points.
- /barter reset <player> resets a player's reputation, with a confirmation step.
- /barter reload reloads config.yml and messages.yml live.
Permissions
- barter.use covers checking your own standing and the top list. Default: everyone.
- barter.admin covers the admin panel, give, reset, and reload. Default: operators.
Configuration
Points per trade, the first-trade bonus, the gain cooldown, every tier's point threshold and discount, the restock timer, sounds, and the action bar toggle are all in config.yml with a comment on every option. Extra trades per profession are configured the same file: material, amount, result, tier requirement, max uses, and villager experience granted. All player-facing text is in messages.yml with full MiniMessage support. Run /barter reload to apply changes without a restart.
PlaceholderAPI
If PlaceholderAPI is installed, Barter registers %barter_points%, %barter_tier%, %barter_next_tier%, and %barter_points_to_next%.
Requirements
- Minecraft 1.21 to 26.1.2.
- Paper, Spigot, or Bukkit.
- Java 21.
- PlaceholderAPI is optional.
Installation
- Put Barter-1.0.0.jar in your plugins folder.
- Start the server once to create config.yml and messages.yml.
- Edit the extra trades and tiers in config.yml if you want, then run /barter reload.
Try it first
Barter is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to trade with a villager and check your standing before you buy.
Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.
