# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vexalstudios.com/minecraft-plugins/vexal-infinite-bucket-free.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.