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.

📦 Preset Buckets

The plugin comes with several presets that you can enable or disable:

• water_bucket: Standard infinite water.
• lava_bucket: Standard infinite lava.
• empty_sponge_bucket: Infinite sponge that drains water in a radius.

🛠 Custom Buckets

You can create custom buckets under the customBuckets section.

Basic Fields

Field	Description
id	Unique identifier for the bucket.
displayName	Name of the item (supports MiniMessage).
lore	List of lore lines (supports MiniMessage).
icon	Material of the item.
mode	vanilla_like or drain_area.
enabled	Whether the bucket is active.

Modes

1. vanilla_like

Functions like a normal bucket but never runs out (or has limited uses).

• fluids: Array of fluid IDs it can handle (e.g., ["minecraft:water"]).
• fluidTags: Array of fluid tags it accepts (e.g., ["#minecraft:fluids"]).
• capacity: How many units it can hold.
• uses: (Optional) Total uses before the bucket is empty.

2. drain_area

Drains fluids in a radius around the user.

• behavior.radius: Radius of the drain area.
• behavior.maxBlocksPerUse: Limit on blocks drained per use.
• behavior.cooldown: Ticks between uses.
• behavior.waterlogged: Whether to remove waterlogging.
• behavior.fluids: Specific fluids to drain.

📝 Example: Limited Water Bucket

customBuckets:
  - id: "limited_water_bucket"
    displayName: "<aqua>Limited Water Bucket</aqua>"
    lore:
      - "<!i><blue>• Has a limited number of uses</blue>"
      - "<!i><gray>• Uses Remaining: <uses></gray>"
    icon: "minecraft:water_bucket"
    mode: "vanilla_like"
    fluids: [ "minecraft:water" ]
    uses: 5
    enabled: true

🔒 Permissions & Crafting

Each bucket can have its own permissions:

permissions:
  use: "infb.use.mybucket"
  craft: "infb.craft.mybucket"
crafting:
  enabled: true
  recipe: "my_recipe_id"