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
• GriefPrevention
• Towny
• Lands
• PlotSquared
• Residence
• SuperiorSkyblock2

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