DecayingWool

# 🧶 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 ```yaml Fast-paced settings: - Phase 1: 3 seconds - Phase 2: 3 seconds - Phase 3: 2 seconds Total: 8 seconds ``` ### Sky Wars arena ```yaml Medium-paced: - Phase 1: 5 seconds - Phase 2: 5 seconds - Phase 3: 3 seconds Total: 13 seconds ``` ### Slow mode ```yaml 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 ```yaml 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**! ```yaml # Main setti