Mercantile - Villager Overhaul

# Mercantile — Villager & Trade Overhaul **_Every villager remembers._** !(https://raw.githubusercontent.com/rfizzle/mercantile/master/art/logo.png) **Also on (https://www.curseforge.com/minecraft/mc-mods/mercantile-villager-overhaul) and (https://github.com/rfizzle/mercantile/releases).** Visit the (https://mercantile.rfizzle.com) for the full feature list, config reference, and command guide. --- Mercantile is a villager and trade overhaul for **Minecraft 1.21.1 (Fabric)**. It turns villagers from disposable trade machines into mobile, named, persistent characters — with pickup, biome-themed names, a six-tier reputation system, emerald-based trade cycling, and an iron-fueled sentry block that defends your village. **Restrained by design.** Custom art is scoped to what earns its place — the sentry pylon block, a set of bespoke effect particles, and a handful of HUD/GUI glyphs in the Concord palette; everything else leans on vanilla. No balance-breaking shortcuts, no bundled dependencies you didn't ask for. Every sound is a vanilla sound, and every villager head uses a community skin already hosted on Mojang's CDN. ## At a glance - Minecraft **1.21.1**, **Fabric** loader (0.16.10+), **Fabric API** required. - Required on the **server**. The reputation HUD is the only client-only feature — install it client-side too if you want the readout. - Every feature is **individually toggleable** through Mod Menu / Cloth Config or `config/mercantile.json`. - MIT licensed. ## Features ### Villager Pickup Sneak-right-click a villager with an empty hand to pick them up. The villager becomes a profession-themed player head in your inventory. Place them down with a right-click; they spawn facing you. Full NBT survives the round trip — profession, level, XP, trade offers, gossip, custom name, health, inventory. The tooltip shows profession and level, every trade in `cost → result` form, locked/out-of-stock indicators, and a `n/m trades unlocked` summary. Costs 5 XP levels by default (configurable, waived in Creative). Won't work during a raid, on a villager being traded with, or on one currently following another player. ### Biome-Themed Names Every villager is auto-named on spawn from a biome-themed pool — common English names in plains and forests, Arabic in deserts, Nordic in taiga, Mesoamerican in jungle, African in savanna, Old English in swamps, frontier-era in badlands. Names are always visible above the villager, persist across pickup and restart, and respect player-given nametags. Pools are datapack-driven, so you can override or extend them. ### Work Orders Stop playing workstation roulette. Sneak-right-click an unemployed adult villager while holding a profession's workstation item — a lectern, composter, smithing table — and it walks to the nearest unclaimed job site of that type and takes the matching profession. The held item only names the job and is never consumed; the block must already be placed. Each order costs a small emerald fee (1 by default, waived in Creative); if no free workstation is in range the order is refused and nothing is charged. Professions resolve from the block's point-of-interest, so modded jobs work automatically. ### Villager Mood Every villager tracks a mood from its living conditions — a claimed bed and workstation, recent sleep, food on hand, staying unharmed, and not witnessing a neighbor's death — settling into one of four tiers: Miserable, Unhappy, Content, or Happy. Mood is a nudge, not a gate: Happy villagers give a small discount and restock sooner; Miserable ones add a small markup and restock later. The tier shows in the info panel and Jade/WTHIT tooltips and appears as its own line in the price breakdown. Mood belongs to the villager — the same for every player — and persists across pickup and reload. ### Reputation A **single global reputation score per player** that affects every villager, running parallel to vanilla gossip. | Tier | Range | Effect | |---|---|---| | Reviled | -200 to -150 | Trade refusal, angry villager particles | | Distrusted | -149 to -1 | Price markup (10-25%) | | Neutral | 0 to 74 | No modifier | | Liked | 75 to 299 | Small discount (5%) | | Trusted | 300 to 999 | Moderate discount (10%), profession-exclusive trades | | Honored | 1000+ | Best discount (15%), all exclusive trades | Reputation goes up for trading, curing zombie villagers, cycling trades, spending time near villagers, gifting profession-appropriate items, and defending the village from raids (any player awarded Hero of the Village gains a full bonus, outside the daily cap); it goes down for hitting and killing them. Fallen out of favor? Negative reputation slowly recovers toward neutral on its own, and gifting villagers speeds the climb — even a Reviled player has a clear path back. Exclusive trades — per-profession, cross-profession, and a sticky bonus offer from wandering traders at Trusted tier and up