TradeHunter

TradeHunter is a client-side mod for Minecraft that automatically cycles villager trades to search for specific enchanted books that meet user-defined conditions (enchantment, minimum level, and maximum price).

The mod works together with the Trade Cycling mod to repeatedly refresh villager trades until a desired enchantment appears.

Features

Automatic villager trade cycling
Detection of enchanted book trades
Filtering by:
- Enchantment ID
- Minimum enchantment level
- Maximum emerald cost
In-game command system to manage targets
Chat feedback showing detected trades
Config file saved automatically

Requirements

The mod requires the following:

Minecraft 1.21.4
Fabric Loader
Fabric API
Trade Cycling

Dependencies:

Installation

Install Fabric Loader.
Install Fabric API.
Install Trade Cycling.
Download the latest tradehunter-x.x.jar.
Place the file in:

.minecraft/mods

Launch Minecraft using the Fabric profile.

Usage

Open a villager trading screen and press:

This toggles the TradeHunter search.

If the desired trade is found, the search stops automatically.

Commands

All commands start with:

/th

Add target enchantment

/th add <enchantment> <level> <max_price>

Example:

/th add mending 1 30
/th add efficiency 5 64

This means:

Mending level ≥ 1 and price ≤ 30
Efficiency level ≥ 5 and price ≤ 64

List targets

/th list

Displays all active search targets.

Clear targets

/th clear

Removes all saved targets.

Config

Targets are saved automatically in:

config/tradehunter_targets.json

Example:

[
  {
    "id": "minecraft:mending",
    "level": 1,
    "maxPrice": 30
  }
]

How it Works

TradeHunter reads villager trades when the trading screen is open.
If the result item is an enchanted book, the mod checks:

enchantment id
enchantment level
emerald price

If none of the configured targets match, the mod triggers the Trade Cycling button to refresh trades.

Keybind

Default key:

Used to start or stop the search.

License

MIT License

Author

SGAL

Trade Hunter