Villager Contract Book
by ha4zyk
Villager Contract Book lets players record a villager's trades in a book and find that villager again later in the world.
What it does
Right-clicking a villager with the book saves that villager's trades to the book, and using the book opens a list of the saved trade offers. The book is crafted with an Emerald, so it is available early in survival. Saved entries can be browsed from the book, which makes it a reusable ledger of villagers met while travelling.
A saved villager can be searched by profession or by the item it trades, and the mod can highlight nearby saved villagers so that a player can locate them in the world. When a villager is saved again after its trades have changed, the existing entry is updated rather than duplicated.
The mod is Forge only and runs on client and server, so both the server and every player need it. The latest alpha file, 1.0.0 for 1.20.6, was released on 2026-07-16. The code is under All rights reserved, so the mod is not open source.
Key features
Trade recording
Right-clicking a villager stores its current trade offers in the book for later reference.
Searchable ledger
The book can be searched by villager profession or by the item a villager trades.
Nearby highlighting
Saved villagers within range are highlighted, helping a player find a known trader in the world.
Entry updates
Saving a villager again refreshes its existing entry instead of creating a duplicate.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Tracking a far trader
A player who found a good trade far from base can record it and return later without memorising the villager's position.
Comparing offers
Several villagers' trades can be kept in one book and searched by item to compare prices before choosing where to trade.
Who it’s for: Players who trade with villagers across large worlds and want a record of trades, and server owners running a shared world where trades change over time.
How it compares
Villager Trade Edit is Forge only for 1.20.1, released under the MIT License and runs on client and server, so it targets a single version. ServerSearch is Forge only for 1.20.6 and is under All rights reserved, with no open source code. Annoying Villagers Trades runs on Forge and client and server, under All rights reserved.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Villager Contract Book | Forge | 1.20.1 – 1.20.6 | Client and server | 2026-07-16 |
| Villager Trade Edit | Forge | 1.20.1 | Client and server | 2026-05-24 |
| ServerSearch | Forge | 1.20.6 | Not published | 2025-01-24 |
| Annoying Villagers Trades | Forge | 1.20.1 – 1.20.6 | Client and server | 2026-08-08 |
Questions
Does Villager Contract Book need to be on the server?
Which loader does Villager Contract Book use?
Which game versions are covered?
In the catalog
Villager Contract Book is one of 8,016 Management mods on ModsFinder, and one of 2,698 Management mods for Forge. 11,154 mods support Minecraft 1.20.6.
More from ha4zyk
Similar mods
What the author says
Store villager trades in a reusable contract book. Craft the book, right-click a villager to save their trades, then use the book to browse saved villagers and locate them.
Official listing
- Modrinth page
- modrinth.com/mod/villager-contract-book
- Owner
- ha4zyk
- Published
- 2026-07-16
- Updated on Modrinth
- 2026-07-16
- Facts verified
- 2026-10-15