Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Meteor showers. Earthquakes. Tornadoes. Tsunamis. Zombie sieges. Wither bosses. And a button that puts it all back.
Custom Disasters Reborn adds 25 configurable disasters to your Paper server, with a proper warning before each one, a boss bar while it lasts, and a full undo afterwards. No ProtocolLib. No website. No required dependencies.
This is a ground-up rewrite of the old CustomDisasters plugin, built to be the one you can safely leave running.
Why "Reborn"
| The old plugin | Reborn |
|---|---|
| Mob events only | 14 environmental disasters + 11 rebuilt mob disasters |
| Needed ProtocolLib | Plain Paper, nothing else |
| Configured on an external website | In-game GUI editor and clean, commented YAML |
| No permissions, mixed-up commands | One /disaster command, a permission for every subcommand, full tab completion |
| No way to undo damage | Every changed block is journaled to disk; one command rolls it back, even after a crash |
| Could lag a server | Block-change budget, TPS guard, hard entity and particle caps |
| No API | Public API, six events, register your own disaster types |
Disasters
Environmental: Meteor Shower, Earthquake, Tornado, Tsunami / Flood, Volcanic Eruption, Wildfire, Blizzard, Acid Rain, Solar Flare, Lightning Storm, Sinkholes, Sandstorm, Plague, Drought.
Mob based: Zombie Apocalypse, Skeleton Army, Creeper Chaos, Spider Infestation, Enderman Invasion, Blaze Storm, Wither Siege, Phantom Swarm, Drowned Rising, Pillager Raid, Blood Moon, with waves, elites, bosses, custom drops and spawn rules.
Combine them: chain one disaster into another, or define super events that run several at once under a shared intensity cap.
Features
- Fair warnings: countdown, boss bar, title, action bar, chat and sound before every disaster.
- Coloured atmosphere: optional resource packs tint the world for the length of an event, for example a red moon, red clouds and red land during a Blood Moon. Generated from a colour, served by a built-in web host, removed again afterwards.
- Schedules: random interval, fixed real-world times, in-game days, every N days, moon phase, player count or manual only. Per-world rules, biome rules, player limits, cooldowns, stacking limits.
- Difficulty: Easy / Normal / Hard / Extreme with editable multipliers, globally or per disaster.
- Rollback journal: nothing changes without being recorded first.
/disaster rollbackundoes any run. - Performance first: block changes are spread over many ticks, heavy shapes are computed off-thread, only loaded chunks are touched, a TPS guard scales effects down under load,
/disaster debugshows each disaster's tick cost. - In-game editor:
/disaster editchanges durations, weights, difficulty, worlds, messages, effects, mob settings and rewards, saves them to the YAML files and applies them live. - Preview mode:
/disaster previewshows a disaster to you alone, with no damage and no world changes. - Players: shelter rules, safe zones, survivor rewards (money, XP, items, commands), statistics, leaderboards, a personal HUD, optional hardcore death penalty.
- Protection aware: WorldGuard regions (with
custom-disastersflags) and GriefPrevention claims are safe by default. - Translatable: every text is in
lang/en_us.yml(MiniMessage). - Presets and templates:
peaceful,casual,hardcore,chaos; duplicate any disaster into a new variant. - Developer API: start and stop disasters, listen to events, register custom disaster types.
Quick start
- Drop the jar into
plugins/, start the server. /disaster list/disaster preview meteor_shower(only you see it)/disaster start meteor_shower/disaster rollback(put it all back)/disaster edit(tune everything), or/disaster preset apply casualfor automatic disasters
Commands
| Command | Permission | |
|---|---|---|
/disaster start <name> [world] [difficulty] [duration] |
customdisasters.start |
Start a disaster |
/disaster stop [name] |
customdisasters.stop |
Stop with full cleanup (all stops everything) |
/disaster list / info <name> / status |
customdisasters.list / .info / .status |
Overview and details |
/disaster edit [name] |
customdisasters.edit |
GUI editor |
/disaster preview <name> |
customdisasters.preview |
Admin-only preview |
/disaster rollback [id] |
customdisasters.rollback |
Undo block changes |
/disaster reload |
customdisasters.reload |
Reload config |
/disaster enable <name> / disable <name> |
customdisasters.toggle |
Toggle a disaster |
/disaster stats [player] |
customdisasters.stats (everyone) |
Statistics |
/disaster hud |
customdisasters.hud (everyone) |
Personal HUD |
/disaster debug |
customdisasters.debug |
Performance info |
Aliases: /disasters, /cd. Also: customdisasters.admin (everything), customdisasters.bypass (immune to damage), customdisasters.notify (admin notifications).
Requirements
- Paper 1.21.4 - 1.21.11 (Java 21) or Paper 26.1.x (Java 25). Tested on 1.21.4, 1.21.8, 1.21.11 and 26.1.2.
- Nothing else is required.
- Optional, detected automatically: PlaceholderAPI, WorldGuard, GriefPrevention, Vault (money rewards), Multiverse.
- Not supported: Spigot / Bukkit, Folia.
Good to know
- A fresh install does not start disasters on its own (
scheduler.mode: MANUAL). Apply a preset or set a mode. - Balance and the WorldGuard / GriefPrevention / Vault / PlaceholderAPI integrations have had little real-world testing, so please report anything odd.
- Disasters never change containers, bedrock, portals or protected regions unless you explicitly allow it.
MIT licensed.
