CurseForge · Minecraft mod
TradeLedger
Remember observed villager trades, search prices and enchantments, save favorites, export CSV, and navigate to last-seen locations. Client-side Fabric/Forge mod.
Quick answer
Which TradeLedger release matches 1.12.2 Forge?
TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge) targets 1.12.2 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is TradeLedger required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge) need?
TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge) on 1.12.2 Forge. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add TradeLedger without breaking your instance.
Built for TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge) on 1.12.2 Forge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge). It targets 1.12.2 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge). It opens that exact file at the source.
About this project
What does TradeLedger add?
TradeLedger
A personal directory of villager trades you have observed, with search, favorites, sorting, CSV export and navigation to last-seen locations.
Features
- Records offers when you open a villager or wandering trader trade screen.
- Search items, enchantments and levels, professions, dimensions, village labels and notes; filter purchase prices by maximum emerald cost.
- Save favorite trades. Missing favorites remain searchable as historical observations.
- Add personal village labels, villager labels and notes.
- Navigate with a destination HUD showing the last observed coordinates and same-dimension distance.
- Keep a manual trade wish list and separate ledgers per world, server and profile.
- Sort filtered trades by favorites, cheapest observed emerald purchase price or newest observation.
- Export filtered observations as UTF-8 CSV for offline planning. Historical status, timestamps and identity confidence travel with the trade.
Installation
Choose the file for your exact Minecraft version and loader:
| Minecraft | Loader | Java |
|---|---|---|
| 26.3 | Fabric + Fabric API | 25+ |
| 1.21.11 | Fabric + Fabric API | 21+ |
| 1.16.5 | Fabric + Fabric API | 17+ |
| 1.12.2 | Forge | 8 |
| 1.8.9 | Forge | 8 |
Install the matching loader and, for Fabric, Fabric API for that game version. Put only the matching TradeLedger runtime JAR in your mods folder. Install on the client; no server mod is required. The 1.16.5 port requires Java 17 even though vanilla can use older Java.
Open a trade screen to record offers, then press V to open TradeLedger. The key can be changed in Controls. Reopen a merchant screen to refresh its observation.
Observation limits
Every entry is cached and shows its age. Records become STALE after 24 hours, but newer observations may also have changed. Prices and stock describe the observation; current availability and restock times are unknown. Villagers may move after their location is recorded. Plugin-opened or ambiguous merchant screens can be recorded without identity or coordinates.
Minecraft 1.8.9 identity limit: its client protocol does not expose persistent villager UUIDs. This port keeps session-scoped merchant records with explicitly observed last-seen locations. Reconnecting can create separate records; existing favorites and labels cannot be automatically attached to merchants in the new session.
TradeLedger does not reroll villagers, change prices, automatically trade or bypass server rules. Check your server's client-mod policy. Older games retain their own trades and enchantments; this mod does not add newer Minecraft content.
Local data
Data is stored locally in config/tradeledger as JSON, separated by world/server and profile. Files contain trade details, names and coordinates; hashed filenames are not encryption. Use a new Profile when a server resets at the same address. Explicit edits save immediately; observations save within five seconds and during normal screen closure/disconnection/shutdown. Abrupt termination can lose recent observations. Backups are kept.
Forge builds use version-specific subfolders. CSV files are saved under the ledger's exports folder and include notes and coordinates; review them before sharing. Cross-version ledger migration is not supported. Keep the original files rather than copying component/NBT data between game generations.
License and release
MIT licensed. Version 0.2.0 adds sorting, export and version-specific ports. Third-party server plugins, large modpacks and authenticated multiplayer were not tested. Gameplay screenshots show an isolated fixture world.
Project description from CurseForge.
Pick your setup
TradeLedger by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.11
1 loader build1.16.5
1 loader build1.12.2
1 loader build1.8.9
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
TradeLedger versions and loaders
TradeLedger 0.2.0 for Minecraft 1.12.2 (Forge)
tradeledger-forge-0.2.0+mc1.12.2.jar
23 Oct 2026
Looking for an older file? The official CurseForge project page is in Resources.