TradeLedger

A personal directory of villager trades you have observed, with search, favorites and navigation to last-seen locations. Built for Minecraft Java 26.3 and Fabric.

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.

Installation

Requires Minecraft Java 26.3, Java 25, Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3. Install Fabric Loader and Fabric API, then put the TradeLedger JAR in your mods folder. Install on the client; no server mod is required.

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.

TradeLedger does not reroll villagers, change prices, automatically trade or bypass server rules. Check your server's client-mod policy. Only Minecraft 26.3 is supported by this release.

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.

License and release

MIT licensed. Version 0.1.0 is the first release. The build passed 22 unit tests and a Fabric client game test in an isolated fixture world. Third-party server plugins, large modpacks and authenticated multiplayer were not tested.