BucketLib

BucketLib is a library mod for Minecraft developers, compatible with Forge, NeoForge, Fabric, and Quilt. Its main purpose is to simplify the process of creating custom buckets, freeing developers from having to implement all possible usage scenarios themselves.

Feature Set

The library provides full compatibility with all types of fluids—both standard (water, lava) and those added by other mods. Buckets created using BucketLib can collect not only liquids but also various entities, including axolotls, fish, tadpoles, and mobs from other mods. The system also supports collecting blocks such as powder snow and similar objects from third-party modifications.

Special attention is given to milk handling: the system correctly processes milking cows and goats, ensures milk's drinkable properties, and maintains compatibility with mods that add milk as a fluid. All created buckets automatically receive proper behavior when used with dispensers and are compatible with fluid management systems from other mods.

Flexible Configuration

The library offers advanced configuration options: you can restrict the collection of fluids, entities, and blocks using allow lists and deny lists or based on fluid temperature. Options include setting buckets to break when fluid temperature exceeds critical values, defining burning and freezing effects for different temperature regimes, as well as enabling bucket coloring and disabling the milking function.

Compatibility and Requirements

For Fabric and Quilt versions, the following dependencies are required: Fabric API and Cloth Config API. Developers can find detailed integration guidance in the project's official documentation.

Frequently Asked Questions

Can I use this mod in my own projects or modpacks? Yes, usage in personal mods and modpacks is permitted.

Are older Minecraft versions supported? The developer does not plan to port the mod to earlier game versions. Only current and planned releases are supported.

Is there a Fabric version available? Starting from version 1.20.4, the mod is available for Fabric and Quilt. Earlier Minecraft versions do not support Fabric.

Where is the configuration file located? The configuration file is located in the defaultconfig directory. Changes to it only affect new save files. For existing worlds, you need to edit the file in the serverconfig folder of the respective save.

How to report a bug or suggest an improvement? Bug reports and suggestions are accepted through the Issues system on GitHub or via Discord.