TradeLedger
Every Minecraft world eventually fills up with villagers, and every villager has a story told through its trades. The problem is that your memory does not keep a spreadsheet. TradeLedger is a client-side mod that quietly records the offers you encounter, turning a scattered village economy into a searchable, sortable personal directory. Whether you are hunting a Mending librarian or comparing emerald prices across three servers, this add-on keeps the receipts.
What TradeLedger Actually Does
The core idea is simple: open a villager or wandering trader trade screen, and the mod records what you see. From there, press V to open the ledger and browse everything you have observed. Each entry carries its own context, including the profession, dimension, village label, timestamps, and how confident the mod is about the merchant's identity.
Search is the heart of the tool. You can look up items, enchantments and their levels, professions, dimensions, village labels, and your own notes. A maximum emerald cost filter lets you answer the question that matters most: who sells this book cheaply? Filtered results can be sorted by favorites, by the cheapest observed emerald purchase price, or by the newest observation.
Favorites, Notes, and Wish Lists
- Save favorite trades for quick reference, with missing favorites still searchable as historical observations.
- Attach personal labels to villages and villagers, plus free-form notes on individual trades.
- Maintain a manual trade wish list for things you still need to find.
- Keep separate ledgers per world, server, and profile, so a server reset at the same address stays clean.
Navigation and Export
Finding a good trade is only half the battle; remembering where that villager lives is the other half. A destination HUD shows the last observed coordinates and the same-dimension distance to the merchant, so you can walk back without guessing. Villagers do move after their location is recorded, so treat the marker as a strong hint rather than a guarantee.
When you want to plan offline, export your filtered observations as UTF-8 CSV. Files land in the ledger's exports folder and include notes and coordinates, so review them before sharing. Historical status, timestamps, and identity confidence travel with each trade, which makes exported data far more useful than a plain list of prices.
If you would rather skip manual file juggling entirely, the foxygame.net launcher can handle the setup for you, installing TradeLedger and its required Fabric API dependency in a single click with automatic updates when new builds appear.
Supported Versions and How to Install
TradeLedger ships version-specific builds rather than one universal file. Match the JAR to your exact game version and loader:
- Minecraft 1.21.11 with Fabric and Fabric API 21 or newer
- Minecraft 1.16.5 with Fabric and Fabric API 17 or newer (this port requires Java 17)
- Minecraft 1.12.2 with Forge 8
- Minecraft 1.8.9 with Forge 8
To download TradeLedger, grab the file that matches your version and loader, install that loader, and add Fabric API if you are on Fabric. Place only the matching runtime JAR in your mods folder. The mod is client-side only, so no server installation is needed, though you should still check your server's client-mod policy before joining.
How to Install TradeLedger for Minecraft
The process is short: install the correct loader, drop Fabric API into the mods folder for Fabric setups, then add the single TradeLedger JAR that matches your game version. Launch the game, open a trade screen to capture your first offers, and press V to open the ledger. The key can be rebound in Controls at any time. Reopening a merchant screen refreshes that merchant's observation.
Data, Limits, and Honest Caveats
Everything is stored locally in config/tradeledger as JSON, separated by world or server and profile. Files contain trade details, names, and coordinates, and hashed filenames are not encryption. Explicit edits save immediately, while observations save within five seconds or during normal screen closure and disconnection. Abrupt termination can lose recent observations, and backups are kept as a safety net.
Records become stale after 24 hours, and even fresh observations can change, since prices and stock describe a moment in time rather than current availability. On Minecraft 1.8.9, the client protocol does not expose persistent villager UUIDs, so records there are session-scoped. Cross-version ledger migration is not supported, so keep your original files rather than copying data between game generations. TradeLedger never rerolls villagers, alters prices, or automates trading.
Final Thoughts
TradeLedger is the kind of utility that fades into the background until you need it, then saves you an hour of walking between villages. For players running long-term survival worlds, busy servers, or sprawling modpacks, it turns villager trading from guesswork into a proper ledger. Pick the build for your version, install it on the client, and let the mod remember what you would otherwise forget.