Introduction

Fully customizable infinite buckets for Paper, Spigot, and Folia 1.20.1+. Hand out water and lava buckets that never run out, limited-use buckets that count down, and sponges that drain lava or water around them, either from your hand or placed as a real block. Every bucket is defined in buckets.yml or built in-game, and every use respects your protection plugins.

What's in this guide

  • Getting Started: install the plugin and hand out your first bucket.
  • Core Reference: every command, permission node, and the in-game Bucket Builder.
  • Features & Modules: placing buckets, drain buckets and sponges, limited uses and cooldowns, hoppers and dispensers.
  • Configuration: buckets.yml with full examples, config.yml, messages, and the database.
  • Integrations: WorldGuard, Lands, SuperiorSkyblock2, BentoBox, and CoreProtect.
  • Advanced Optimization: drain performance, Folia, upgrading from older versions, and troubleshooting.
  • Support: FAQ and how to get help.

Key features

  • Placing buckets that never empty: water, lava, or powder snow, placed exactly like a vanilla bucket.
  • Drain buckets and sponges that clear a whole cube of liquid (radius 1 to 16) with one click, or go down as a block like a vanilla sponge and come back when mined.
  • Limited uses and cooldowns per bucket, with each item in a stack keeping its own uses.
  • In-game Bucket Builder to create and edit buckets without touching YAML.
  • Protection plugin support for WorldGuard (and WorldGuard-based claim plugins), Lands, SuperiorSkyblock2, and BentoBox.
  • CoreProtect logging, so /co rollback takes back bucket griefing.
  • Folia support through region-aware scheduling.

Quick links

Ready to go? Start with the Quick Start guide.