Forge Creeper Heal Mod — Guide
Advanced Filtering
The mod allows for precise control over which blocks are affected by the healing logic and which entities are allowed to trigger it.
Exception Lists
- removeException: Blocks in this list are not removed by the mod during an explosion. They will behave like vanilla Minecraft blocks (dropping as items or being destroyed). Warning: Removing
minecraft:tntfrom this list will disable TNT chain reactions, as the mod will 'capture' the TNT before it can ignite its neighbors. - healException: Blocks in this list will be removed by the explosion but will never be restored. Use this for blocks you want to remain permanently destroyed.
- sourceException: This list filters the cause of the explosion. It requires the Java canonical class name of the entity. For example, adding
net.minecraft.world.entity.monster.Creeperwould prevent the mod from healing damage caused specifically by Creepers.
Technical Details
Forge Creeper Heal is designed to be lightweight. It uses a tick-based scheduling system to ensure that block restoration does not cause server-side TPS (Ticks Per Second) drops.
- Tick Conversion: 20 ticks = 1 second.
- Default Start: 6000 ticks = 5 minutes.
- Full Cycle: By default, a full repair cycle typically completes within half a Minecraft day (12,000 ticks).
Core Mechanics
The mod operates by intercepting the explosion event before blocks are converted into item drops. It records the exact state, orientation, and NBT data (for containers) of every block within the blast radius.
The Healing Process
- Capture: When an explosion occurs, the mod identifies all affected blocks.
- Removal: Blocks are removed from the world. By default, they do not drop as items to prevent inventory clutter and lag.
- Delay: The mod waits for a configurable period (defined by
minTickStartandmaxTickStart). - Reconstruction: Blocks are placed back into the world one by one at a randomized rate. This creates a 'natural' healing effect where the terrain slowly knits itself back together.
Container Handling
One of the mod's most powerful features is its ability to restore containers like Chests, Shulker Boxes, and Barrels. Depending on the configuration, the mod can either drop the contents on the ground or 'remember' the items and restore them inside the container once it is repaired.