# \ud83e\uddf6 DecayingWool – Timed Wool Decay System<\/p>\n
> Add dynamic gameplay to BedWars! Wool gradually disappears through 3 phases with full GUI customization.<\/p>\n
## \ud83d\udcd6 Description<\/p>\n
**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.<\/p>\n
### \u2728 Why is this useful?<\/p>\n
* \ud83c\udfaf **Adds strategy** \u2014 players can\u2019t just build a bridge and forget about it
\n* \u26a1 **Speeds up gameplay** \u2014 fewer \u201cturtle\u201d tactics
\n* \ud83d\udd25 **Increases dynamics** \u2014 constant movement and tension
\n* \ud83c\udfae **Balances the game** \u2014 defenses require continuous maintenance<\/p>\n
—<\/p>\n
## \ud83c\udfaf How it works<\/p>\n
### 3-Phase Decay System<\/p>\n
When a player places wool, it goes through 3 phases before disappearing:<\/p>\n
“`
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 Phase 1: Team color (5 sec) \u2502
\n\u2502 \ud83d\udfe7 Orange wool \u2502
\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
\n\u2502 Phase 2: Gray wool (5 sec) \u2502
\n\u2502 \u2b1c Warning: almost decayed \u2502
\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
\n\u2502 Phase 3: Black wool (3 sec) \u2502
\n\u2502 \u2b1b Final warning \u2502
\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
\n\u2502 Disappearance (animation + sound) \u2502
\n\u2502 \ud83d\udca8 Block is fully removed \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n
Total duration: 13 seconds (customizable!)
\n“`<\/p>\n
### \ud83c\udfa8 Visual Effects<\/p>\n
* **Particles** on each phase change (smoke, sparks, etc.)
\n* **Sounds** on color change and disappearance
\n* **Break animation** on final decay
\n* **Everything is configurable!**<\/p>\n
—<\/p>\n
## \ud83c\udfae Key Features<\/p>\n
### \u2699\ufe0f Fully Customizable Phases<\/p>\n
* \u23f1\ufe0f Set **any duration** for each phase (1\u201360 seconds)
\n* \ud83c\udfa8 Adjust **visual effects** (particles, sounds)
\n* \ud83c\udf0d Choose **which worlds** the system works in
\n* \ud83d\udd27 All via a **beautiful GUI menu** \u2014 no files required!<\/p>\n
### \ud83d\uddb1\ufe0f Intuitive GUI Controls<\/p>\n
**Main Menu** (`\/decay`):<\/p>\n
* \ud83d\udfe2 Enable\/Disable the system
\n* \u2699\ufe0f Edit phase durations
\n* \ud83c\udf0d World whitelist\/blacklist management
\n* \ud83c\udfa8 Particles & sounds configuration
\n* \ud83d\udcca Real-time statistics
\n* \ud83d\udcbe Auto-save for all settings<\/p>\n
### \u23f1\ufe0f Phase Editing via GUI<\/p>\n
**Easy time control:**<\/p>\n
* **Left click** \u2014 +1 second
\n* **Right click** \u2014 -1 second
\n* **Shift + Left click** \u2014 +5 seconds
\n* **Shift + Right click** \u2014 -5 seconds
\n* **Middle click** \u2014 reset to default<\/p>\n
Changes **auto-save** and apply immediately!<\/p>\n
### \ud83c\udf0d World Management<\/p>\n
**Two operation modes:**<\/p>\n
**Whitelist:**<\/p>\n
* Plugin works **only** in selected worlds
\n* Ideal for dedicated BedWars arenas<\/p>\n
**Blacklist:**<\/p>\n
* Plugin works **everywhere except** listed worlds
\n* Perfect for main peaceful worlds<\/p>\n
**Simple toggling:**<\/p>\n
* All server worlds displayed in one GUI
\n* Click to add\/remove
\n* Mode switches in one click<\/p>\n
### \ud83d\udcca Real-Time Statistics<\/p>\n
* \ud83d\udce6 **Active blocks** \u2014 currently decaying wool
\n* \u2705 **Total processed** \u2014 how many blocks passed through the system
\n* \u274c **Removed blocks** \u2014 total disappeared
\n* \ud83c\udf0d **Per-world** breakdown
\n* \u26a1 **Performance impact** \u2014 TPS load<\/p>\n
### \ud83c\udfa8 Effects Customization<\/p>\n
**Particles:**<\/p>\n
* Type selection (smoke, sparks, flame, etc.)
\n* Particle amount
\n* Enable\/disable<\/p>\n
**Sounds:**<\/p>\n
* On phase change
\n* On disappearance
\n* Adjustable volume & pitch
\n* Preview in GUI<\/p>\n
—<\/p>\n
## \ud83c\udfaf Example Use Cases<\/p>\n
### BedWars server<\/p>\n
“`yaml
\nFast-paced settings:
\n– Phase 1: 3 seconds
\n– Phase 2: 3 seconds
\n– Phase 3: 2 seconds
\nTotal: 8 seconds
\n“`<\/p>\n
### Sky Wars arena<\/p>\n
“`yaml
\nMedium-paced:
\n– Phase 1: 5 seconds
\n– Phase 2: 5 seconds
\n– Phase 3: 3 seconds
\nTotal: 13 seconds
\n“`<\/p>\n
### Slow mode<\/p>\n
“`yaml
\nBeginner-friendly:
\n– Phase 1: 10 seconds
\n– Phase 2: 10 seconds
\n– Phase 3: 5 seconds
\nTotal: 25 seconds
\n“`<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. **Download** the plugin JAR
\n2. **Place** it into the `plugins\/` folder
\n3. **Restart** the server or run `\/reload`
\n4. **Done!** Configure via `\/decay`<\/p>\n
### Requirements<\/p>\n
* \u2615 **Java**: 8
\n* \ud83c\udfae **Minecraft**: 1.8.x
\n* \ud83d\udd0c **Platform**: Spigot \/ Paper \/ Bukkit
\n* \ud83d\udcbe **RAM usage**: ~2\u20135 MB (very lightweight!)<\/p>\n
—<\/p>\n
## \ud83d\udcbb Commands & Permissions<\/p>\n
### Commands<\/p>\n
| Command | Description | Aliases |
\n| —————- | ————————- | ————— |
\n| `\/decay` | Open main settings menu | `\/dw`, `\/dwool` |
\n| `\/decay menu` | Open main menu | – |
\n| `\/decay reload` | Reload configuration | – |
\n| `\/decay toggle` | Enable\/disable system | – |
\n| `\/decay stats` | Open statistics menu | – |
\n| `\/decay cleanup` | Clear all decaying blocks | – |<\/p>\n
### Permissions<\/p>\n
“`yaml
\ndecayingwool.* # All permissions
\n \u2514\u2500 decayingwool.admin # Full access to commands & GUI
\n \u2514\u2500 decayingwool.bypass # Player\u2019s wool does NOT decay*
\n“`<\/p>\n
**\u26a0\ufe0f Note:**
\n`bypass` only works for **non-OP** players. OP players always follow decay rules.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### config.yml<\/p>\n
The plugin auto-generates config files, but **GUI editing is recommended**!<\/p>\n
“`yaml
\n# Main settings
\nplugin:
\n enabled: true
\n debug: false<\/p>\n
# Decay settings
\ndecay:
\n enabled: true
\n phase1-duration: 5
\n phase2-duration: 5
\n phase3-duration: 3<\/p>\n
world-mode: “whitelist”
\n enabled-worlds:
\n – world_bedwars
\n – bw_arena1<\/p>\n
effects:
\n particles:
\n enabled: true
\n type: “SMOKE_NORMAL”
\n amount: 5
\n sound:
\n enabled: true
\n phase-change: “BLOCK_WOOL_BREAK”
\n disappear: “BLOCK_WOOL_BREAK”
\n volume: 0.5
\n pitch: 1.0<\/p>\n
drops:
\n drop-items: false
\n drop-on-break: true<\/p>\n
# Performance
\nperformance:
\n max-blocks-per-tick: 50
\n cleanup-interval: 200
\n async-processing: true
\n“`<\/p>\n
—<\/p>\n
## \ud83c\udfaf Server-Oriented Features<\/p>\n
### \u26a1 Performance Optimizations<\/p>\n
* **Asynchronous processing** \u2014 no TPS drops
\n* **Blocks-per-tick cap** \u2014 prevents lag
\n* **Auto cleanup** of inactive blocks
\n* **Low memory usage** (2\u20135 MB)
\n* **Thread-safe** operations<\/p>\n
### \ud83d\udd12 Safety<\/p>\n
* **Permission checks**
\n* **Config validation**
\n* **No duplication exploits**
\n* **Compatible with other plugins**<\/p>\n
### \ud83c\udf10 Compatibility<\/p>\n
Tested with:<\/p>\n
* BedWars1058
\n* BedWarsProxy
\n* Multiverse-Core
\n* WorldGuard
\n* GriefPrevention
\n* EssentialsX<\/p>\n
—<\/p>\n
## \ud83d\udcca Technical Details<\/p>\n
### Architecture<\/p>\n
“`
\nDecayingWool
\n\u251c\u2500\u2500 Managers
\n\u2502 \u251c\u2500\u2500 DecayManager
\n\u2502 \u251c\u2500\u2500 GUIManager
\n\u2502 \u251c\u2500\u2500 WorldManager
\n\u2502 \u2514\u2500\u2500 ConfigManager
\n\u251c\u2500\u2500 GUI Menus
\n\u2502 \u251c\u2500\u2500 MainMenu
\n\u2502 \u251c\u2500\u2500 PhaseSettingsMenu
\n\u2502 \u251c\u2500\u2500 WorldManagement
\n\u2502 \u251c\u2500\u2500 EffectsMenu
\n\u2502 \u2514\u2500\u2500 StatisticsMenu
\n\u251c\u2500\u2500 Listeners
\n\u2502 \u251c\u2500\u2500 BlockPlace
\n\u2502 \u251c\u2500\u2500 BlockBreak
\n\u2502 \u251c\u2500\u2500 InventoryClick
\n\u2502 \u2514\u2500\u2500 ChunkListener
\n\u2514\u2500\u2500 Models
\n \u2514\u2500\u2500 DecayingBlock
\n“`<\/p>\n
### Data Handling<\/p>\n
* **ConcurrentHashMap** for safe async access
\n* **Periodic cleanup**
\n* **Chunk unload handling**<\/p>\n
—<\/p>\n
## \ud83c\udfae Usage Tips<\/p>\n
### For admins<\/p>\n
1. Start with default settings (5\/5\/3)
\n2. Test on an arena
\n3. Get player feedback
\n4. Adjust for your server style
\n5. Use statistics menu<\/p>\n
### For players<\/p>\n
* \ud83d\udfe7 **Colored wool** \u2014 just placed
\n* \u2b1c **Gray wool** \u2014 decaying soon
\n* \u2b1b **Black wool** \u2014 final warning
\n* \ud83d\udca8 **Gone** \u2014 place more<\/p>\n
### Recommended settings<\/p>\n
**Fast-paced (solo):** 2 \/ 2 \/ 1 (5 sec)
\n**Standard (2\u20134 players):** 5 \/ 5 \/ 3 (13 sec)
\n**Slow mode:** 10 \/ 10 \/ 5 (25 sec)<\/p>\n
—<\/p>\n
## \ud83d\udc1b Known limitations<\/p>\n
* Only works with **wool** (`Material.WOOL` in 1.8.8)
\n* More blocks can be added via `affected-wool`
\n* Timers reset on server restart (normal behavior)<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
DecayingWool – Timed Wool Decay System<\/p>\n","protected":false},"featured_media":55191,"template":"","meta":{"_minecraft_slug":"decayingwool","_minecraft_project_id":"obnd0iPH","_minecraft_author":"sterchiks","_minecraft_license":"MIT","_minecraft_downloads":99,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"decayingwool.zip","_minecraft_size_bytes":30255,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:44:04.830802Z","_minecraft_date_created":"2025-12-18T00:22:40.288433Z","_minecraft_date_modified":"2025-12-06T06:36:54.743626Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/decayingwool","_minecraft_icon_attachment_id":55191,"_minecraft_imported_at":"2026-06-03T01:38:11+00:00","_minecraft_import_hash":"49366953bcf8666966e158042e752e03","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[22,23,24,25,26,27,28,29,30,31],"class_list":["post-55190","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9"],"yoast_head":"\n