> For the complete documentation index, see [llms.txt](https://docs.vexalstudios.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vexalstudios.com/minecraft-plugins/vexal-infinite-bucket-free.md).

# Vexal Infinite Bucket - Free

An advanced Minecraft plugin that enhances the vanilla bucket experience by introducing **infinite** and **multi-capacity** fluid storage. Players can toggle between infinite mode or store multiple buckets of the same fluid type — making it perfect for builders, redstone engineers, and survival players alike.

***

### 🪣 Features

* 🧊 **Infinite Mode:** Use water or lava endlessly without refilling.
* 🧺 **Storage Mode:** Store multiple buckets of the same fluid type in one item.
* 🔥 **Supports All Fluids:** Works with both water and lava.
* 🧩 **Highly Configurable:** Customize bucket limits, permissions, and behaviors.
* ⚙️ **Seamless Integration:** Works with any Bukkit/Spigot/Paper server.

***

### 🧱 Requirements

* **Minecraft:** 1.20+ (compatible with most modern Paper/Spigot builds)
* **Server Software:** PaperMC or compatible
* **Java:** 17 or higher

***

### ⚙️ Installation

1. Download the latest `VexalInfiniteBucket.jar` from the Releases page.
2. Place the `.jar` file into your server’s `/plugins/` directory.
3. Restart your server.
4. Modify the configuration file (`/plugins/VexalInfiniteBucket/config.yml`) as desired.

***

### 💬 Commands

| Command                        | Description                                  |
| ------------------------------ | -------------------------------------------- |
| `/bucket give <player> <type>` | Gives a Vexal Infinite Bucket to the player. |
| `/bucket reload`               | Reloads the plugin configuration.            |

***

### 🔒 Permissions

| Permission Node              | Description                                 |
| ---------------------------- | ------------------------------------------- |
| `vexalinfinitebucket.use`    | Allows usage of the Infinite Bucket.        |
| `vexalinfinitebucket.give`   | Allows giving Infinite Buckets via command. |
| `vexalinfinitebucket.reload` | Allows reloading the plugin.                |

***

### 🧾 Configuration Example

```
# Vexal Infinite Bucket Configuration
settings:
  default-mode: storage
  max-storage: 16  # Number of fluid units stored in storage mode
  allow-infinite: true
  messages:
    switched-mode: "&aYou switched your bucket to &e%mode% &amode!"
    not-allowed: "&cYou don't have permission to use this bucket."
```

***

### 🪄 Usage

1. Obtain a Vexal Infinite Bucket using `/infinitebucket give`.
2. Right-click while sneaking to toggle between **Infinite** and **Storage** modes.
3. In storage mode, collect or place fluids — the bucket tracks how much it holds.
4. In infinite mode, the bucket never runs out.