# Villager Trading Predictor

If you have ever spent twenty minutes breaking and replacing a lectern hoping to finally see **Efficiency V** or **Mending** show up, this mod is for you. VTP reads a villager's hidden trade sequence and makes it visible, so you always know what you're working with before you commit to a reroll.

---

## Features

### 🔁 Reroll List
Every villager has a hidden sequence of trades determined by their seed. The reroll list makes that sequence visible, so you know exactly what is coming next.

### 🎯 Target List
Have a specific enchantment in mind? Add it to your target list and VTP will calculate exactly how many rerolls stand between you and that trade.

### 📊 Enchantment Prediction by Level
VTP does not just look at the next trade. It predicts the enchantments a villager will offer at every profession level, giving you a full picture of what that villager is worth before you invest anything.

---

## Commands

All commands are also available in a GUI form (`/vtp`).

### Calibration
Offsets in the reroll list can occur frequently, especially on multiplayer servers. To fix this:

1. Check the current enchantment being offered by the villager
2. Run `/vtp calibrate <enchantment> <level>, <enchantment> <level>, …`
3. Confirm the current round with `/vtp confirm <round>`

---

## ⚠️ Multiplayer Limitations

To keep this mod client-only, some corners had to be cut. On singleplayer it works well, but servers introduce some unavoidable constraints:

- There is a single shared trade list, so there is **no way to sync state across multiple players**
- **Day/night rerolls cannot be tracked automatically**
- **The seed has to be known for it to work**

Use `/vtp calibrate` (or the GUI equivalent) to correct any drift.

Villager Trading Predictor

Looking for Mending or Efficiency V? VTP shows upcoming librarian trades and helps you find the enchantments you want before spending another twenty minutes breaking lecterns.

VTP is a client-side Fabric mod. No server installation is required.

Features

• Upcoming trades: See the current offer and upcoming rerolls in a compact HUD.
• Enchantment targets: Choose an enchantment, level, and maximum price to find matching trades.
• Cheapest price targeting: Automatically target the lowest possible base price for your selection—for example, Mending I for 10 emeralds.
• Level predictions: Preview enchanted-book offers for future profession levels.
• Clear locked trades: View each existing book on its own row, alongside predictions for remaining levels.
• Customizable interface: A Jade-inspired HUD with Minecraft item icons, adjustable size, live previews, and an RGB/Hex accent-color picker. Jade is not required.
• HUD visibility rules: Keep the HUD visible, hide it after a delay, hide it outside a chosen range, or show it only while looking at a villager. Visibility changes fade smoothly.

Getting Started

Singleplayer: Look at a librarian and open its trades. VTP reads the current trade-sequence state automatically; no seed entry or calibration is needed.

Multiplayer: Enter the world seed using /vtp seed <seed>, then open the librarian’s trades. Calibration may be needed to align predictions.

Open /vtp to manage targets, inspect predictions, and customize the interface.

Commands

Multiplayer Calibration

If predictions drift, use the Calibrate tab or record consecutive rerolls from the same villager and profession level.

For example:

/vtp calibrate efficiency 3; none; mending 1

Replace the example with your actual observations. Use none for a round without an enchanted book. Each entry represents a separate reroll—not separate books from one trade screen.

If several matches remain, add more observations to narrow them down. Use /vtp confirm <round> to confirm a reported candidate.

Things to Know

• Trade sequences are shared between villagers. Another villager generating trades can change future predictions while existing offers remain unchanged.
• Multiplayer requires the world seed. Activity from other players or unloaded villagers can cause drift and require recalibration.
• Predicted prices and target limits use base prices, before discounts and other player-specific adjustments.
• VTP supports standard vanilla librarian trades. Trade Rebalance and custom trading systems are not supported; server-only changes cannot always be detected.