ModsJava
VillagerTrades – Static NPC Villagers with Custom GUI Trades
Java mod listed for Minecraft 1.19–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on Spigot
VillagerTrades
Custom NPC shop villagers with a full in-game GUI editor
Paper 1.21.x · Java 21 · No dependencies
Custom NPC shop villagers with a full in-game GUI editor
Paper 1.21.x · Java 21 · No dependencies
Tired of villager AI walking your shopkeepers away, or vanilla trade tables ruining your server economy? VillagerTrades lets you spawn fully static NPC villagers and design their trades, profession, career level and biome clothes entirely from an in-game chest GUI - no configs to hand-edit, no command-block tricks.
How it works
- Run /vtrade create <name> - a static NPC villager spawns right in front of you, facing you (no AI, can't be pushed, invulnerable, silent).
- Right-click the NPC - admins get the editor GUI, players get the trade menu.
- Set profession, level (Novice → Master) and biome clothes with arrow buttons - changes apply live, including the robe badge.
- Open the trade list, add a trade, drop your ingredient(s) and reward item into the marked slots and save. Done.
Features
- Static NPCs - no movement, no AI look-around, immune to damage, can't be pushed around, persistent across restarts.
- Full GUI editor - profession (all 15 + unemployed), career level (Novice → Master), and biome outfit (Plains, Desert, Jungle, Savanna, Snow, Swamp, Taiga) with instant visual updates.
- Custom trades - up to 45 trades per NPC, one or two ingredients plus a reward. NBT-safe: enchanted, renamed, custom-lore items all work.
- Vanilla trading screen - players get the familiar merchant UI. No commands needed to buy.
- Color codes - NPC names support & color codes.
- Safe editing - items you place in the trade editor are returned to you; trade data is stored separately from the GUI.
- Persistent storage - trades and looks are saved to shops.json and reloadable with /vtrade reload.
- Lightweight - zero dependencies, event-driven only, no background tasks.
Commands & Permissions[/SIZE=5]
- /vtrade create <name> - spawn a shop NPC (villagertrades.admin)
- /vtrade edit - edit the NPC within 8 blocks (villagertrades.admin)
- /vtrade test - preview the NPC's trade menu as a player (villagertrades.admin)
- /vtrade move - teleport the NPC to you (villagertrades.admin)
- /vtrade delete - remove the NPC (villagertrades.admin)
- /vtrade list - list all NPCs (villagertrades.admin)
- /vtrade reload - reload shop data (villagertrades.admin)
Installation
- Put VillagerTrades-1.0.0.jar in your plugins folder.
- Restart the server (Paper 1.21.x recommended).
- /vtrade create Shop and start building your server's marketplace.
Spoiler: Default config
Code (YAML):
# VillagerTrades Configuration
settings :
# Maximum number of trades per NPC (the trade list GUI fits 45)
max-trades : 45
settings :
# Maximum number of trades per NPC (the trade list GUI fits 45)
max-trades : 45
Found a bug or want a feature added? Use the discussion thread or message me directly - please don't use reviews for bug reports, they will be ignored.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.19, 1.20, 1.20.6
- 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.
VillagerTrades – Static NPC Villagers with Custom GUI Trades is a free Minecraft Java mod. Compatible with Minecraft 1.19, 1.20, 1.20.6, 1.21 and newer. Downloaded 15 times (via Spigot). Download it and open it directly in the game.