Compatibility
Minecraft: Java Edition
1.21–1.21.1
1.20.1–1.20.6
Platforms
Supported environments
Client and server
Links
Tags
Creators
Details
Licensed ARR
Published 2 years ago
Updated 3 days ago

When the storm comes, the rivers rise
Heavy rain can turn into a flood. Rivers, lakes and oceans overflow their banks and spread across low ground, then drain away when the storm passes, and the land grows back as if nothing happened.

How it works
- 🌧️ Floods are a weather event. Each time it starts raining there's a chance (25% by default) the rain turns into a flood.
- 🌊 Real water bodies overflow. Rivers, lakes and (optionally) oceans rise above their normal level and creep outwards over low ground. Water only grows out of existing bodies of water; nothing appears out of thin air.
- 📈 The water keeps rising. The flood starts at +1 block and climbs another block every 90 seconds, up to a configurable maximum (+2 by default).
- 🏠 It floods where it rains. Only outdoors and in rainy biomes: never inside buildings or caves, not in deserts or snowy biomes.

- 💧 It drains naturally. When the rain stops, the flood water turns back into flowing water and runs off into the river, highest and outermost first.
- 🌱 The land recovers. Grass, flowers, ferns, tall grass and sugar cane covered or washed away by the flood grow back once the ground is dry. Player-built blocks are never removed.
- 💾 Saved with the world. Floods are tracked per dimension, so a restart mid-flood never leaves permanent water behind.

Commands
| Command | Description |
|---|---|
/flashflood start |
Start a flood in your dimension (starts rain if needed) |
/flashflood stop |
End the flood; the water drains away |
/flashflood status |
Show whether a flood is active and how much flood water there is |
Commands need operator permission.
Configuration
config/flash_flood_config.json
| Option | Default | Description |
|---|---|---|
floodChance |
0.25 |
Chance that a new spell of rain becomes a flood |
maxRise |
2 |
How many blocks above their normal level water can rise |
riseIntervalSeconds |
90 |
Seconds between each extra block of rise |
floodRadius |
48 |
Floods spread within this many blocks of a player |
spreadAttemptsPerPlayer |
48 |
Spots checked per player each tick (higher spreads faster) |
maxBlocksPerTick |
64 |
Cap on flood water placed per tick |
drainBlocksPerTick |
24 |
Flood water drained per tick after the storm |
maxFloodBlocks |
60000 |
Safety cap on flood water per dimension |
floodOceans |
true |
Allow oceans to overflow |
replacePlants |
true |
Cover plants instead of leaving dry spots (they grow back) |
announceFloods |
true |
Show a message when a flood starts and ends |
While a flood is active, vanilla's infinite-water-source rule is paused so flood water can't create permanent sources. Your setting is restored once the flood has drained.

Requirements
- Minecraft 1.21.1 — Fabric or NeoForge
- Architectury API 13.0.8+
- Fabric API (Fabric only)
Source and issues: GitHub



