ModsFinder

BucketLib

by cech12

BucketLib is a library mod that lets developers add custom buckets for fluids, entities and blocks without handling each special case by hand.

FabricForgeNeoForgeQuiltClient and serverMIT LicenseOpen source1.18.2 – 26.3

What it does

Buckets generated through the library accept any fluid, including Water, Lava and fluids added by other mods, and stay compatible with mods that use fluid container items. Entities such as axolotls, fish and tadpoles can be picked up in a bucket, as can Powder Snow and other bucketable blocks from other mods. Milking works for cows and goats, and the resulting milk is drinkable and works with mods that include a milk fluid.

The purpose of the mod is to give developers a foundation for their own bucket items. Restrictions on collecting fluids, mobs and blocks can be set with allow lists and deny lists, or by fluid temperature, and buckets can be set to crack when a fluid exceeds a configured temperature. The developer guide describes how to add the mod to a development environment.

The mod is released for Fabric, Forge, NeoForge and Quilt across 27 release versions, 1.18.2 – 26.3, and is open source under the MIT License. It is a client and server mod, so a server and every player must both run it. Fabric and Quilt builds require Cloth Config API and Fabric API.

Key features

  1. Fluid-agnostic buckets

    Buckets created with the library hold Water, Lava and modded fluids alike, without per-fluid code.

  2. Entity and block pickup

    Axolotls, fish, tadpoles, Powder Snow and other bucketable blocks or mobs from other mods can be collected in a bucket.

  3. Milk handling

    Cows and goats can be milked, and milk buckets interact with mods that provide a milk fluid.

  4. Dispense behaviour

    Buckets generated by the library dispense their contents out of the box, with no extra setup.

  5. Allow and deny lists

    Fluids, entities and blocks can be limited with allow lists and deny lists, or by fluid temperature.

  6. Temperature cracking

    A bucket can be configured to crack when the fluid it holds exceeds a set temperature.

Compatibility

Latest build for each game version and loader.

26.x5 of 5 versions with builds
26.326.3-5.3.0.1Not available26.3-5.3.0.126.3-5.3.0.1
26.226.2-5.2.0.2Not available26.2-5.2.0.226.2-5.2.0.2
26.1.226.1.2-5.1.0.1Not available26.1.2-5.1.0.126.1.2-5.1.0.1
26.1.126.1-5.0.4.1Not available26.1-5.0.4.126.1-5.0.4.1
26.126.1-5.0.4.1Not available26.1-5.0.4.126.1-5.0.4.1
1.21.x11 of 11 versions with builds
1.21.111.21.11-4.7.2.1Not available1.21.11-4.7.2.11.21.11-4.7.2.1
1.21.101.21.9-4.6.1.1Not available1.21.9-4.6.1.11.21.9-4.6.1.1
1.21.91.21.9-4.6.1.1Not available1.21.9-4.6.1.11.21.9-4.6.1.1
1.21.81.21.7-4.5.0.4Not available1.21.7-4.5.0.41.21.7-4.5.0.4
1.21.71.21.7-4.5.0.4Not available1.21.7-4.5.0.41.21.7-4.5.0.4
1.21.61.21.6-4.4.999.2Not available1.21.6-4.4.999.21.21.6-4.4.999.2
1.21.51.21.5-4.4.0.5Not available1.21.5-4.4.0.51.21.5-4.4.0.5
1.21.41.21.4-4.3.0.5Not available1.21.4-4.3.0.51.21.4-4.3.0.5
1.21.31.21.3-4.2.5.3Not available1.21.3-4.2.5.31.21.3-4.2.5.3
1.21.11.21-4.1.7.2Not available1.21-4.1.7.21.21-4.1.7.2
1.211.21-4.1.7.2Not available1.21-4.1.7.21.21-4.1.7.2
1.20.x5 of 5 versions with builds
1.19.x5 of 5 versions with builds
1.18.x1 of 1 version with builds
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 2

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required
Cloth Config APIConfiguration Library for Minecraft Mods
Required

Optional 2

Just Enough Items (JEI)View Items and Recipes
Optional
Mod MenuAdds a mod menu to view the list of mods you have installed.
Optional

Required by 8 mods

SimpleOres21.7.10 – 1.20.6Wooden Bucket1.18.2 – 26.3Ceramic Bucket1.14.4 – 26.3SimpleOres Recontinued1.19.4 – 26.3Machines1.7.10 – 1.20.6MoreBuckets1.19.2 – 1.20.4

Use cases

Custom bucket items

Mod developers can add their own buckets for new fluids without writing the special-case logic themselves.

Modpack restrictions

Pack makers can use the allow and deny lists to control which fluids and mobs players may bucket.

Who it’s for: Mod developers building bucket items, and modpack makers who want to limit which fluids, entities and blocks players can collect in buckets.

Questions

Does BucketLib need Fabric API?

Fabric and Quilt builds need Fabric API and Cloth Config API. Forge and NeoForge builds need only the libraries their own loader provides.

Do players need BucketLib installed?

Yes. The mod is client and server, so the server and every player must run it to use the buckets it generates.

Which mods depend on BucketLib?

Eight catalog mods require it, among them SimpleOres2, Wooden Bucket, Ceramic Bucket, SimpleOres Recontinued and Machines.

In the catalog

BucketLib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.

Library mods3,514Fabric modsMods for 26.38,071

More from cech12

All projects
Wooden Shears1.16.5 – 26.3ColorBlindness1.16.5 – 26.3Unlit Campfire1.15.2 – 26.3Wooden Bucket1.18.2 – 26.3Wooden Hopper1.15.2 – 26.3Useful Hats1.14.4 – 26.3

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3

What the author says

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 You need a server? Save 25% on…
cech12, on the Modrinth page

Official listing

Owner
cech12
Published
2022-12-05
Updated on Modrinth
2026-10-01
Facts verified
2026-10-15

Tags

Library
Open on ModrinthCompare