Wandering Villager

Getting your first villager is one of the great unspoken chores of Bedrock. Either you find a village 900 blocks away and build a minecart line of genuine engineering ambition — at the end of which your librarian clips through the rail, wanders into a hole and drowns — or you cure a zombie villager. And if you play on Peaceful, that second door was never open to you at all, because zombie villagers don't spawn. The entire trading economy sits behind a lock you weren't given a key to.

Meanwhile, the Wandering Trader. Turns up unannounced. Two llamas in tow. Stands in your doorway. Sells you a bucket of tropical fish. Vanishes forty minutes later having contributed nothing to your life.

He is, structurally, a villager who has simply refused to commit.

Wandering Villager gives you the means to change his mind.

Hand him a contract. That's the whole addon.

Craft a Settlement Contract from paper, an ink sac and a gold ingot — shapeless, on any crafting table — and use it on any Wandering Trader.

He'll stop. He'll consider his life choices. And over the next thirty seconds he settles down, to the same sound the golden apple makes when you cure a zombie villager. Then he's a villager. A real one, permanently.

No commands. No config menu. No experimental toggles. One item, one right-click.

You'll see him make up his mind

New in 1.1.0: the whole conversion has its own effects, so you always know how it's going.

• The handshake — the contract flies from your hand into his, with a flash of gold
• The deliberation — a spiral of sparkles wraps around him, turning slowly from trader blue to villager emerald as he comes round to the idea
• The countdown — a ring pulses at his feet like a heartbeat, quickening over the last ten seconds and chiming over the last five
• The homecoming — sparkles rush in, and he steps out a villager in a burst of emeralds, to the sound of a zombie villager's cure and a contented "hmm"

The actionbar tells you when he's started, when he's done, and — if it comes to that — when it's all gone wrong.

Thirty seconds you have to see him through

This is deliberate, and it's the bit that makes it feel earned rather than cheap. Curing a zombie villager takes time and exposes you to risk, so this does too.

If the trader dies before he's finished settling in, the contract dies with him. You'll know: he fizzles out in a puff of grey smoke. Stand between him and anything with teeth. Bring a shield. See him through it.

He won't trade while he's settling, either — so if you want his stock, buy it before you hand over the contract. And he can't quietly despawn on you mid-conversion, even if you've bought him out or he's near the end of his visit. Once he's started, he finishes or he dies trying.

He arrives unemployed, and looking local

The new villager turns up unemployed and adult, so the profession is entirely your call — drop a job site block in front of him and he'll take up whatever you want him to be.

His skin matches whatever biome you convinced him in. Talk him round in a desert and you get a desert villager; do it in a taiga and you get a taiga villager. Desert, jungle, savanna, snow, swamp, taiga and plains are all covered, exactly as though he'd been born there.

Named him with a name tag? He keeps his name.

The llamas keep their freedom

His two leashed llamas are suddenly unemployed themselves. Rather than leaving them orphaned or deleting them, they're set loose as ordinary adult llamas — yours to tame, carpet and load up as you see fit. Only his own llamas, mind: another caravan passing by is left well alone.

The point: it works on Peaceful

Every ingredient is obtainable without an existing villager and without a hostile mob. No zombie villagers, no raids, no curing, no trading for the thing that unlocks trading.

If you've ever started a Peaceful world and quietly accepted that the economy simply wasn't for you, this is the addon that opens the door.

Plays nicely with other addons

Wandering Villager overrides exactly one vanilla file — the Wandering Trader's behaviour file — so it only conflicts with other packs that change the trader's behaviour. Its resource pack only adds files and overrides nothing, so health bar packs, name tag packs and retextures all work alongside it.

Notably, it does not override the trader's trade table. An earlier build sold the contract as a trade, which would have made this addon mutually exclusive with every other pack touching trader trades. The flavour wasn't worth the conflict, so the contract is crafted instead.

The conversion itself is data-driven, so it survives world saves, chunk unloads and logging out halfway through. Settle him in the middle of a village and only he changes; the neighbours are left exactly as they were. Runs on the stable Script API — no Beta APIs, no experimental features, achievements intact.

Installation

1. Download the .mcaddon file
2. Open it — Minecraft imports both packs automatically
3. When creating or editing a world, activate the Wandering Villager behaviour pack (the resource pack comes with it)
4. Enter the world, craft a contract, and go and find someone to talk into settling down

Features

• Convert any Wandering Trader into a permanent, ordinary villager
• Settlement Contract crafted from paper, an ink sac and a gold ingot
• Thirty second conversion you have to actively protect, modelled on curing a zombie villager
• Custom particle effects from handshake to homecoming, with the vanilla cure sounds
• A heartbeat countdown, so you can see and hear how long is left
• Actionbar messages when a conversion starts, finishes or is lost
• Traders won't trade while they're settling down
• Traders can't despawn mid-conversion
• Villagers arrive unemployed and adult, so you choose the profession
• Villager skin matched to the biome you convert in
• Name-tagged traders keep their name
• The trader's own llamas freed as ordinary adult llamas rather than orphaned
• Fully playable on Peaceful — no zombie villagers required
• Every ingredient obtainable without an existing villager
• Conversion survives world saves, chunk reloads and logging out
• Overrides a single vanilla file, and leaves the trade table alone
• Works in the Overworld, the Nether and the End
• No experimental features — achievement friendly

Requirements

Minecraft Bedrock Edition 1.26.30 or higher.

Credits

Developed by: Rob 'myGen' Hall Website: mygen.co.uk

Licensed under CC BY-NC-SA 4.0.

For issues, suggestions or questions, visit mygen.co.uk.

Some people just need asking.