Main Configuration

The config.yml file contains the general settings for the plugin.

🛠 General Settings

Setting Description Default
debug-mode Enables detailed diagnostic messages in the console. false
global-cooldown Global cooldown between bucket uses (in ms). 0

🚀 Performance & Safety

These settings control the behavior of drain-area buckets and help prevent server lag.

Setting Description Default
performance.max-drain-blocks Max blocks affected by drain buckets per use. 100
performance.async-processing Enable async processing for block updates. true

🛡 Integrations

InfiniteBuckets can automatically detect and hook into protection plugins.

Setting Description Default
integrations.auto-detect-hooks Automatically detect protection plugins. true
integrations.hooks.worldguard Explicitly enable/disable WorldGuard hook. true
integrations.hooks.lands Explicitly enable/disable Lands hook. true
integrations.hooks.superiorskyblock Explicitly enable/disable SuperiorSkyblock hook. true
integrations.hooks.bentobox Explicitly enable/disable BentoBox hook. true

🌍 World Restrictions

Control where infinite buckets can be used.

Setting Description Default
world-settings.disabled-worlds List of worlds where buckets are disabled. []
world-settings.default-nether-restriction Default restriction for water in the nether. true

World Rules Example

You can define special rules for specific worlds:

world-settings:
  world-rules:
    world_nether:
      allow-water: false
      allow-lava: true