Description
# 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`).
| Command | Description |
|---|---|
| `/vtp` | Opens the GUI |
| `/vtp seed <seed>` | Sets the seed (required for multiplayer) |
| `/vtp target <enchantment> <level>` | Sets your target enchantment |
| `/vtp maxrerolls <number>` | Sets the max rerolls for the engine search |
| `/vtp toggle` | Toggles the HUD |
| `/vtp calibrate <enchantment> <level>, …` | Calibrates the reroll list to fix an offset |
| `/vtp confirm <round>` | Confirms which reroll round the villager is on |
### 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.