WorldGuard

WorldGuard is the standard region-protection plugin for Bukkit servers. EzClean registers a custom region flag that lets you mark areas where entity cleanup should never run.

Requirements

  • WorldGuard 7.0.9 or later
  • WorldEdit (required by WorldGuard)

The ezclean-bypass flag

EzClean registers a custom StateFlag named ezclean-bypass during the plugin load phase (before onEnable), so it is always available in WorldGuard’s flag registry by the time worlds load.

When the flag is set to ALLOW on a region, every entity inside that region is skipped by all EzClean cleaner profiles during every cleanup run. The flag defaults to DENY (i.e. cleanup proceeds normally).

Setting the flag

Select a region with WorldEdit and run:

/rg flag <region-name> ezclean-bypass allow

To remove the bypass and restore normal cleanup behaviour:

/rg flag <region-name> ezclean-bypass deny

You can also set the flag in regions.yml directly or via a WorldGuard GUI plugin if you prefer a graphical interface.

The bypass flag is evaluated per-entity based on the entity’s current location. It respects region priority and inheritance, so child regions inherit the flag from parent regions unless explicitly overridden.

Configuration

No EzClean configuration is required — the integration activates automatically when WorldGuard is present. You can see per-world region skipping in the server log at the FINE logging level.