InfiniteBuckets

To view the full changelog please check out [InfBuckets Changelog](https://busybeedev.net/changelog?project=infinitebuckets)

Advanced Performance Monitoring

Enhanced FastStats Support: Fully updated the internal metrics system to utilize the FastStats framework alongside BStats* for real-time performance analytics. Dedicated Analytics Managers:* Added BStatsManager and FastStatsManager to handle background performance tracking seamlessly. Secure Management:* Integrated configurable properties for plugin ID and token management, allowing safe and customizable connection tracking.

Warning: The inf Sponge bucket was removed in this version. It will be added in the next version. Also, please remember to back up any configs you have. The idea for this plugin was to be a simple inf water and lava plugin. Its going back to its roots. To view the full changelog please click the link or head to [InfiniteBuckets Changelog](https://busybeedev.net/changelog?project=infinitebuckets)

Changes & Improvements

Minecraft 1.21 Support

The plugin has been officially updated to support Minecraft 1.21! Enjoy all the latest block updates and features with full compatibility.

Exploits & Interaction Fixes

Duplication & Ghost Fluid Fix:* Fixed a critical bug where PlayerBucketFillEvent and PlayerBucketEmptyEvent weren't being properly cancelled. Infinite buckets will now behave exactly as intended without causing vanilla fluid glitches. Permissions & Messages Overhaul:* Revised and streamlined permission nodes and in-game messages for a cleaner, more modern experience. Under-the-Hood Cleanup:* Stripped out a ton of legacy code, unused configuration updaters, and old registry logic to make the plugin lighter and faster. ---

Developer & Internal Notes

* Updated LandsAPI dependency group and version in pom.xml. * Updated the [Wiki](https://busybeedev.net/docs/infinitebuckets/introduction)

Update 2026.1.3.1

Bug Fixes

Fluid Placement:* Prevented fluids from being placed in mid-air to ensure more realistic behavior and prevent griefing/accidental spills. Permission Logic: Improved protection integration with BentoBox. * The system now prioritizes the BUCKET flag for permission checks. * Added a fallback to the PLACE_BLOCKS flag when the specific bucket flag is unavailable.

Internal Changes

Dependency Management:* Corrected an inconsistency in the pom.xml where the version was incorrectly set to 2026.1.1.3. Version Bump: Project version officially updated to 2026.1.3.1*.

v3.0 - BentoBox Support & Enhanced Restrictions

This major update introduces support for BentoBox island protection, adds finer control over bucket usage per world, and cleans up the codebase by removing deprecated dependencies.

New Features

BentoBox Hook:* Added a new hook for BentoBox to support island protection checks. World-Specific Restrictions:* You can now apply bucket restrictions to specific worlds rather than globally. Nether Support Toggle:* Added a configuration toggle to explicitly enable or disable support for the Nether.

Changes & Improvements

Dependency Cleanup:* Removed deprecated plugin dependencies to streamline the plugin and improve performance. Code Cleanup:* Removed unused comments and legacy code.

Configuration Updates

Updated Defaults:* The config.yml has been updated with new default values and message strings. Note: It is recommended to back up your old config.yml and let a new one generate to see the latest changes.*

v2.9 Changelog

Breaking Changes & Removals

Removed Legacy Protection Hooks:* We have removed support for several deprecated or legacy protection plugins to streamline the codebase. The following are no longer supported: * Towny * GriefPrevention * PlotSquared * Residence

Bug Fixes & Improvements

Cross-Version Enchantments:* Fixed issues with adding enchantments to items. This logic now handles cross-version compatibility much more gracefully. Lore Updates:* Improved the logic behind how item lore is updated, ensuring display consistency.

Internal & Technical

Build Target: Downgraded the internal `api-version` to 1.20* to ensure broader compatibility. Code Cleanup:* Streamlined the HookManager logic and removed unused comments/code for better maintainability.

Changelog: - Fixed not loading in 1.20 Note: If you are using 1.21+ you dont need to update with this. This only targeted 1.20 versions.

- World Guard fixes - Minor Bug Fixes

WARNING: You will need to reset your plugin folder for these changes to take effect. I would make a backup of them first so you can copy and paste sections back into the updated config. This would be your Bucket.yml Updates: - Added limited custom buckets - Updated depends - Code clean up

- Added Folia Support for 1.21+ - Added the ability to use inf buckets inside dispensers - Reduced Jar file size - Optimized performance Devs Note: - Big thank you to [R00tB33rMan](https://github.com/R00tB33rMan) for help with this update and with Folia. - You do not need to delete your directory folder, just replace the jar. https://www.youtube-nocookie.com/embed/DARMgNeGLOY

Fixed

- Prevented duplication exploits by blocking Infinite Buckets from being moved to the off-hand.

Improved

- Adjusted lore formatting for better consistency and readability.

Added

- The ability to turn off chat messages from spamming chat. Check config.yml

- Config moved to buckets.yml with presets + custom buckets - New modes: VANILLA_LIKE, DRAIN_AREA, EFFECT (milk: CLEAR_EFFECTS) - New per-bucket permissions for use/craft, crafting toggles - Safer, capped area draining with waterlogged support - New messages, update checker, performance and integrations settings

- Fixed the ability to place water and or lava inside a cauldron

Updated Version: Update message to fully work with the Modrinth API, so the correct version is displayed if a new update is available.

InfiniteBuckets - Beta Testing Guide

Hello Testers, Thank you so much for helping test the new version of InfiniteBuckets! Your feedback is essential for finding bugs, checking compatibility, and ensuring the plugin is stable and user-friendly before its public release. The goal of this plugin is to provide a highly customizable, modern, and reliable infinite bucket experience. This beta test, starting around August 3rd, 2025, is focused on verifying the core features and the new land protection integrations. Prerequisites & Setup 1. Server Software: Please use a modern server version. Paper or Folia 1.21.x is recommended. 2. Your Plugin: You will need the latest InfiniteBuckets.jar file. 3. Protection Plugins (Optional but Important!): A major part of this test is compatibility. If you use any of the following plugins on your server, please install them for testing: - [WorldGuard](https://modrinth.com/plugin/worldguard/versions) - [GriefPrevention](https://www.spigotmc.org/resources/griefprevention.1884/) - [Towny](https://www.spigotmc.org/resources/towny-advanced.72694/) - [Lands](https://www.spigotmc.org/resources/lands-⭕-land-claim-plu… - [PlotSquared](https://www.spigotmc.org/resources/plotsquared-v7.77506/) - [Residence](https://www.spigotmc.org/resources/residence-1-7-10-up-to… - [SuperiorSkyblock2](https://bg-software.com/superiorskyblock/) 4. Permissions: You will need to be an operator (OP) on your test server to use admin commands and set up different test scenarios. Test Plan: What to Focus On Please follow these steps to test the plugin's features.

Part 1: Basic Bucket Functionality

This tests the absolute core of the plugin. 1. Give yourself the default water and lava buckets: - /infb give <YourName> water - /infb give <YourName> lava 2. Go to an unprotected area ("wilderness"). 3. Try to place water and lava. Try to "waterlog" blocks like stairs and slabs. Expected Result: The liquid should be placed correctly, and the bucket should remain in your inventory. Part 2: Admin Commands 1. `/infb give`: - Test giving buckets to yourself and another (or offline) player. - Test giving a specific amount: /infb give <YourName> water 10 - Test the command's tab-completion. It should suggest player names and bucket IDs (water, lava). 2. `/infb reload`: - Open config.yml and change the display-name of the water bucket. - In-game, run /infb reload. - Give yourself a new water bucket. Does it have the new name you set? Expected Result: All commands should work as described and provide feedback messages. The reload command should apply configuration changes without a full server restart. Part 3: Custom Bucket Creation This tests the plugin's flexibility. 1. Shut down your server. Open config.yml. 2. Under the buckets: section, add a completely new bucket type. For example:

    powdered_snow:
      material: "POWDER_SNOW_BUCKET"
      display-name: "<#a7d8de>Infinite Powdered Snow</#a7d8de>"
      lore:
        - "<gray>An endless supply of chilly, fluffy snow.</gray>"
      permission: "infb.use.snow"
      works-in-nether: true
    

3. Start your server. Check the console for any errors. 4. Give yourself the new bucket: /infb give <YourName> powdered_snow Expected Result: The plugin should load your new bucket without errors. The item in your inventory should have the correct name and lore, and using it should place powdered snow. Part 4: Land Protection Hooks (CRITICAL TEST) This is the most important part of the test. Please test with any of the protection plugins listed in the setup that you are familiar with. For each protection plugin you test, follow these steps: 1. Install ONE protection plugin (e.g., WorldGuard). Restart the server and check that InfiniteBuckets says Hooked into WorldGuard. in the console. 2. As PlayerA, create a protected region/claim/plot/island. 3. Log in with a separate account as PlayerB. 4. As PlayerB, try to use an infinite bucket inside PlayerA's claim. - Expected Result: The action should be BLOCKED, and you should receive the "You do not have permission to build here" message. 5. As PlayerA, try to use an infinite bucket inside your own claim. - Expected Result: The action should SUCCEED. Part 5: Nether Behavior 1. The default water bucket in config.yml is set to works-in-nether: false. 2. Go to the Nether. 3. Try to use the infinite water bucket. Expected Result: The action should be blocked, and you should see the "This bucket is disabled in the Nether" message. The lava bucket should work fine. How to Report a Bug If you find a bug, a crash, or something that doesn't work as expected, please provide a report with as much detail as possible. A great bug report includes: 1. A Clear Summary: (e.g., "Server crashes when placing lava in a Towny plot.") 2. Steps to Reproduce: (e.g., 1. Created a Towny plot. 2. Gave myself an infinite lava bucket. 3. Right-clicked inside the plot...) 3. Expected vs. Actual Result: (e.g., "I expected lava to be placed, but the server crashed instead.") 4. Logs & Errors: Please copy any errors from your server console and paste them on a site like [Pastebin](https://pastebin.com/), then share the link. 5. Plugin List: Please list the protection plugins and their versions that you had installed during the test. Thank you again for your time and effort! Your contribution is incredibly valuable.

- Updated to MC version 1.21.7

Error in 1.4.6 - Made an option to turn on or off Inf Water buckets to work in the nether. - Notice: By default, it is set to false; you will need to delete the config for Inf Buckets before restarting your server for the new config to load

- Fixed permissions. players and or ranks will need infb.use to use both lava and water or infb.use.water / infb.use.lava to use individual buckets. - OPs will be granted permission by default - Removed players granted permission by default

- Added Folia Support - Updated logger for updates - Fixed the issue with fast placing buckets and buckets breaking