CustomDisasters

# 🌋 CustomDisasters **Dynamic disaster events for Paper 1.20+ with a cloud-based visual editor.** CustomDisasters creates atmospheric disaster events (zombie apocalypses, skeleton armies, blood moons, etc.) that transform your Minecraft world with custom mobs, visual effects, sounds, and environmental hazards. **Main Feature:** A **cloud-based visual editor** lets you create and manage disasters from any browser — no YAML editing, no server restarts. > **⚠️ Requires (https://www.spigotmc.org/resources/protocollib.1997/) 5.0.0+** > **🌐 Cloud Editor: (https://customdisasters.online)** --- ## 🎯 What It Does **Creates disaster events that change your world:** * Custom mob spawning (allow/deny/replace mobs) * Atmospheric effects (fog, darkness, particles, lightning, sky colors) * Sound design (start sounds + ambient music) * Duration control (1-30 in-game days) * Difficulty scaling (Easy/Normal/Hard/Extreme) **Example:** "Zombie Apocalypse" spawns only zombies, replaces all passive mobs with zombies, adds fog/darkness, plays eerie music, lasts 2 in-game days. --- ## ☁️ Cloud Editor **Manage disasters from your browser — no file editing needed.** * Create disasters with visual forms (dropdowns, checkboxes) * 11 built-in disasters (enable/disable or duplicate to customize) * Global settings (cooldowns, durations) * Changes sync instantly without restarts * Access from any device **Usage:** `/disaster editor` → Visit `customdisasters.online` → Enter code → Edit → Save --- ## ✨ What's Included ## ✨ Features **11 Built-in Disasters:** 🧟 Zombie Apocalypse • 💀 Skeleton Army • 💥 Creeper Chaos • 🕷️ Spider Infestation • 👁️ Enderman Invasion • 🔥 Blaze Storm • ⚔️ Wither Siege • 👻 Phantom Swarm • 🌊 Drowned Rising • 🏹 Pillager Raid • 🌕 Blood Moon **Custom Disaster Creator:** * Visual editor (no YAML) * Mob rules (allow/deny/replace) * Effects (fog, darkness, particles, lightning, sky colors) * Sounds (10+ built-in + custom .ogg) * Duration & difficulty presets **Commands:** * `/disaster editor` - Open web editor * `/disasters start <name>` - Trigger disaster * `/disasters stop` - End current disaster * `/disasters list` - View all disasters --- ## 📦 Requirements * Paper 1.20.1+ (1.21.x recommended) * Java 17+ * **ProtocolLib 5.0.0+** (mandatory) * PlaceholderAPI 2.11.0+ (optional) --- ## 🎯 Perfect For Survival/SMP servers • RPG worlds • Challenge/Hardcore modes • Seasonal events • Content creators • Community servers --- ## 🧩 Compatibility ✅ Paper/Purpur/Pufferfish | ⚠️ Spigot (reduced visuals) | ❌ Forge/Fabric/Vanilla --- ## 📥 Installation 1. Download `custom-disasters-3.5.0.jar` 2. Install (https://www.spigotmc.org/resources/protocollib.1997/) (required) 3. Place both JARs in `/plugins/` 4. Restart server 5. Run `/disaster editor` in-game 6. Visit (https://customdisasters.online) to start creating --- ## 📖 Quick Start **Create a disaster:** 1. `/disaster editor` → Enter code at customdisasters.online 2. Click "+ Create New" → Fill visual form (4 tabs: Basic/Mobs/Effects/Sounds) 3. Save → Test with `/disasters start YourDisasterName` **Use built-ins:** Open editor → Built-in Disasters tab → Enable/disable or duplicate to customize --- ## 🔗 Links (CHANGELOG.md) • (https://customdisasters.online) • (https://customdisasters.online) --- **Developer:** Connor • **Version:** 3.5.0 • **License:** MIT