Mercantile

Changelog

Every stable release. Jars and full notes live on GitHub Releases — the canonical download source.

Unreleased — v1.1.0

Mercantile 1.1.0 is a large feature release that deepens village life and adds trade quality-of-life. Villagers now have moods, hold market days, mourn their dead, take direct job assignments, and reward loyal traders — while pinned trades, a tutorial tree, and richer tooltips make the whole system easier to learn. Every feature stays individually toggleable.

Added

  • Delivery contracts — employed villagers sometimes offer a written contract; sneak-right-click with paper to sign it, then bring the requested item back to the same villager before the deadline for emeralds and a reputation boost that ignores the daily cap.
  • Work orders — sneak-right-click an unemployed adult villager while holding a workstation block to send it to claim the nearest free workstation of that type and take the job. The block stays in your hand; you only pay a small emerald fee on success.
  • Market day — a recurring village event, every seven days from dawn to dusk, that gives every trade a flat discount and villagers an extra daily restock. It's announced at dawn with a bell and a flourish of happy particles.
  • Villager mood — villagers now track how they're living, from Miserable to Happy, based on their bed, workstation, sleep, food, and whether they've been hurt or seen death. Happy villagers sell cheaper and restock faster; miserable ones do the opposite. Their mood shows in the trade screen and in Jade/WTHIT tooltips.
  • Memorials and mourning — when a named villager dies it drops a Villager Memorial recording its name, profession, and how it fell, and nearby villagers pause to grieve. Kill too many villagers in one village too quickly and the survivors mark up their prices for you for a few days.
  • Nitwit rehabilitation — give an adult nitwit a golden apple, at Trusted reputation or higher and for an emerald fee, to turn it back into an unemployed villager that can take a profession again.
  • Gratitude gifts — once you reach Honored, villagers you spend time near will occasionally toss you a profession-themed gift that only you can pick up, up to once per day by default.
  • Baby feeding — right-click a baby villager with bread, carrots, potatoes, or beetroot to speed up its growth, up to a cap per baby.
  • Trade pinning — pin the trades you care about in the merchant screen and get a notice when a pinned trade restocks. Review your pins from the reputation detail panel or with /mercantile pins, each colored by live stock.
  • Reputation detail panel status — the hold-Left-Alt panel now shows whether market day is active (with the current discount and time left) or how far off the next one is, plus a live count of the villagers following you.
  • Tutorial advancement tree — a new Mercantile advancement tab walks you through the mod's hidden gestures — pickup, follow, gifting, contracts, fueling a sentry pylon, work orders, nitwit rehab, and reaching Trusted — each advancement naming the exact action that earns it.
  • In-game hints — mod content now teaches its own mechanics: the sentry pylon's tooltip explains its fuel and alarm behavior, Jade/WTHIT call out villagers waiting for a job or offering a contract, and gifts and price markups confirm themselves on screen.
  • Trade-index filters — the EMI/REI/JEI trade catalog gains an "Available Trades" view showing only what your current reputation unlocks, plus a category per reputation tier previewing what each standing opens up.
  • Reputation tier messages — cross into a new standing and a chat line tells you where you stand and that new exclusive trades have opened up.
  • Meridian salvage trades — with Meridian installed, Trusted-and-above librarians add salvage tomes and shelf materials — including Dragon's Breath once you've slain the Ender Dragon — while enchanted books appear from Neutral up, their enchantment pool widening as your reputation climbs.

Changed

  • Trade GUI clarity — when a villager's profession is locked, the re-roll button now stays visible but greyed out with a tooltip explaining why, instead of quietly disappearing. The pin column is always shown, filling in as you pin trades.
  • Sentry pylon threat scaling — with Tribulation installed, a sentry pylon now scales its golem cap and detection radius to the local threat level while a player is nearby. Without Tribulation, pylons behave exactly as before.

