Villager Helper

Minecraft 1.20.1 / Forge 47.4.6-47.x / Java 17. Beta trading utilities, modId villagerhelper.

English

• Generates and persists actual offers for all villager levels in the vanilla trading list. Future offers have level locks and lock icons; server validation protects normal and Shift purchases. Leveling unlocks the saved offers without generating duplicates.
• Rerolls only never-traded villagers. Trading history, XP or used offers reject rerolls. Rerolls rebuild future offers; they are not restocks.
• Quick restock resets uses only, preserving goods, demand, prices, XP, level and locks. Server checks the trader, menu, alive state, 8-block distance and 10-tick cooldown. The restock key is unbound by default; bind it in Controls. It works only in trading screens.
• Vanilla delayed promotion continues while trading stays open and synchronizes level/locks.
• 1.0.7 restores vanilla's maximum two automatic restocks per day, retaining workstation/work AI/timing. Manual restock is separate.
• 1.0.7 no longer changes gossip, discounts, demand or hurt particles. These optional mechanics are extracted into standalone villagerreputation 1.0.0. Helper alone uses vanilla reputation/price rules and the minimum-one payment clamp.

Installation and saves

Singleplayer: install in the client instance including the integrated server. Multiplayer: matching client and server helper versions. Remove old/duplicate helper JARs. Reputation 1.0.0 must not be combined with helper 1.0.6 or earlier. Back up saves. Removing old helper/reputation does not clear persisted positive gossip, demand, special prices or offers; saved reputation can still cause discounts. No automatic rollback or gossip reset. Helper preserves its future-offer/level-lock NBT; fully removing it removes its lock protection. Capture/release, 28-slot storage, name/pinyin search and display-only grouping belong to villagertradehub, not this mod.

Verification and license

Production builds/reobfuscation, request-policy tests, artifact checks and isolated production-mapping probes passed. Probes end before a GUI/world opens; they are not gameplay tests. GUI, real transactions, save round-trips, multiplayer and arbitrary-modpack compatibility are not validated. Author performs in-game acceptance. Copyright (c) 2026 666nima, BSD-3-Clause. Gradle wrapper/Forge MDK notices retain their separate licenses.

Source and GitHub prerelease download

Source: GitHub repository

GitHub prerelease/download (1.0.7, Beta; not a stable release): v1.0.7

中文

在原版列表生成并持久化全等级真实交易，未解锁项有等级锁和锁图标，服务端保护普通及Shift购买；升级解锁原交易而不重复随机生成。仅从未交易村民能刷新，历史标记、经验或已用次数任一表明交易过即拒绝，刷新重建未来交易而不是补货。 快速补货只重置uses，不改商品/需求/价格/等级/经验，不清等级锁；校验交易者、菜单、存活、8格距离及10tick冷却。补货键默认未绑定，在按键设置自行绑定，仅交易界面有效。打开交易界面时原版延迟升级继续并同步等级与锁态。 1.0.7自动补货恢复原版每日最多两次，保留原版工作站、AI及间隔；手动补货独立。声望、折扣、需求与受伤粒子修改已移至独立可选村民声望1.0.0，单装助手沿用原版声望/价格及至少一件付款下限。 单人装客户端实例含集成服务器，多人双方装匹配助手版本。移除旧/重复助手；声望1.0.0不得与助手1.0.6或更早合装。先备份：已有正面gossip、需求、特殊价格及交易数据不会自动清除/回滚，卸载并非即时恢复原价。完全卸载助手后其预览锁保护不再生效。 捕获/释放、28槽贸易台、搜索及聚合属于villagertradehub，并非助手功能。Beta：构建、策略、产物检查和隔离映射探针通过，未验GUI、真实交易、存档重载、多人或任意整合包。

1.0.7源码已公开： https://github.com/666nima/villagerhelper

GitHub预发布版/下载（非正式稳定版）： https://github.com/666nima/villagerhelper/releases/tag/v1.0.7