Handy Trader

A Fabric mod for Minecraft 1.21.11 that lets you bookmark favorite villager trades.

Mark the trades you use most, and they'll sort to the top of the list — no more scrolling through a master librarian's 20+ offers to find Mending.

Features

• Bookmark favorites — Click the top-left corner of any trade row to mark it with a gold bookmark indicator.
• Sort to top — Favorited trades automatically move to the top of the trade list.
• Per-villager storage — Each villager remembers its own favorites, persisted across sessions.
• Hover feedback — Ghost bookmark appears when hovering the corner; brightens on favorited rows.
• Sound feedback — Subtle amethyst chime when toggling favorites.
• Configurable — Toggle favorites on/off via config screen or JSON file.

Requirements

• Minecraft Java Edition 1.21.11
• Fabric Loader 0.18.1+
• Fabric API 0.139.5+

Optional (for config screen)

• ModMenu — adds a Configure button in the mod list
• YACL — powers the in-game config screen

Without these, everything works with sensible defaults. You can also edit config/handytraders.json manually.

Installation

Single Player

1. Install Fabric Loader for Minecraft 1.21.11
2. Download Fabric API and place it in your mods/ folder
3. Download Handy Trader and place it in your mods/ folder
4. Launch the game and open a villager trade screen!

Server

This is a client-side only mod. Install it on the client — no server installation needed.

Building from Source

git clone https://github.com/dfox288/HandyTrader.git
cd HandyTrader

./gradlew build
# The compiled JAR will be in build/libs/

Development

# Generate Minecraft sources for reference
./gradlew genSources

# Run Minecraft with the mod loaded
./gradlew runClient

License

MIT License — see LICENSE for details.