Fixed

  • The reputation HUD and detail panel no longer flicker or vanish for a frame alongside ImmediatelyFast, Blur+, or similar GUI mods.
  • Jade no longer shows a baby villager's growth countdown twice.
  • Placing a carried villager whose stored data was corrupted now spawns a plain villager instead of doing nothing.

v1.0.0 — Jul 1, 2026

Mercantile's first stable release — a complete villager and trade overhaul for Minecraft 1.21.1. Villagers become named, portable, persistent characters, backed by a global reputation system, an iron-fueled defense block, and deep recipe-viewer integration. Every feature is individually toggleable.

Added

  • Villager pickup — sneak-right-click a villager with an empty hand to carry them as a profession-themed head, then place them back down. They keep everything: profession, level, trades, name, health, and inventory. Costs a few XP levels, and won't work mid-raid or on a villager someone else is trading with.
  • Biome-themed names — every villager is auto-named from a pool that matches where it spawned: English names in plains, Nordic in taiga, Mesoamerican in jungle, African in savanna, and more. Names stay visible above the villager and survive pickup and restarts. Player-given nametags always win.
  • Reputation — a single global standing per player, across six tiers from Reviled to Honored. Trading, curing zombie villagers, gifting profession items, spending time near villagers, and defending raids raise it; hitting and killing villagers lower it. Higher tiers unlock price discounts and exclusive trades — per-profession and cross-profession — while very low standing gets you refused. Negative reputation slowly recovers on its own, and gifting speeds the climb back.
  • Trade cycling — a button in the trade screen re-rolls a villager's unlocked offers for emeralds. Any trade you've bought from locks in and is never re-rolled, so cycling gets more efficient as you fill the slots you want.
  • Follow mode — sneak-right-click a villager while holding an emerald to have them follow you; do it again to send them home to their bed or workstation. Up to three villagers at once, and they're immune to being shoved off their path.
  • Sentry pylon — a craftable defense block that burns iron blocks to summon temporary iron golems when hostiles enter its radius, and rings the nearest village bell to call you to the fight. The golems fight anything hostile — creepers included — then fade away once it's safe. Comparator output reads fuel level; a redstone signal switches it off.
  • Bulk trading — shift-click a trade to repeat it up to 64 times in one action, until your items or the stock run out.
  • Merchant screen upgrades — a restock timer, a price breakdown on hover (base, demand, reputation, and gossip), and an info panel showing the villager's name, level and XP, your reputation with them, total trades, and workstation status.
  • Profession lock — once you've traded with a villager, breaking their workstation won't wipe their profession.
  • Pathfinding fixes — villagers now handle fence gates, double doors, multi-step staircases, and ladders, and route around water instead of walking in and drowning. Each fix toggles independently.
  • Healing boost — splash and lingering potions of healing and regeneration are twice as effective on villagers, so patching them up after a siege actually works.
  • Workstation and bell visualizations — hold a bell to see profession-colored particle links between villagers and their workstations, and the bell's gathering radius drawn as a circle on the ground. Unbound villagers and unclaimed workstations are called out too.
  • Reputation HUD — a compact tier readout next to nearby villagers.
  • Villager sound slider — set the volume of villager ambient, trade, and hurt sounds anywhere from 0 to 100%.
  • Trade index — a unified, searchable catalog of every villager trade in EMI, REI, and JEI. Search "mending" to find who sells it, or any item to see who buys it; filter by profession, level, or reputation lock. Item lookups list matching trades right alongside crafting recipes.
  • Jade / WTHIT tooltips — look at a villager to see breeding readiness, cooldowns, food counts, baby growth time, and live state (hungry, panicking, needs a bed, trading).
  • /mercantile commands — check your own reputation, and as an operator adjust another player's or reload the config in place.

Download & full notes on GitHub →

Versioning

Mercantile follows semantic versioning. Every tagged release is on GitHub Releases, the canonical download source; prereleases are published there but omitted from this page.