Handy Trader

Star your favorite villager trades and they sort to the top automatically. Perfect for big trading halls where you only use 2 out of 10 master trades per villager. Gold highlight, per-villager memory, zero dependencies.

Загрузки: 2K
Подписчики: 14
Обновлён: 24 июня 2026 г.
Лицензия: MIT

Опубликован 22 февраля 2026 г.

Исходный код Сообщить об ошибке

The Problem

You've got a trading hall with 20 villagers. Each one has up to 10 trades. You open the weaponsmith and scroll past six trades you never use to find the one you actually want. Every. Single. Time.

Say you're buying golden carrots from 8 maxed farmers — that's a master-level trade buried at the bottom of the list. Over a typical survival world, that adds up to 1,664 scroll wheel ticks and 20 minutes spent scrolling past bread and beetroot trades you'll never use. Your scroll wheel deserves better.

The Fix

Handy Trader lets you bookmark individual trades per villager. Favorited trades sort to the top of the list so the trades you care about are always right there when you open the UI.

Features

Click to favorite — click the top-left corner of any trade row to bookmark it with a gold corner indicator
Sort to top — favorited trades automatically move to the top of the list
Per-villager memory — each villager remembers its own favorites, saved across sessions
Zero dependencies — works standalone, config via JSON file

Optional Extras

Install YACL + Mod Menu for an in-game config screen. Without them, everything still works — just edit config/handytraders.json.

Compatibility

Client-side only — works against any vanilla server; no server install required
Minecraft (Fabric), requires Fabric API
⚙️ Optional: Mod Menu + YACL for an in-game config screen (not required)

Installation

Install Fabric Loader
Install Fabric API
Drop handytrader-x.x.x.jar into your mods/ folder
Launch the game — no server-side install needed

Part of the Handy series

Small Fabric mods that smooth over vanilla friction points:

Handy Shulker — bundle-like interactions for shulker boxes
Handy Bookshelf — enchantment glint and name tags for chiseled bookshelves
Handy Indicator — visual indicators on container blocks

Pure client-side. No gameplay changes. Just stops you from scrolling.

Handy Trader is open source under the MIT license.

Ченджлог

2.3.0-beta.2Бета26.3-snapshot-1 · 24 июня 2026 г.

Brings the 2.3.0 bulk-trade feature to the Minecraft 26.3 snapshot line.

Bulk-trade your favorited trades — Shift-click a favorited trade to repeat it until you run out of inputs or the villager locks the trade. Hover the gold bookmark corner for a reminder.
Optional "Bulk-trade all trades" setting (off by default) extends it to every trade, not just favorites.

2.3.0Релиз26.2 · 24 июня 2026 г.

Added

Bulk-trade your favorited trades. Shift-click a favorited trade to repeat it until you run out of inputs or the villager locks the trade — handy for dumping a chest of crops to a farmer or paper to a librarian without click-spamming. Hover the gold bookmark corner for a reminder of the gesture.
Optional "Bulk-trade all trades" setting (off by default) extends Shift-click bulk-trading to every trade, not just favorites — for when you'd rather not favorite first.
New settings for the above, plus a safety limit on how many trades a single Shift-click performs.

2.3.0-beta.1Бета26.3-snapshot-1 · 24 июня 2026 г.

Preview build for the Minecraft 26.3 snapshot cycle (tested against 26.3-snapshot-1).

Rebuilt against Fabric API 0.153.1+26.3 and YACL 3.9.5+26.3-fabric.
No feature changes were needed for 26.3.
ModMenu has no 26.3 build yet, so it won't list the mod on 26.3 until it updates — the config screen is still reachable through YACL.

2.0.4Релиз26.1, 26.1.1, 26.1.2 · 24 июня 2026 г.

Bug Fixes

Villager Trading Plus / "Easier Villager Trading" compatibility — now for 26.1 and 26.1.1 too. Clicking a favorited trade with "trade all on click" enabled does the bulk trade again instead of vanilla single-trade. This fix shipped in 2.0.3 but was only published for Minecraft 26.1.2; 2.0.4 publishes the same build for 26.1 and 26.1.1 as well. (#20)

2.2.1Релиз26.2 · 22 июня 2026 г.

Fixed a conflict with Villager Trading Plus (Easier Villager Trading). When a villager had a favorited trade, clicking it fell back to vanilla single-trade instead of that mod's "trade all on click". HandyTrader was cancelling the whole trade-selection method to apply the favorites reorder against the server; that cancellation also swallowed the other mod's hook. The reorder is now applied by remapping only the outgoing trade-select packet, so other trade mods run normally. (#20)

2.2.0Релиз26.2 · 16 июня 2026 г.

Updated for the Minecraft 26.2 full release.

Rebuilt against Fabric API 0.152.1+26.2 and Fabric Loader 0.19.3.
YACL updated to 3.9.4+26.2-fabric and ModMenu to 20.0.0-beta.2; with YACL's stable 26.2 build out, the in-game config screen is back in dev and live play.
Now declares compatibility with 26.2 and future 26.2.x point releases.

2.1.0-beta.4Бета26.2-pre-1 · 27 мая 2026 г.

Tracks Minecraft 26.2-pre-1 (first prerelease of the 26.2 cycle); skips snapshots 6, 7, and 8 since none broke this mod's surface.
Rebuilt against Fabric API 0.149.2+26.2.
YACL bumped to 3.9.3+26.2-fabric and ModMenu to 19.0.0-alpha.1 on the compile classpath. Neither has a build that explicitly lists 26.2-pre-1 in its game_versions yet, so they remain compileOnly — the in-game config screen returns to dev runtime once either ships a matching build.

2.1.0-beta.3Бета26.2-snapshot-5 · 30 апреля 2026 г.

Breaking

Mod ID renamed from handytraders to handytrader to match the rest of the Handy series convention (singular). Existing config (config/handytraders.json) and per-villager favorites (config/handytraders-favorites.json) are migrated automatically on first launch — no settings or favorites lost.
Internal package moved from net.rezanmb.handytraders to dev.handy.mods.handytrader. No user-facing impact unless another mod was depending on internal classes.

Changes

Trade-identity hash upgraded from 32-bit hashCode to 64-bit truncated SHA-1. Eliminates the silent collision risk where two distinct trades on the same villager could star/unstar each other. Existing favorites are rewritten to the new format the first time you reopen each villager — no manual reset needed, but villagers you never revisit stay on the old format.
Mod is now declared client-only (environment: "client"). Dedicated servers no longer load the jar; the mod was already client-only in behavior, this just makes it explicit.
Favorites file write moved off the render thread so toggling a bookmark on a slow disk no longer stalls the frame.
Config persistence rebuilt on YACL ConfigClassHandler (matches the rest of the Handy suite). On-disk JSON shape is unchanged; users without YACL installed still run on defaults.

Internal

Cleanup wave aligned this mod with the rest of the suite — JAVA_25 mixin compatibility level, full @At descriptors, named bookmark color palette, narrowed exception handlers, and a CI release workflow that no longer fails on prerelease tags.