Villager Bucket

Quickstart

1. Hold an empty bucket in your main hand.
2. Left-click (attack) a villager to scoop them up — your bucket is replaced with a Villager Bucket.
3. Left-click a block or mob (or press the Use button) while holding the Villager Bucket to release the villager in front of you. The Villager Bucket turns back into an empty bucket.

That's all there is to it — no crafting required for the Villager Bucket itself.

Overview

Villager Bucket is a simple transport addon. It lets you capture any villager into a special bucket item and release them wherever you like. This makes it easy to move villagers between builds, set up new villages, or rescue a wandering trader from danger — all without minecarts, boats, or leads.

What It Adds

The Villager Bucket displays the tooltip "Contains: Villager" and the reminder "Left-click a block or mob to release" when you inspect it in your inventory.

How To Use

Capturing a Villager

• Equip a vanilla empty bucket in your main hand.
• Walk up to any villager and left-click (attack) them.
• A splash sound plays, your action bar shows "Villager scooped into the bucket", and the empty bucket becomes a Villager Bucket.
• If you were holding a stack of buckets, only one bucket is consumed; the rest remain in your hand and the Villager Bucket is added to your inventory (or dropped at your feet if your inventory is full).

Releasing a Villager

• Hold the Villager Bucket in your main hand.
• Left-click any block or mob, or press the Use (right-click / interact) button.
• The villager spawns a short distance in front of you in the direction you are facing.
• A splash sound plays, your action bar shows "Villager released from the bucket", and the Villager Bucket reverts to an empty bucket.

Abilities And Mechanics

• Unstackable — the Villager Bucket always occupies a single inventory slot and cannot be stacked.
• No data persistence — the released villager is always a freshly spawned villager. Profession, trades, and name are not preserved across capture and release.
• Release direction — the villager appears roughly 1.5 blocks ahead of you based on your view direction, so face the spot where you want them to land before releasing.
• Capture guard — releasing and capturing cannot happen in the same game tick, preventing accidental re-capture immediately after release.

Progression And Strategy

• Village setup — capture villagers from an existing village and carry them to a new location to seed a fresh trading hall or outpost.
• Bed linking — release villagers inside or adjacent to a structure with beds so they claim beds and begin populating the new area immediately.
• Safety transport — if a villager is in a dangerous or hard-to-reach spot, scoop them up and relocate them without needing rails, boats, or a lengthy lead-and-push journey.
• Stack your empties — bring a stack of empty buckets if you plan to move many villagers at once; each capture only consumes one bucket from the stack.