🪣 Vexal Infinite Bucket

An advanced Minecraft plugin that enhances the vanilla bucket experience by introducing infinite and multi-capacity fluid storage.
Perfect for builders, redstone engineers, and survival players who want to handle water and lava efficiently — without sacrificing performance or stability.

Showcase Video

✨ Features

• ♾️ Infinite Mode – Use water or lava endlessly without refilling.
• 🧺 Storage Mode – Store multiple buckets of the same fluid in one item.
• 🔁 Mode Switching – Toggle between Infinite and Storage modes by sneaking and right-clicking.
• 🔥 Supports All Fluids – Works with both water and lava.
• ⚙️ Fully Configurable – Customize capacity limits, messages, and behavior via config.yml.
• 🧩 Paper / Spigot Compatible – Works seamlessly with modern server software.
• 💾 Lightweight – Designed for production servers; zero lag and minimal overhead.

🧱 Requirements

• Minecraft: 1.20+
• Server Software: Paper, Purpur, or Spigot
• Java: 17 or newer

⚙️ Installation

1. Download the latest version of VexalInfiniteBucket.jar.
2. Drop it into your server’s /plugins/ directory.
3. Start or restart the server.
4. Edit /plugins/VexalInfiniteBucket/config.yml to customize settings.
5. Run /bucket reload to apply configuration changes.

💬 Commands & Permissions

| Command | Description | Permission | Default | |
| ----------------------- | ------------------------------------------ | ---------------------------------------- | ------------------------- | ---- |
| /bucket give <player> | Gives a Vexal Infinite Bucket to a player. | vexalinfinitebucket.give | OP | |
| /bucket mode <infinite/storage> | Toggles or sets the current bucket mode. | vexalinfinitebucket.use | TRUE |
| /bucket reload | Reloads the plugin configuration. | vexalinfinitebucket.reload | OP | |

🧾 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 bucket with /bucket give.
2. Sneak + Right-click to toggle between Infinite and Storage modes.
3. In Storage Mode, collect and place fluids — the bucket tracks how much it holds.
4. In Infinite Mode, it never runs out.

💬 Support

Need help or found a bug?
Join our Discord community for fast support and updates.

🧩 Compatibility

✅ Paper / Spigot / Purpur
✅ Works with protection plugins like WorldGuard & GriefPrevention
✅ Compatible with Minecraft 1.20–latest

🏷️ Tags

bukkit · paper · utility · survival · fluids · infinite · minecraft-plugin