Pepsi's Villager Ordinance

Villager Ordinance

Villager Ordinance is a full villager control suite for players who want more than blind rerolls and guesswork. It turns villagers into something you can actually understand, search, tune, and manage in-game.

If you want to hunt perfect trades, inspect breeders, diagnose workstation problems, browse an entire village's offers at once, carry villagers as items, or reshape how villages behave, this mod is built for exactly that.

It is designed to be useful whether you want a light quality-of-life upgrade or a full villager-management toolbox. You can keep the parts you love close to vanilla, push others far beyond it, and do almost everything through in-game screens instead of external notes and trial-and-error.

Almost every system can be tuned or disabled, so the mod can feel like a gentle quality-of-life helper, a full villager optimizer, or a harsher custom ruleset for challenge worlds.

Why players install it

• Hunt perfect trades without losing great near-misses along the way.
• Preview locked future trades before committing XP and materials.
• Inspect unemployed villagers, breeders, and broken workstations with real answers instead of guesses.
• Browse nearby villager trades from one screen instead of walking house to house.
• Locate villagers by enchantment, profession, or item and make the right one glow.
• Pick villagers up as items without throwing away the data that matters.
• Tune everything from restocks and infinite trades to zombie cures, nitwits, wandering traders, iron golems, and zombie sieges.

Auto-Cycle, Smart Rerolling, and Best-Result Rollbacks

This is the centerpiece of the mod.

• Start manual rerolls or full auto-cycle sessions directly from the trading screen.
• Search for a specific dream setup instead of rerolling blindly.
• Show or hide the VO overlay whenever you are trading.
• Set reroll delay, search duration, reroll caps, or run fully uncapped.
• Push rerolls hard with supercharged cycling, including a dynamic mode that adjusts to the server TPS instead of blindly brute-forcing.
• Keep searching after trading has already started when you want a more relaxed ruleset.
• Watch live status for rerolls, score, matched fields, matched conditions, elapsed time, and rerolls per tick.
• Get a simple probability readout based on how many rerolls the result took.

What makes it feel different is the nearest-match system:

• Every reroll is scored, not just perfect hits.
• Stronger matches beat weaker ones instead of being discarded.
• The villager's starting trade set counts as the first fallback candidate.
• If a better near-match appears later, it replaces the old stored result automatically.
• You can roll back to the best stored near-match whenever you want.
• You can let the villager snap back to the best stored result automatically when a search ends without a perfect hit.
• You can keep the current best result visible while the cycle is still running, so you see the search improve in real time.
• Stored best matches can survive closing the screen, saving and reloading, and even picking the villager up and placing it later.

Locked Trade Previews and Merchant Overlay

• Preview locked future trades before leveling the villager.
• Keep visible and locked rows clearly separated so you always know what is already usable and what still needs XP.
• See real item previews instead of vague placeholders.
• Hover rows to inspect tooltips just like normal item stacks.
• Read enchanted books like proper enchanted books instead of anonymous "book only" placeholders.
• See price breakdowns for visible offers, including base price, demand, discounts, reputation, hero bonuses, and other modifiers.
• Optionally show how much trade XP is still needed for the next villager level right near the vanilla XP bar.

This makes leveling a villager feel deliberate instead of risky. You can inspect the full path ahead, decide whether the future tiers are worth it, and lock in a plan before you spend a single emerald.

Condition Editor and Reusable Trade Profiles

• Build multi-condition search profiles instead of relying on one simple target.
• Use full AND / OR grouping for parentheses-style logic.
• Reorder conditions, reorder fields, and merge groups quickly.
• Save, load, rename, delete, duplicate, copy, import, and reorder named profiles.
• Clone a villager's current trades into a new profile with one click.
• Use NBT Clone mode to generate much deeper filters from the actual trade contents.
• Let cloned profiles automatically use the villager's custom name or profession as the profile name.
• Invert any field so you can search for what you want or explicitly exclude what you do not want.

Supported filter targets include:

• visible or locked trades
• tier
• trade row
• sell item
• sell item effect
• sell item enchantment, including minimum level
• advanced sell-item data by path and value
• first buy item
• second buy item
• price comparisons

If you love building exact librarian searches, blacklist-style filters, or "find me something close but not this" setups, this system is where the mod really opens up.

Inspector for Breeders, Unemployed Villagers, and Non-Trading Villagers

• Open the full VO panel inside normal trading.
• Open a standalone inspector for villagers that cannot trade normally, including unemployed villagers and breeder villagers with no workstation.
• Empty-hand right-click those villagers to inspect them without forcing a trade flow.
• Choose what Shift-right-click does for you: inspect, pick up, or ignore.
• Keep inspected villagers from wandering away while you read.

The inspector is built for real diagnosis, not just trivia:

• see whether the villager is willing to breed right now
• see breeding cooldown in seconds
• see baby grow-up time in seconds
• see what breeding requirement is missing
• see whether the villager can work and reach its job site
• see restock timing without changing vanilla behavior
• see reputation and gossip values
• see the villager's inventory contents

It is the kind of screen that makes breeder debugging and villager troubleshooting stop feeling like superstition.

Village Trade Browser and Call-Over Mode

Instead of reopening trade windows one villager at a time, you can scan the local village from one screen and decide who is actually worth dealing with.

• Open a dedicated browser to scan nearby villagers within your chosen radius.
• View the real visible offers of many villagers at once.
• See item renders and hover tooltips instead of plain-text summaries.
• See enchanted books with their actual enchantment names clearly represented in the browser instead of collapsing into vague filler text.
• Search the whole local trade pool for items, enchantments, and synced offer data.
• Sort the list the way you prefer and keep your preferred browser layout.
• Refresh the list without a flickery, awkward reload experience.

When direct remote trading is not the right fit, the browser can still stay useful:

• call a villager over to you instead of opening the trade instantly
• keep that villager marked En Route while it walks in
• automatically open trading once it reaches normal distance
• use Look At and Keep Calling style shortcuts to keep the right villager on your radar

The result is a village-wide shopping and routing tool that saves an enormous amount of time without turning every villager into a nameless spreadsheet entry.

Locate Nearby Villagers by Trade, Item, Enchantment, or Profession

• Search for nearby villagers matching a specific enchantment.
• Search for villagers selling a specific item.
• Search for villagers buying a specific first or second input item.
• Search for villagers by profession.
• Highlight the matches with client-side glowing so you can physically find the right villager in the world.

This is especially good for large trading halls, messy breeder overflow, and villages where you know the trade exists somewhere but cannot remember which villager has it.

POI Debugging and Workstation Repair Tools

• Open a dedicated workstation and bed debug panel from both trading and inspection screens.
• See whether the villager has a valid workstation.
• See whether the workstation matches the villager's profession.
• See who owns the workstation.
• See linked bed details.
• See why restocking is failing.
• Read extra profession and POI state text when something feels off.
• Scroll long debug readouts without the screen becoming unreadable.

Optional repair actions let you intervene directly when needed:

• unlink workstation
• rescan nearby workstation state
• recheck remembered POIs

This is one of the mod's most practical features for breeders, trading halls, and villages that have gone sideways after moving blocks around.

Villager Inventory Viewer and Utility Actions

• Open a full inventory viewer for the selected villager.
• See every occupied slot in the villager's inventory.
• Pull out a single stack with a click.
• Empty the whole inventory into your player inventory.
• Drop overflow into the world if your inventory is full.

This is great for breeder cleanup, food debugging, or dealing with villagers that keep grabbing things you wish they had never touched.

Pick Up Villagers as Items

• Capture villagers into a carried villager item from the VO menus.
• Keep the villager's visual appearance, including profession and biome clothing.
• Keep custom names when present.
• Preserve baby and adult state correctly.
• Place the villager back into the world from the item later.

Most importantly, this is not a shallow gimmick item:

