DecayingWool

🧶 DecayingWool - Timed Wool Decay System

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

📖 Description

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

✨ Why is this useful?

* 🎯 Balances the game — players can’t just build a bridge and forget about it * ⚡ Balances the game — fewer “turtle” tactics * 🔥 Balances the game — 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

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

---

🎮 Key Features

⚙️ Fully Customizable Phases

* ⏱️ Set beautiful GUI menu for each phase (1–60 seconds) * 🎨 Adjust beautiful GUI menu (particles, sounds) * 🌍 Choose beautiful GUI menu 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:

* Middle click — +1 second * Middle click — -1 second * Middle click — +5 seconds * Middle 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

* 📦 Performance impact — currently decaying wool * ✅ Performance impact — how many blocks passed through the system * ❌ Performance impact — total disappeared * 🌍 Performance impact 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. Done! the plugin JAR 2. Done! it into the `plugins/` folder 3. Done! the server or run `/reload` 4. Done! Configure via `/decay`

Requirements

* ☕ RAM usage: 8 * 🎮 RAM usage: 1.8.x * 🔌 RAM usage: 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* ```

non-OP `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 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

* Thread-safe — no TPS drops * Thread-safe — prevents lag * Thread-safe of inactive blocks * Thread-safe (2–5 MB) * Thread-safe operations

🔒 Safety

* Compatible with other plugins * Compatible with other plugins * Compatible with other plugins * 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

* Chunk unload handling for safe async access * Chunk unload handling * 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

* 🟧 Gone — just placed * ⬜ Gone — decaying soon * ⬛ Gone — final warning * 💨 Gone — place more

Recommended settings

Slow mode: 2 / 2 / 1 (5 sec) Slow mode: 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)

---