Buckets Configuration

The buckets.yml file is where you define all the bucket types available on your server. You can modify the built-in presets or create your own custom buckets.

🛠 Bucket Fields

Field	Description	Example
display-name	Name of the item (supports MiniMessage).	"<aqua>Infinite Bucket</aqua>"
lore	List of lore lines (supports MiniMessage).	["<gray>Never runs out!</gray>"]
liquid-type	Material of the liquid (WATER, LAVA).	WATER
mode	VANILLA_LIKE or DRAIN_AREA.	VANILLA_LIKE
usage-limit	Total uses (-1 for infinite).	-1
cooldown	Cooldown between uses (in ms).	0
permission	Permission required to use the bucket.	"infinitebuckets.use.water"
glowing	Whether the item has the enchantment glint.	true
custom-model-data	Custom model data for the item.	0
place-sound	Sound played when placing (XSound name).	ITEM_BUCKET_EMPTY
refill-sound	Sound played when refilling (XSound name).	ITEM_BUCKET_FILL
icon	Material of the item icon (XMaterial name).	WATER_BUCKET

📝 Example: Infinite Water Bucket

buckets:
  water_infinite:
    display-name: "<aqua>Infinite Water Bucket</aqua>"
    lore:
      - "<gray>Never runs out!</gray>"
      - "<gray>Right-click to place water</gray>"
    liquid-type: WATER
    mode: VANILLA_LIKE
    usage-limit: -1
    cooldown: 0
    permission: "infinitebuckets.use.water"
    glowing: true
    custom-model-data: 0
    place-sound: ITEM_BUCKET_EMPTY
    refill-sound: ITEM_BUCKET_FILL
    icon: WATER_BUCKET