Villagers: customers and suppliers

Villagers have wallets and spend them at players' vending blocks and market counters. At a buyback block they work the other way and sell you what they produce.

Who comes

Every 5 seconds each loaded block that qualifies gets a 25% chance to call one villager from within 32 blocks. A block qualifies when it belongs to a player, sells for money, has stock, and has "Villagers can buy: yes".

The villager must be an adult with a bed and a job site, awake, not panicking and not trading with someone. It comes in the daytime only. It walks to the front of the block, looks at the goods for 3 seconds and decides. If it can't get there within 30 seconds it gives up. After a visit the same villager stays away for 5 minutes. One visit is up to 3 trades.

What they buy

Everyone buys food: bread, baked potato, apple, cooked meat and fish, pumpkin pie, cookie, cake, mushroom stew, honey bottle, sweet berries, carrot, golden carrot. The rest depends on the profession:

• armorer: iron ingot, coal, charcoal, lava bucket
• butcher: coal, charcoal, dried kelp block
• cartographer: paper, compass, glass pane
• cleric: glass bottle, nether wart, redstone, gold ingot
• farmer: bone meal, any hoe, wheat seeds, beetroot seeds
• fisherman: fishing rod, string, bucket
• fletcher: feather, flint, string, stick
• leatherworker: leather, rabbit hide, flint
• librarian: paper, book, ink sac, feather
• mason: clay ball, stone, nether quartz
• shepherd: shears, any dye, string
• toolsmith: iron ingot, coal, stick
• weaponsmith: iron ingot, coal, flint

The price they accept

Every item a villager can buy has a fair price in a data pack. Bread is 0.6, a baked potato 0.3, an apple 0.75, a steak 0.6, a cake 3. The villager compares your price per item with it:

• At the fair price or below, it buys.
• Between the fair price and 1.5 times it, the chance drops evenly to zero.
• Above 1.5 times, or when the item has no fair price, it never buys.

The village type moves the fair price of some goods up or down. The lists are under markets and caravans.

Each trade lowers that village's demand for the item by 5%, and demand comes back by 25% a day. Selling one thing to one village all day stops working.

Fair prices raise your reputation with the village through vanilla gossip. A good reputation brings more visits (it scales the chance between ×0.5 and ×2) and the usual vanilla discounts. Asking 1.25 times the fair price or more lowers it.

The goods a villager buys disappear, and you get the price minus the 2% fee.

Wallets

A wallet refills once per in-game day, by profession level:

• no profession, or a nitwit: 1
• novice: 3
• apprentice: 5
• journeyman: 8
• expert: 12
• master: 18

It holds 3 days of wages at most. Wages are multiplied by the village's level, from ×1 to ×2. All the villagers of one village together spend at most 200 a day at players' blocks, and that cap grows with the level too, up to ×3.

What you pay a villager in its trade window lands in its wallet, so a villager you trade with becomes a richer customer.

Suppliers

Set a buyback block to "Villagers can sell: yes" and villagers bring it what their profession produces. You pay: the money goes from your balance into their wallets. A supplier sells only if your block pays at least 80% of the fair price in that village. It makes up to 2 trades a visit and keeps at most 2 days of produce.

Produce per day at novice level:

• farmer: 16 wheat, 12 potatoes, 12 carrots, 8 beetroots, 8 melon slices, 2 pumpkins
• fisherman: 8 cod, 4 salmon
• butcher: 4 each of beef, porkchop, chicken and mutton, 2 rabbit
• shepherd: 8 wool
• mason: 32 cobblestone, 16 stone, 8 bricks
• fletcher: 16 sticks, 8 arrows, 4 flint
• librarian: 8 paper, 2 books
• cartographer: 8 paper, 4 glass panes
• cleric: 4 redstone, 2 lapis lazuli, 2 glowstone dust
• leatherworker: 4 leather, 2 rabbit hide
• armorer: 4 coal, 2 iron ingots
• toolsmith: 6 coal, 1 iron ingot
• weaponsmith: 4 coal, 4 flint, 1 iron ingot

Each level above novice adds 25%, so a master makes twice as much.

If nobody comes

• The block must sell for money. Item prices and buyback don't count, and the villagers button has to say "yes".
• There must be villagers with a bed and a workstation within 32 blocks.
• The price must be at most 1.5 times the fair price, and the item must have a fair price at all.
• It has to be day, and the chunks have to be loaded. Villagers don't walk in unloaded chunks.
• A village that bought a lot of one item today wants less of it.
• Blocks owned by the server, like the ones on village markets, never get villagers.