Skip to content

BucketLib

Library mod for custom buckets

FabricNeoForgeForgeQuilt
Loaders
FabricNeoForgeForgeQuilt
Downloads on Modrinth
194K
Followers on Modrinth
26
versions
371
Updated
October 1, 2026Oct 1
Published
in 2022
This is a library — other mods need it, and it adds nothing to the game by itselfRequired by 8 mods. Download it if another mod needs it.

At a glance

A library: other mods need it — required by 8 mods
Runs on Fabric, NeoForge, Forge and Quilt
For Minecraft 1.20.6–1.21.1, 1.21.3–26.3 …
Needed in the game and on the server
Latest version — 26.3-5.3.0.1 from October 1, 2026
License MIT — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.20.4, 1.20.6–1.21.1, 1.21.3–26.3 …

BucketLib

BucketLib is a Minecraft library mod for developers (Forge, NeoForge, Fabric, Quilt). The purpose is to provide functionality for developers to add their own buckets without having trouble implementing all special cases. To add this mod to your environment, see the Developer Guide

Dependencies

The Fabric / Quilt version needs the following mods:

Features

  • Compatible with all fluids: Water and Lava as well as all modded fluids are supported by buckets generated with this library mod.
  • Entities can be obtained: Entities like axolotl, fish, tadpole and mobs of other mods can be obtained.
  • Bucketable Blocks can be obtained: Powder Snow and bucketable blocks of other mods can be obtained.
  • Compatible with all milk special cases: Entities like cows and goats can be milked and the milk is drinkable. Buckets filled with milk are also compatible with mods that contains a milk fluid.
  • Dispense Behaviour works out of the box
  • Fluid Handling: All buckets that are generated by this library mod are compatible with mods that are using fluid container items.

Highly configurable buckets

  • Obtaining fluids, entities and blocks can be limited by using allow lists and deny lists or by using the fluid temperature.
  • Buckets can be configured to crack when a fluid temperature exceeds a special value.
  • Option to define burning & freezing effect for fluid temperatures, fluids & blocks
  • Coloring a bucket can be enabled
  • Milking entities can be disabled

FAQ

Can I use this mod in my own mod or mod pack?

Yes, you are allowed to use this mod in your mods and mod packs

Port to another Minecraft version? Which versions are supported?

Sorry, but I do not backport any mod to an older version. Here is a list of all supported and planned versions: Minecraft mod versions of cech12

Is there a Fabric version?

Since 1.20.4 the mod is available for Fabric & Quilt. There is no plan to backport Fabric support to earlier Minecraft versions.

Where is the config file?

There is a defaultconfig directory, where you can find it. If you change something there it has only an effect on new savegames. For existing savegames you need to go to the serverconfig directory of the savegame.

I found a bug or I have a good idea to enhance this mod!

Very good! Open an issue at Github or contact me on Discord.

FAQ

How to install BucketLib?

Install Fabric for your Minecraft version, download BucketLib for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does BucketLib support?

BucketLib has builds for Minecraft 1.18.2–1.20.2, 1.20.4, 1.20.6–1.21.1, 1.21.3–26.3.

Is BucketLib needed on the server?

Needed in the game and on the server

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More