A villager and trade overhaul for Minecraft 1.21.1 (Fabric). Mercantile turns villagers from disposable trade machines into mobile, named, persistent characters — with pickup, biome-themed names, a five-tier reputation system, emerald-based trade cycling, and an iron-fueled sentry block that defends your village. Vanilla-first design: no custom textures beyond the sentry pylon, no balance-breaking shortcuts.
| Modrinth | CurseForge | Website | Report an issue |
|---|
- Villager Pickup — sneak-right-click a villager to pick it up. Full NBT (profession, trades, gossip, XP) is preserved on the held item.
- Villager Names — biome-themed names are auto-assigned on spawn and stay visible above every villager.
- Trade Cycling — refresh a villager's trade pool with emeralds and emerald blocks instead of breaking and replacing their workstation.
- Reputation — a five-tier global standing with persistent gossip that travels with villagers across the world.
- Sentry Pylon — an iron-fueled defense block that spawns temporary iron golems to guard your village.
- Reputation HUD — a compact on-screen tier readout shown next to nearby villagers, so you can read the room at a glance.
See the full feature list on the website for every behavior, tuning knob, and edge case.
Requirements
- Minecraft 1.21.1
- Fabric Loader 0.16+
- Fabric API
Steps
- Install Fabric Loader for 1.21.1.
- Drop Fabric API into your
mods/folder. - Download
mercantile-<version>.jarfrom Modrinth, CurseForge, or GitHub Releases, and drop it intomods/as well. - (Optional) Install Mod Menu and Cloth Config to access the in-game settings screen.
Mercantile is required on the server. The HUD overlay is the only client-side feature; install it on the client for the readout to appear.
Mercantile detects and integrates with these mods when present (none are bundled):
- Mod Menu — config screen entry
- Cloth Config — settings GUI
- Jade / WTHIT — villager tooltip overlays
- EMI / REI / JEI — recipe viewer support for trade-cycling recipes
- Website: https://mercantile.rfizzle.com
- Modrinth: https://modrinth.com/mod/mercantile
- CurseForge: https://www.curseforge.com/minecraft/mc-mods/mercantile
- Issues: https://github.com/rfizzle/mercantile/issues
- Changelog: https://mercantile.rfizzle.com/changelog.html
Mercantile is part of the rfizzle mod suite. If you like it, you may also enjoy:
git clone https://github.com/rfizzle/mercantile.git
cd mercantile
./gradlew buildThe built jar lands in build/libs/. See CLAUDE.md for the full
source layout, available Gradle tasks, and conventions.
Licensed under the MIT License. © 2025 rfizzle. Mercantile is not affiliated with Mojang Studios or Microsoft.