• stored trades come back
• locked trade preview data comes back
• nearest-match rollback data comes back
• important saved villager state comes back

It feels like moving the same villager, not replacing it with a blank copy.

Trading, Restocks, and Economy Rules

• Allow or block rerolls after trading has begun.
• Enable infinite trades so offers do not run dry.
• Force restock behavior when you want more aggressive restocking rules.
• Reset positive demand on restock fully or partially.
• Enable seamless instant villager level-ups so new tiers can unlock during the same trading session.
• Use periodic rerolls when you want villagers to refresh over time, or shut that system off entirely.
• Keep periodic rerolls separate from manual rerolls and auto-cycle behavior.
• Decide whether hidden locked trades can be previewed and matched.

This lets you shape trading anywhere from "close to vanilla with better information" to "fully optimized villager lab."

Villager Utility and Everyday Quality-of-Life

• Detrain villagers so you can reset their career path more easily.
• Reset a villager's work life without making it feel like you destroyed the villager and spawned a different one.
• Make villagers follow players holding emeralds.
• Let villagers be led with leads.
• Give villagers slow natural health regeneration.
• Make villagers immune to sweet berry bush damage.
• Keep a wide range of these helpers optional so you can decide how gentle or strict your world should feel.

Wandering Traders, Nitwits, and Career Cleanup

• Let sold-out wandering traders settle down into regular unemployed villagers instead of vanishing as wasted potential.
• Tune how often wandering traders visit.
• Tune the visit delay and the visit chance ladder over time.
• Convert existing nitwits into unemployed villagers.
• Prevent new nitwits from appearing where supported.
• Reset villagers back to an unemployed path when you want to rebuild them from scratch.

This section is all about reducing dead ends and wasted villagers in long-term worlds.

Zombie Villagers, Cures, and Spawn Tweaks

• Set custom minimum and maximum zombie villager cure times.
• Use instant cures if that is the pace you want.
• Allow curing without Weakness.
• Restore stackable cure discounts with a configurable stack cap.
• Make infection happen even when vanilla difficulty rules would normally block it.
• Tune how often ordinary zombies spawn as zombie villagers.
• Let zombie spawners produce zombie villagers using the same chance system.

If you like cure economics, healer villages, or worlds that lean harder into villager recovery loops, this part adds a lot of flexibility.

Village Defense, Zombie Sieges, and Iron Golems

• Leave zombie siege nights close to vanilla, make them rarer, make them much more common, or disable them.
• Turn iron golem spawning off entirely for challenge runs or harsher villages.
• Shorten or lengthen the golem summon cooldown.
• Shrink or expand the villager detection range for golem summoning.
• Keep the usual "villagers must have slept recently" rule, or relax it for artificial builds and technical setups.

This makes it possible to keep village defense cozy, make it brutal, or support unusual villager builds that vanilla rules do not handle well.

In-Game Settings and Interface Customization

• Adjust the mod in-game instead of living in external files.
• Separate personal UI preferences from world-side rule changes.
• Open the settings screen from the merchant overlay, the standalone inspector, and menu integrations.
• Browse settings in clear categories instead of one giant wall of options.
• Reset single entries or whole groups quickly.

Player-facing customization includes things like:

• panel placement
• whether POI debug starts open
• whether POI action tooltips stay visible
• whether next-level XP is shown near the vanilla XP bar
• locate scan distance and glow duration
• village trade browser radius, sorting, and layout
• picked-villager handheld rotation adjustments

Why This Mod Feels Different

Villager Ordinance is not just a reroll button.

• It gives you visibility before you commit.
• It gives you fallback options when a search is almost perfect.
• It lets you diagnose villagers that would normally tell you nothing.
• It helps you manage whole villages instead of one screen at a time.
• It keeps important villager state intact when you move them around.
• It gives you both convenience and control instead of forcing you to pick one.

If you enjoy building trading halls, breeder systems, technical villages, cure loops, or survival worlds where villagers matter, this mod is made to turn that part of the game from frustrating into genuinely satisfying.