Cobwebs-Cleaner Plugin

Cobwebs-Cleaner is an essential utility plugin purpose-built for BoxPvP servers to manage arena clutter and ensure smooth gameplay. In intense BoxPvP combat, cobweb spam can quickly ruin the map and impact server performance. This plugin automatically sweeps and removes left-behind cobwebs with two dynamic cleaning modes to suit your server's needs, complete with an intuitive, in-game Graphical User Interface (GUI) for easy administration.

Features

• Automated Cleaning Loop: The core of the plugin runs a scheduled task that automatically sweeps for and removes cobwebs (Material.COBWEB) based on a customizable interval.
• Dual Cleaning Modes (The Compass Toggle):
  • Radius Mode (use-radius: true): The plugin scans a configurable radius (e.g., 20 blocks) around all currently online players. This is highly efficient and minimizes lag, as it only checks chunks where players are actively playing.
  • Clean All Mode (use-radius: false): The default setting. The plugin scans every loaded chunk within the enabled worlds. This ensures thorough cleaning but requires more server resources.
• Per-World Management: You can specify exactly which BoxPvP arenas or worlds the cleaner operates in. Worlds can be toggled on or off directly through the in-game GUI, syncing instantly with the configuration file.
• Interactive Admin GUI (/cc): A robust, anti-theft protected inventory menu that allows administrators to:
  • Adjust the timer interval (add/remove seconds).
  • Toggle between Radius and Clean All modes.
  • Adjust the radius distance.
  • Manage enabled worlds via a dedicated sub-menu.

• Live Configuration Sync: Changes made in the GUI instantly update the config.yml file and restart the internal timer, requiring no server reboots.
• Placement Protection: Players must have the cobwebscleaner.build permission to place new cobwebs. Without it, the placement event is cancelled, preventing players from cluttering the map.
• PlaceholderAPI Integration: Exposes the %cobwebscleaner_timer% placeholder, allowing you to display the exact time remaining until the next sweep on scoreboards or holograms.
• In-Game Reload Command: Use /cc reload to manually refresh the plugin if you edit the config.yml file directly.

Commands & Permissions

• Command: /cobwebscleaner (Aliases: /cc, /cobwebs)
  • Description: Opens the main configuration GUI.
  • Permission: cobwebscleaner.admin (Default: OP)
• Command: /cc reload
  • Description: Reloads the configuration from the config.yml file.
  • Permission: cobwebscleaner.admin
• Action: Placing a Cobweb
  • Action: Placing a Cobweb

Configuration (config.yml)

The plugin generates a configuration file automatically.

# How often the cleaner sweeps for cobwebs (in seconds)
interval-seconds: 60

# The radius around the player to check for cobwebs (in blocks). Only used if use-radius is true.
clean-radius: 20

# Mode Toggle: 
# true = Only clean around online players (Radius Mode)
# false = Clean all loaded chunks in enabled worlds
use-radius: false

# List of worlds where the cobweb cleaner is active
enabled-worlds:
  - world

Preview