Usage

Forgiving Void is automatic. If an allowed entity falls below the world's minimum Y level by the configured trigger distance, the mod sends it back above the world instead of letting the void kill it.

By default, players are returned above their last grounded position. This keeps the mod from acting like long-distance horizontal travel: if you jump off an island and drift sideways through the void, you still come back above the last place you stood.

After the fall-through, you drop back down from high above and receive the configured fall-through effects. The default effect is a short, strong blindness effect.

Landing

The default landing damage is intentionally high. A full-health player can survive the default setup, but a weakened player may still die unless preventDeath is enabled.

The fall sequence ends when you land normally, land in water or lava, get caught in a cobweb, start gliding, or are able to fly. In those non-standard landing cases, the mod clears its fall state without applying the configured landing damage.

If a player dies after being saved by Forgiving Void, the death message says they fell from the top of the world.

Repeated Falls

If you fall through the void again before landing, Forgiving Void tracks that as another loop. This mainly matters for advanced fall-height rules configured by a server or modpack.