VTE

VillagerTradeEditor

Initial public release of VillagerTradeEditor by RealKnight.

VillagerTradeEditor is an admin-only Paper plugin that lets server staff edit villagers directly in-game through a GUI.

Features

• Admin-only villager editor
• Right-click villager selection mode
• Special editor tool with /vte tool
• Full villager trade editor GUI
• Add new trades
• Edit existing trades in-place
• Change trade ingredients
• Change trade result item
• Change max uses, current uses, villager XP, demand, special price, and price multiplier
• Delete trades
• Clear trades with confirmation
• Refresh vanilla trades
• Set villager level from Novice through Master
• Generate trades up to the selected level, so Master includes earlier trade tiers too
• Change villager profession
• Profession menu uses clean workstation labels, such as Farmer - Composter and Librarian - Lectern
• Change villager type/biome
• Change baby/adult state
• Toggle AI, glowing, gravity, silent, collision, invulnerability, persistence, and despawn behavior where supported
• Edit villager name with /vte name <name>
• Clear villager name with /vte clearname
• Safe permission checks so normal players can still trade normally

Commands

• /vte — Open editor for the villager you are looking at
• /vte select — Toggle right-click villager selection mode
• /vte tool — Get the villager editor tool
• /vte name <name> — Rename the currently selected villager
• /vte clearname — Clear the selected villager’s custom name
• /vte reload — Reload plugin config/messages
• /villagertrades — Alias command

Permissions

• villagertradeeditor.use — Allows use of the villager editor
• villagertradeeditor.reload — Allows reloading the plugin

OPs receive permissions by default.

How to Use

1. Install the jar in your server’s plugins folder.
2. Restart the server.
3. Run /vte tool.
4. Right-click a villager with the editor tool.
5. Edit trades, profession, level, type, name, and other villager settings from the GUI.

You can also run /vte select and right-click a villager without using the tool.

Vanilla Trading Notes

VillagerTradeEditor only opens the editor when an admin is using selection mode or the editor tool. Normal villagers and normal player trading are left alone.

Setting a level only changes the villager’s level and XP. Refreshing vanilla trades is a separate confirmed action and will replace current trades with newly generated vanilla trades up to that level.

Custom trades may behave slightly differently from Mojang-generated trades depending on what the Paper/Bukkit API supports.

Compatibility

• Built for Paper 1.21.x
• Requires Java 21