Collapsing Caves

---

This pages mod description only accurately portrays version 1.6+ of the mod.

New versions of this mod (v1.6+) are for Fabric and NeoForge only. This mod is in BETA.

You can use this mod in modpacks.

I have zero issue with this mod being in modpacks and I don't need to be credited.

Version 1.6 Notes

Version 1.6 released on July 25th. This version is called the 'Annoyance Fix Update' because I personally playtested 1.5 for a while and had my own personal grievances with the mod that I felt detracted enjoyment from playing the game. There was a notable lack of 'power' to prevent cave-ins, issues with environments being griefed and turned ugly, and last but not least I felt that some caved-ins were happening inappropriately or incorrectly... Not to mention they happened way more often than I thought they would.

---

---

What This Mod Does

You mine a block below ground. Sometimes the ceiling above you falls.

When a cave-in starts, the screen shakes and you hear a deep rumble. Groups of blocks then fall from the ceiling. The blocks hurt players and mobs, they make dust when they hit the ground, and they stay in the position where they land.

A cave-in has a fixed centre at the block that you broke. It does not follow you. If you move away from the centre, you are safe.

---

How A Cave-In Starts

These blocks can start a cave-in when you break them:

• Stone and the different types of stone
• Deepslate
• All ore
• Dirt, clay and the different types of dirt
• Gravel
• Sulfur and cinnabar, in the newer versions of the game only

Each applicable block that you break has a 1 in 512 chance to start a cave-in. These rules also apply:

• You cannot start a cave-in if you can see the sky.
• You cannot start a cave-in for 20 minutes after you log in.
• You cannot start a new cave-in for 20 minutes after your last one.
• A tool with the Gentle enchantment never starts a cave-in.
• Not more than 3 cave-ins can occur at the same time.

---

Cave-In Sizes

There are three sizes. A small cave-in is the most frequent size.

Size	Chance	Time	Blocks in each group	Distance to the side	Height above you
Small	60%	60 seconds	14 to 17	8 blocks	24 blocks
Medium	30%	90 seconds	18 to 21	12 blocks	32 blocks
Large	10%	120 seconds	22 to 35	16 blocks	48 blocks

One group of blocks falls each second, approximately. A group is a set of blocks that touch each other. The mod can also divide the group into more than one shape.

---

Which Blocks Fall

The mod is careful about the blocks that it selects. A block falls only if all of these conditions are true:

• The block is part of the ceiling of the open space that you are in. A different cave behind a wall does not fall.
• There is air below the block.
• The block cannot see the sky.
• A player did not put the block in position.

A block keeps its type when it falls. Stone stays stone and ore stays ore. The blocks fall at one half of the usual speed, thus you have time to move away.

---

The Gentle Enchantment

Gentle is a new enchantment for pickaxes and other mining tools. Modded tools also accept it.

• You can get Gentle from an enchanting table.
• The maximum level is 1.
• A tool with Gentle never starts a cave-in.

Use Gentle when you must mine in a large cave and you do not want the risk. Keep a second tool without Gentle for the times when you want the danger.

---

Damage

A falling block causes 2 points of damage for each block of the fall distance. The limit is 6 points, which is 3 hearts.

One block does not kill you. If the blocks cover you, suffocation causes more damage. Move out of the area or make a hole to breathe.

---

Configuration

The mod writes a settings file with the name collapsingcaves.conf in the config folder. There are 25 settings in the file. Each setting has a short description and its permitted values.

You can change these values and more:

• The chance of a cave-in
• The number of cave-ins at the same time
• The time, the group size and the distance of each cave-in size
• The speed and the damage of the falling blocks
• The grace period and the cooldown
• The screen shake, the sounds and the dust
• The blocks that can fall or must never fall

The default values are balanced. The mod does not become an annoyance with them.

---

Commands

An operator can use these commands.

Command	What it does
/triggercollapse <size> <player>	The next applicable block that the player breaks starts a cave-in of this size.
/collapsecooldown <player>	Shows if a cooldown prevents a cave-in for this player.
/setcooldown <seconds>	Sets your cooldown. A value of 0 removes it.

---

Supported Versions

The mod gives the same features and the same behaviour on all of these versions.

Game version	Loaders
1.20.1	Fabric, NeoForge
1.21.1	Fabric, NeoForge
26.2	Fabric, NeoForge

---

Bugs/Feedback

Report bugs, make suggestions or give feedback in the issues section of the mod Github page. When you report a bug, give your mod loader and your game version.

---

Special Thanks & Credits

Cave-Ins by Lettooce was the inspiration for this mod. It is an excellent datapack and everyone must try it. This mod uses a different approach, but that datapack gave me and my friends some of our best memories in Minecraft. Without it, this mod would not exist.

Made by CCDelic.