Decay Zone

Overview

DecayZone is a plugin that allows administrators to define specific zones where placed blocks will automatically decay over time. This is useful for preventing clutter, managing building areas, or creating dynamic environments where structures don't last forever.

Real-World Use Cases

• Minigames: Automatically clean up blocks placed by players during a match without needing full arena resets.
• Temporary Build Zones: Allow players to place blocks to reach certain areas, knowing they will decay after a set amount of time.

Key Features

• Configurable Decay: Set the default decay duration for newly created zones.
• Exemptions: Exempt specific block types from decaying.
• Visual Feedback: Use particles, titles, and sounds for zone entry and visualization.

Step-by-Step Setup Guide

Follow these steps to set up your first decay zone.

Step 1: Installation

1. Download the DecayZone.jar and place it in your /plugins folder.
2. Restart your server.

Step 2: Creating a Zone

1. Use /decay setpos1 and /decay setpos2 to select the two corners of the zone.
2. Use /decay create <name> to create the zone.
3. Any non-exempt blocks placed inside the zone will now decay over time.

Mechanics

Block Decay

When a player places a block inside a configured decay zone, the plugin will schedule the block to be removed after the zone's decay duration. Exempt blocks, such as Bedrock or Glass, will not decay.

Commands

All commands require the appropriate management permissions.

Permissions

Configuration

Here is the configuration file for configuring the global defaults.

# Decay Zone Configuration

# Default decay duration in seconds for newly created zones
default-decay-duration: 5

# Global decay toggle (can be overridden per-zone)
global-decay-enabled: true

# Default blocks that are exempt from decay across all zones
# (individual zones can have additional exemptions)
default-exempt-blocks:
  - BEDROCK
  - BARRIER
  - AIR
  - CAVE_AIR
  - VOID_AIR
  - GLASS
  - WHITE_STAINED_GLASS
  - ORANGE_STAINED_GLASS
  - MAGENTA_STAINED_GLASS
  - LIGHT_BLUE_STAINED_GLASS
  - YELLOW_STAINED_GLASS
  - LIME_STAINED_GLASS
  - PINK_STAINED_GLASS
  - GRAY_STAINED_GLASS
  - LIGHT_GRAY_STAINED_GLASS
  - CYAN_STAINED_GLASS
  - PURPLE_STAINED_GLASS
  - BLUE_STAINED_GLASS
  - BROWN_STAINED_GLASS
  - GREEN_STAINED_GLASS
  - RED_STAINED_GLASS
  - BLACK_STAINED_GLASS
  - TINTED_GLASS
  - GLASS_PANE
  - WHITE_STAINED_GLASS_PANE
  - ORANGE_STAINED_GLASS_PANE
  - MAGENTA_STAINED_GLASS_PANE
  - LIGHT_BLUE_STAINED_GLASS_PANE
  - YELLOW_STAINED_GLASS_PANE
  - LIME_STAINED_GLASS_PANE
  - PINK_STAINED_GLASS_PANE
  - GRAY_STAINED_GLASS_PANE
  - LIGHT_GRAY_STAINED_GLASS_PANE
  - CYAN_STAINED_GLASS_PANE
  - PURPLE_STAINED_GLASS_PANE
  - BLUE_STAINED_GLASS_PANE
  - BROWN_STAINED_GLASS_PANE
  - GREEN_STAINED_GLASS_PANE
  - RED_STAINED_GLASS_PANE
  - BLACK_STAINED_GLASS_PANE

# Particle settings for selection visualization
particle:
  # Particle type (DUST particles with custom color)
  enabled: true
  # Display duration in ticks (100 ticks = 5 seconds)
  duration-ticks: 100
  # Particle density (particles per block edge)
  density: 2

# Zone entry/exit feedback
zone-feedback:
  # Play sounds on zone entry/exit
  sounds-enabled: true
  # Show titles on zone entry/exit
  titles-enabled: true
  # Title display duration (in milliseconds)
  title-fade-in: 500
  title-stay: 2500
  title-fade-out: 500

Troubleshooting

Common Issues

• Blocks aren't decaying!

  Ensure the block isn't on the exempt list, and verify that the zone's decay is enabled.