🧶 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

1. Download the plugin JAR
2. Place it into the plugins/ folder
3. Restart the server or run /reload
4. 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

1. Start with default settings (5/5/3)
2. Test on an arena
3. Get player feedback
4. Adjust for your server style
5. 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)

---