Advanced Rules

Forgiving Void exposes its return height as a Shogi property named forgivingvoid:falling_height.

Use this when a pack or server needs more control than the regular config offers, such as different return heights per dimension or special handling for repeated void loops.

Fall Height

The value controls the Y position an affected entity is sent to after falling through the void. If no rule overrides it, Forgiving Void falls back to the level height.

Rules for the forgivingvoid:rules scope go in:

config/forgivingvoid.rules.json

For a fixed return height, target forgivingvoid:falling_height with the Y level you want entities to return from.

{
  "forgivingvoid:falling_height": "320"
}

Dimension-Specific Heights

Use Shogi's is_dimension(...) condition to return different heights per dimension.

This example returns entities from Y 192 in the Nether, Y 384 in the End, and Y 320 everywhere else:

{
  "forgivingvoid:falling_height": [
    "320",
    "is_dimension('minecraft:the_nether') -> 192",
    "is_dimension('minecraft:the_end') -> 384"
  ]
}

Repeated Loops

Forgiving Void provides a loops variable while evaluating rules. The first catch before landing has loops set to 1; each additional catch before landing increments it.

This lets rules react to entities that keep falling through the void before touching ground.

Refer to the Shogi guide for syntax, conditions, and built-in helpers.