Villager In A Bucket

Villager In A Bucket

Pick up a villager in a bucket!

by
425.7K Downloads
bukkitfabricfoliaforgeneoforgepaperpurpurspigotcursedmobstransportation
Rent Server with this Mod

Screenshots

Before
After
Different bucket textures
Custom advancements
Villager information
Before

About this Mod

Banner
Discord
X (formerly Twitter) Follow
Static Badge GitHub

Do you find moving villagers annoying? Do they keep running off? Is transporting them by boat getting on your nerves? Do you want to be able to just pick them up? Well this mod helps you with that! You can now click a villager with a bucket and pick them up with ease! No longer will you have to suffer through the annoying boat rides while transporting a single villager at a time, just collect them with buckets!

WE NOW SUPPORT PAPER/PURPUR SERVERS WITH A PLUGIN WOOOOOO, CHECK OUT THE "VILLAGER IN A BUKKIT" VERSION

Mod vs Plugin

This page has downloads for both a mod and plugin. The mod only works when installed on both the client and server. The plugin does not work with the mod, it is for separate use with a Vanilla client. The plugin will download a resource pack which can also be found here.

Features

  • Pick up a villager with an empty bucket
  • Textures depending on Villager region. Only if they have head decorations (Snow, Desert, Swamp and Savanna) - Both mod and server side only plugin!
  • Works with Wandering Traders and Zombie Villagers!
  • Information about the specific villager is saved, nametag, job, trades etc
  • Item lore with information about the specific villager in the bucket
  • Custom advancements! - Mod only
  • Support for collecting and dispensing the villager with a dispenser

Kidnap villagers

Villager being kidnapped

Different textures depending on the villager type

Varients

Custom advancements

Custom Advancements

Zombie Villagers in buckets

Zucket

Planned

  • Attempt to properly support modded Villager types and bucket textures - Mod only
  • Make Villager spawned from bucket without NBT data (Creative item) spawn Villager with biome specific clothing like spawn egg does - Mod only

Usage

To use this mod just get an empty bucket and right click a villager! It's that easy.

Requirements

This mod requires the Architectury API to be installed along with the mod

As of 1.20.1-1.2.0 and 1.20.2-1.1.0 Architectury API is no longer required. Only earlier versions of the 1.20.1 and 1.20.2 builds require it, any possible 1.19.X or earlier builds do not require it (May be coming in the future).

Configuration

Mod

There are currently two options in the config file which can be found in <minecraft directory>/config/villager-in-a-bucket.properties.

enable-zombie-villager sets whether a Zombie Villager can be picked up in a bucket. It does not remove the Zombie Villager In A Bucket item when disabled. Default is true

Plugin

Old config settings have been deprecated in favour of using permissions. Please read https://github.com/JustDoom/VillagerInABukkit/wiki/Configuring-using-permissions

# Should the dispenser be able to pick up or place these villager types. Since players use permissions to determine this
# a config option is used here
dispenser:
  villager:
    pickup: true
    place: true
  wandering-trader:
    pickup: true
    place: true
  zombie-villager:
    pickup: true
    place: true

# Should the server ask the client to download a resource pack when they join
resource-pack: true

# The below options are commented out so that it uses the right resourcepack version for the minecraft/plugin version by default
# If you want to override it/manually use an updated resourcepack you can uncomment and override them

# The URL to download the resource pack from
#resource-pack-url: "https://cdn.modrinth.com/data/9tf9GGch/versions/ZBgqIN0Y/VillagerInABukkitPack.zip"
# The SHA-1 hash of the resource pack ZIP
#resource-pack-hash: "f2d4dd5bf8ee221234b738236099b2592c58b8e8"
# The ID for the resource pack. Please do not touch unless you know what you are doing
#resource-pack-id: "68a4b411-e409-4d89-b563-66049ba4914b"

# Should any villager placing and picking up be logged to the console
console-logging: false
# Should any villager placing and picking up be logged to a file
file-logging: false

Support

Support can be provided on my discord server or you can report any bugs for the mod on the GitHub repository here. For the plugin please use this one

If you need a new server check out our partner lagless.gg

Lagless
Use code Dinonuggies for 20% off!

Available Versions

VillagerInABucket NeoForge 1.21.6 v1.1.0release
MC 1.21.6, 1.21.7, 1.21.8neoforge
July 31, 2026
VillagerInABucket Forge 1.21.6 v1.1.0release
MC 1.21.6, 1.21.7, 1.21.8forge
July 31, 2026
VillagerInABucket Fabric 1.21.6 v1.1.0release
MC 1.21.6, 1.21.7, 1.21.8fabric
July 31, 2026
VillagerInABucket Forge 1.21.5 v1.1.0release
MC 1.21.5neoforge
July 31, 2026
VillagerInABucket Forge 1.21.5 v1.1.0release
MC 1.21.5forge
July 31, 2026

How to Install Villager In A Bucket on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set bukkit Loader

In the panel under "Egg", select the bukkit loader and matching Minecraft version (26.2).

3

Install Mod

Open the mod browser in the dashboard and search for "Villager In A Bucket". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

bukkitfabricfoliaforgeneoforgepaperpurpurspigot

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+21 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Villager In A Bucket server crashes on startup – what to do?

Most common cause: wrong bukkit version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.

Is Villager In A Bucket compatible with bukkit and fabric and folia and forge and neoforge and paper and purpur and spigot?

Villager In A Bucket officially supports bukkit, fabric, folia, forge, neoforge, paper, purpur, spigot for Minecraft 26.2, 26.1.2, 26.1.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Villager In A Bucket – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Villager In A Bucket consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Villager In A Bucket with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+14 more