
Villager In A Bucket
Pick up a villager in a bucket!
Screenshots






About this Mod
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

Different textures depending on the villager type

Custom advancements

Zombie Villagers in buckets

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
Available Versions
How to Install Villager In A Bucket on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bukkit Loader
In the panel under "Egg", select the bukkit loader and matching Minecraft version (26.2).
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
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+21 more)
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install Villager In A Bucket with just one click on your server.

