🌋 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 ProtocolLib 5.0.0+ 🌐 Cloud Editor: 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 ProtocolLib (required)
3. Place both JARs in /plugins/
4. Restart server
5. Run /disaster editor in-game
6. Visit 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 • Issues • Cloud Editor

---

Developer: Connor • Version: 3.5.0 • License: MIT