🧶 DecayingWool - Timed Wool Decay System

Add dynamic gameplay to BedWars! Wool gradually disappears through 3 phases with full GUI customization.

📖 Description

DecayingWool is a lightweight and optimized plugin for Minecraft 1.8.8 that adds a gradual wool decay system. Perfect for BedWars, Sky Wars, and other PvP modes where dynamic building mechanics matter.

✨ Why is this useful?

🎯 Adds strategy — players can’t just build a bridge and forget about it
⚡ Speeds up gameplay — fewer “turtle” tactics
🔥 Increases dynamics — constant movement and tension
🎮 Balances the game — defenses require continuous maintenance

🎯 How it works

3-Phase Decay System

When a player places wool, it goes through 3 phases before disappearing:

┌─────────────────────────────────────┐
│ Phase 1: Team color (5 sec)         │
│ 🟧 Orange wool                       │
├─────────────────────────────────────┤
│ Phase 2: Gray wool (5 sec)          │
│ ⬜ Warning: almost decayed           │
├─────────────────────────────────────┤
│ Phase 3: Black wool (3 sec)         │
│ ⬛ Final warning                     │
├─────────────────────────────────────┤
│ Disappearance (animation + sound)   │
│ 💨 Block is fully removed            │
└─────────────────────────────────────┘

Total duration: 13 seconds (customizable!)

🎨 Visual Effects

Particles on each phase change (smoke, sparks, etc.)
Sounds on color change and disappearance
Break animation on final decay
Everything is configurable!

🎮 Key Features

⚙️ Fully Customizable Phases

⏱️ Set any duration for each phase (1–60 seconds)
🎨 Adjust visual effects (particles, sounds)
🌍 Choose which worlds the system works in
🔧 All via a beautiful GUI menu — no files required!

🖱️ Intuitive GUI Controls

Main Menu (/decay):

🟢 Enable/Disable the system
⚙️ Edit phase durations
🌍 World whitelist/blacklist management
🎨 Particles & sounds configuration
📊 Real-time statistics
💾 Auto-save for all settings

⏱️ Phase Editing via GUI

Easy time control:

Left click — +1 second
Right click — -1 second
Shift + Left click — +5 seconds
Shift + Right click — -5 seconds
Middle click — reset to default

Changes auto-save and apply immediately!

🌍 World Management

Two operation modes:

Whitelist:

Plugin works only in selected worlds
Ideal for dedicated BedWars arenas

Blacklist:

Plugin works everywhere except listed worlds
Perfect for main peaceful worlds

Simple toggling:

All server worlds displayed in one GUI
Click to add/remove
Mode switches in one click

📊 Real-Time Statistics

📦 Active blocks — currently decaying wool
✅ Total processed — how many blocks passed through the system
❌ Removed blocks — total disappeared
🌍 Per-world breakdown
⚡ Performance impact — TPS load

🎨 Effects Customization

Particles:

Type selection (smoke, sparks, flame, etc.)
Particle amount
Enable/disable

Sounds:

On phase change
On disappearance
Adjustable volume & pitch
Preview in GUI

🎯 Example Use Cases

BedWars server

Fast-paced settings:
- Phase 1: 3 seconds
- Phase 2: 3 seconds  
- Phase 3: 2 seconds
Total: 8 seconds

Sky Wars arena

Medium-paced:
- Phase 1: 5 seconds
- Phase 2: 5 seconds
- Phase 3: 3 seconds
Total: 13 seconds

Slow mode

Beginner-friendly:
- Phase 1: 10 seconds
- Phase 2: 10 seconds
- Phase 3: 5 seconds
Total: 25 seconds

🚀 Installation

Download the plugin JAR
Place it into the plugins/ folder
Restart the server or run /reload
Done! Configure via /decay

Requirements

☕ Java: 8
🎮 Minecraft: 1.8.x
🔌 Platform: Spigot / Paper / Bukkit
💾 RAM usage: ~2–5 MB (very lightweight!)

💻 Commands & Permissions

Commands

Command	Description	Aliases
`/decay`	Open main settings menu	`/dw`, `/dwool`
`/decay menu`	Open main menu	-
`/decay reload`	Reload configuration	-
`/decay toggle`	Enable/disable system	-
`/decay stats`	Open statistics menu	-
`/decay cleanup`	Clear all decaying blocks	-

Permissions

decayingwool.*              # All permissions
  └─ decayingwool.admin     # Full access to commands & GUI
  └─ decayingwool.bypass    # Player’s wool does NOT decay*

⚠️ Note: bypass only works for non-OP players. OP players always follow decay rules.

⚙️ Configuration

config.yml

The plugin auto-generates config files, but GUI editing is recommended!

# Main settings
plugin:
  enabled: true
  debug: false

# Decay settings
decay:
  enabled: true
  phase1-duration: 5
  phase2-duration: 5
  phase3-duration: 3
  
  world-mode: "whitelist"
  enabled-worlds:
    - world_bedwars
    - bw_arena1
  
  effects:
    particles:
      enabled: true
      type: "SMOKE_NORMAL"
      amount: 5
    sound:
      enabled: true
      phase-change: "BLOCK_WOOL_BREAK"
      disappear: "BLOCK_WOOL_BREAK"
      volume: 0.5
      pitch: 1.0
  
  drops:
    drop-items: false
    drop-on-break: true

# Performance
performance:
  max-blocks-per-tick: 50
  cleanup-interval: 200
  async-processing: true

🎯 Server-Oriented Features

⚡ Performance Optimizations

Asynchronous processing — no TPS drops
Blocks-per-tick cap — prevents lag
Auto cleanup of inactive blocks
Low memory usage (2–5 MB)
Thread-safe operations

🔒 Safety

Permission checks
Config validation
No duplication exploits
Compatible with other plugins

🌐 Compatibility

Tested with:

BedWars1058
BedWarsProxy
Multiverse-Core
WorldGuard
GriefPrevention
EssentialsX

📊 Technical Details

Architecture

DecayingWool
├── Managers
│   ├── DecayManager
│   ├── GUIManager
│   ├── WorldManager
│   └── ConfigManager
├── GUI Menus
│   ├── MainMenu
│   ├── PhaseSettingsMenu
│   ├── WorldManagement
│   ├── EffectsMenu
│   └── StatisticsMenu
├── Listeners
│   ├── BlockPlace
│   ├── BlockBreak
│   ├── InventoryClick
│   └── ChunkListener
└── Models
    └── DecayingBlock

Data Handling

ConcurrentHashMap for safe async access
Periodic cleanup
Chunk unload handling

🎮 Usage Tips

For admins

Start with default settings (5/5/3)
Test on an arena
Get player feedback
Adjust for your server style
Use statistics menu

For players

🟧 Colored wool — just placed
⬜ Gray wool — decaying soon
⬛ Black wool — final warning
💨 Gone — place more

Recommended settings

Fast-paced (solo): 2 / 2 / 1 (5 sec) Standard (2–4 players): 5 / 5 / 3 (13 sec) Slow mode: 10 / 10 / 5 (25 sec)

🐛 Known limitations

Only works with wool (Material.WOOL in 1.8.8)
More blocks can be added via affected-wool
Timers reset on server restart (normal behavior)

DecayingWool