CustomDisasters
Custom Disasters is a Paper plugin that adds dynamic world events like Blood Moons, Zombie Apocalypses, and Nether Breaches, each transforming gameplay with unique mob behavior and atmospheric world effects.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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.
cloud-based visual editor A cloud-based visual editor lets you create and manage disasters from any browser — no YAML editing, no server restarts.
> 🌐 Cloud Editor: %%MD1%% > 🌐 Cloud Editor: %%MD1%%
---
🎯 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
---
License: Connor • License: 3.5.0 • License: MIT