A useful trading hall is not just a row of villagers with lecterns in front of them. Each librarian needs the right trade, the correct workstation and a chance to use it. Build and verify one working station before copying the design; otherwise, a small ownership mistake becomes a whole row of villagers that will not restock.
This guide covers vanilla Java Edition 26.3 with the default trading rules. The optional Villager Trade Rebalance experiment has a different librarian progression, explained separately below. Server plugins, custom data packs and Bedrock mechanics are outside this setup.
Decide which trading rules your world uses
Under default rules, a novice librarian can offer Mending. You do not need a swamp villager or a master-level librarian just to make that book possible. Possible does not mean guaranteed: the initial offers can contain another enchantment or no enchanted-book offer at all.
With Villager Trade Rebalance enabled, Mending instead belongs to the master-level swamp librarian's special trade. That is a different progression route, not an extra requirement that every Java world acquired in a normal update.
| World rules | Sensible Mending plan | Unnecessary or ineffective work |
|---|---|---|
| Default vanilla trading | Inspect an untraded novice librarian and reroll until you have an offer worth keeping | Transporting villagers to a swamp because you think the biome is mandatory |
| Villager Trade Rebalance experiment | Obtain the swamp villager variant and progress that librarian to master | Repeating novice rerolls while expecting the default Mending route |
| Custom server trade rules | Establish the server's actual trading rules before building the hall | Assuming the vanilla table overrides a plugin or data pack |
The experiment is not enabled by default. If you play on a server, ask its owner which rules it uses rather than inferring the setting from a long unlucky reroll session. Repeatedly missing a book does not establish that the experiment is on.
A swamp librarian means the villager's biome variant, not merely a lectern placed in a swamp. Moving an existing plains villager there does not change its outfit. This guide's main workflow stays with default trading; do not spend a default-world afternoon solving an experimental-world requirement.
Choose a candidate who can actually become a librarian
Use an adult unemployed villager that has never been traded with. Babies cannot take the job, and nitwits cannot become librarians. The job block is a lectern.
Trading once locks the villager's profession and existing offers. The transaction does not have to be an enchanted-book purchase: selling paper also counts. Opening the trade window to inspect offers is not a completed trade.
This creates an important distinction between a novice and an untraded novice. A villager can still display the novice badge after its first transaction, but you have already committed to it. Do not use the badge alone as proof that rerolling remains available.
For example, the default paper trade gives the villager two profession XP per sale, while reaching apprentice requires ten. One paper sale leaves the villager below apprentice, yet the trade is already locked. Five such sales reach ten XP. Those are villager profession points, not the experience levels in your own hotbar.
If you accidentally locked an unwanted set of offers, keep that villager if its other trades are useful and recruit another candidate for rerolling. Breaking its lectern repeatedly will not undo the transaction.
Assign one workstation before building the next stall
Job sites have owners. A lectern already claimed by one villager is not a shared restocking station for everyone beside it. A nearby block is therefore not proof that the librarian in front of you owns it.
For a first station, use a secure, well-lit workspace and make the intended lectern easy to reach at the villager's floor level. Keep other unassigned candidates away from the setup while you establish the connection. Avoid filling the area with spare job blocks before you know who is using what.
- Bring in one eligible candidate and place one lectern beside its working space.
- Watch that candidate acquire the librarian profession, then inspect its offers without completing a transaction.
- If the offers are unsuitable, remove that lectern and let the candidate lose the job before placing it again.
- If it does not respond, investigate another claimed workstation or a different villager taking the new lectern; do not assume that faster block placement will solve ownership.
- Once you keep an offer, complete one affordable trade and label the station with the enchantment, level and price you accepted.
- Confirm that this station can restock before adding the next candidate.
The label is a record of your buying decision, not a promise that the price can never move. Include the enchantment level: Unbreaking I and Unbreaking III are not interchangeable just because the first word matches.
When expanding, retain the same one-at-a-time process. A row of ten empty stalls does not need ten available lecterns while the first candidate is still choosing its job. Finish the connection you are working on, then expose the next workstation.
A compact station should be easy to inspect
| Area | Purpose | A useful design choice |
|---|---|---|
| Villager working space | Allows access to the assigned lectern | Keep the block directly adjacent and avoid complicated elevation changes |
| Player access | Lets you inspect and buy without moving the villager | Leave a clear service side rather than trading through a crowded transport route |
| Label and supply storage | Keeps the purchasing plan visible | Store ordinary books and emeralds nearby, separate from finished enchanted books |
| Expansion space | Makes the next station easier to commission | Add another worker only after the first has demonstrated a restock |
Use plain geometry until the station works. Add decorative trapdoors or transport later, one change at a time, so any new access problem has an obvious place to start.
Reroll before the first trade, not after leveling up
Under default rules, the novice librarian selects two offers from a pool of three: buying paper, selling a bookshelf and selling an enchanted book. A novice with only paper and a bookshelf is not broken. It has generated a valid pair of offers.
If your objective is one specific book, inspect that first offer set before investing resources in levels. Leveling can reveal additional trades, but the first completed transaction has already ended the option to reroll that villager's starting offers.
Java 26.1 changed trade generation to world-seed-based random sequences. Mojang explicitly states that rerolling still produces a randomized sequence of trades. There is no guaranteed number of lectern resets that will produce Mending.
Keep emeralds and an ordinary book ready before searching. If the desired offer appears, you can secure it immediately instead of leaving an untraded candidate while you go looking for materials. You may also lock the offer through another available trade if that transaction is easier to fund.
Do not destroy a useful offer solely because it is not the cheapest imaginable one. The time spent searching for a lower price is also a cost. A practical first librarian can supply your immediate equipment; you can pursue a cheaper duplicate later without giving up that working source.
Separate stock, ownership and price problems
An exhausted trade shows a red X. That means its current stock is used up, not that the enchantment has disappeared or the profession has unlocked. Villagers replenish offers by working at their job sites, up to twice per day.
In Java, a bed is not required for restocking. Adding beds does not repair a mismatched lectern. Keep the basic question focused: can this librarian work at the workstation it actually owns?
| What you see | First action | What not to do |
|---|---|---|
| A previously usable book has a red X | Give the villager a normal work opportunity, then check stock again | Start rerolling a trade you already locked |
| One worker fails while its neighbors refill | Inspect that station's ownership and access | Rebuild the entire hall before isolating the failed station |
| Every worker stops after heavy trading | Consider the daily restock limit and wait through the next work period | Expect unlimited refills from replacing blocks |
| The trade is available but costs more | Treat it as a price issue, not a stock issue | Buy materials using the old price without recalculating |
| A candidate never becomes a librarian | Return to eligibility and job assignment | Spend emeralds trying to fix a profession it never acquired |
For a clean diagnostic, change one thing at a time. Keep the affected villager safe, restore an uncomplicated adjacent lectern and observe a work period while you remain nearby. Close the trading screen between checks so the villager has the opportunity to resume its normal activity.
If you must reassign workstations in an established hall, handle one locked worker at a time. Its profession and offers survive losing the block, but it still needs a suitable connection to replenish stock. Breaking every lectern simultaneously creates a larger ownership puzzle than the one you started with.
Do not deliberately break the workstation of an untraded librarian whose offer you want to keep. Lock the offer first. That distinction matters when troubleshooting a mixed hall of finished workers and candidates still being rolled.
Work out the book bill before designing an emerald farm
An enchanted-book purchase requires emeralds plus an ordinary book. The ordinary book is a separate input, not something your emerald supply replaces.
Suppose you accept an offer of 18 emeralds plus one book and want six copies. At that unchanged displayed price, the purchase bill is 108 emeralds and six ordinary books. An alternative offer of 30 emeralds would cost 180 emeralds for the same six copies: 72 more.
| Planned copies | At 18 emeralds each | At 30 emeralds each | Ordinary books needed |
|---|---|---|---|
| 1 | 18 | 30 | 1 |
| 6 | 108 | 180 | 6 |
| 12 | 216 | 360 | 12 |
These are hypothetical accepted offers, not a statement that Mending always costs either amount. Prices can move with demand and reputation. Use the current displayed price when you actually place the order.
If you fund the six-copy, 108-emerald purchase entirely through a paper trade at its default rate of 24 paper for one emerald, the arithmetic is 108 × 24 = 2,592 paper. That is 40 full stacks of 64 plus 32 paper. It is a useful material budget, not a promise that one villager will buy that amount immediately or maintain that price forever.
This is why an emerald source should match your actual demand. Supplying one player's initial tools is a different project from selling books to a whole multiplayer group. Begin with the purchase list; expand production when the list justifies it.
Stock capacity is not the same as daily output
A librarian's enchanted-book offer has 12 uses per stock. Its paper-buying offer has 16. That means the six-copy example fits inside a full book stock, while earning 108 emeralds through one paper offer takes multiple replenishments.
At the unchanged paper price, six full stocks produce 96 emeralds; another 12 sales reach 108. You need seven stock batches in total. Counting the materials without counting those batches hides the waiting time.
One full book stock plus two complete replenishments would provide capacity for 36 purchases. That is a conditional capacity calculation, not a guaranteed 36-book output every day: the worker must be able to restock, the relevant opportunities must remain, and you need the inputs to buy the books.
If a group needs 20 copies at once, one fully stocked librarian cannot provide all of them in the first batch. You can split the purchase across a restock or recruit a second librarian with the same offer. A duplicate is useful when demand exceeds one worker's available stock; it is not automatically necessary for a player who needs only a handful of copies.
Finish a small hall before chasing a perfect one
Start with a short list of books you will use soon, one dependable emerald source and storage for the inputs. Verify a restock on every completed station. Then decide whether the next improvement is another enchantment, cheaper pricing or more capacity for an existing book.
Those are different upgrades to the hall. More stalls do not fix a broken workstation connection. A cheaper librarian does not create paper. An enormous paper farm does not remove the book trade's stock limit.
The reliable order is simple: establish the rules, find an eligible candidate, secure a useful offer, prove the workstation works, and only then scale the design.
Default trading and restock reference
The community-maintained Minecraft Wiki separates Java and Bedrock offers and explains stock and prices.
Read the wiki referenceOptional Villager Trade Rebalance
Use this separate reference only for a world with the experiment enabled.
Read the wiki reference
Latest comments
Log in to join the conversation
Log InNo comments yet. Be the first to share your thoughts!