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
update-checker.enabled	Enable/disable automatic update checks.	true
update-checker.notify-admins	Notify admins on join when an update is available.	true
update-checker.check-interval	Interval between update checks in hours.	24
messages.only-update-messages	If true, only update notifications will be shown.	false

🚀 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.	1000
performance.global-cooldown	Cooldown between bucket uses in ticks.	5
performance.async-processing	Enable async processing for large operations.	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.	["test"]
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:
    nether:
      allow-water-buckets: false
      allow-lava-buckets: true