Configuration

Configuration files for my mods can be found in the config folder of your Minecraft directory.

All configuration options are contained either within -common.toml or -client.toml files.

To edit configurations in-game, use one of the following mods:

Configured on NeoForge, Fabric or Forge
Mod Menu and Cloth Config on Fabric

It is recommended to restart your game when making changes to the configuration of my mods.

forgivingvoid-common.toml

returnToLastGroundedBoolean

Set to true to make Forgiving Void return the player to the sky above their last grounded position instead of their current position. Prevents players from using Forgiving Void to fly across larger distances.

Default value: true

disableVanillaAntiCheatWhileFallingBoolean

Set to true if players are rubber-banding while falling through the void. If you're hosting a public server, you should only do this if you have proper anti-cheat installed.

Default value: true

fallingHeightInteger

The height from which the player will be falling after falling through the void.

Default value: 300

damageOnFallModeDamageOnFallMode

Set to ABSOLUTE for absolute fall damage in half hearts, RELATIVE_CURRENT for a percentage of their current health, or RELATIVE_MAX for a percentage of their max health.

Default value: ABSOLUTE
Valid values: ABSOLUTERELATIVE_CURRENTRELATIVE_MAX

preventDeathBoolean

Prevent death on void fall (limits damage to leave at least 0.5 hearts)

Default value: false

damageOnFallFloat

The amount of damage applied to the player when they land.

Default value: 19.0

triggerAtDistanceBelowInteger

The distance to the minimum y level at which Forgiving Void should forgive the player and send them towards the sky.

Default value: 32

tridentForgivenessBoolean

Set to true to have tridents with loyalty be affected by Forgiving Void. Not supported on Forge.

Default value: false

dimensionAllowListSet

List of dimension ids to be allowed for Forgiving Void. Options triggerInOverworld etc. take priority.

Default value: []

entityAllowListSet

List of entity ids to be allowed for Forgiving Void. On Forge this only supports living entities.

Default value: [minecraft:player]

triggerInOverworldBoolean

Set to false to make Forgiving Void not trigger in the overworld void (dimension 0).

Default value: true

triggerInEndBoolean

Set to false to make Forgiving Void not trigger in the end void (dimension 1).

Default value: true

triggerInNetherBoolean

Set to false to make Forgiving Void not trigger in the nether void (dimension -1).

Default value: true

dimensionDenyListSet

List of additional dimension ids to be deny-listed from Forgiving Void. Options triggerInOverworld etc. take priority. Ignored if dimensionAllowList is set.

Default value: []

fallThroughVoidEffectsList

Effects applied to a player when they fall through the void, in the format "effect|duration|amplifier"

Default value: [minecraft:blindness|60|3]

Landing Damage

damageOnFall controls the landing damage, and damageOnFallMode controls how that value is interpreted.

Mode	Meaning
`ABSOLUTE`	Uses `damageOnFall` as direct damage in half-hearts.
`RELATIVE_CURRENT`	Uses `damageOnFall` as a percentage of the entity's current health.
`RELATIVE_MAX`	Uses `damageOnFall` as a percentage of the entity's maximum health.

For relative modes, values above 1 are treated like percentages. For example, 50 behaves like 0.5.

Enable preventDeath if Forgiving Void should always leave the affected entity alive with at least half a heart. The final landing damage is also capped by Minecraft's original fall damage, so the configured value is an upper limit rather than a guaranteed exact amount.

Return Position

returnToLastGrounded is enabled by default. With this enabled, players return above the last block position where they stood on the ground.

Disable it if you want entities to return above their current void position instead. That makes the mod more permissive, but it can also let players cross large gaps by falling through the void.

Dimensions

The Overworld, Nether, and End each have direct toggles:

triggerInOverworld
triggerInNether
triggerInEnd

These toggles take priority over the allow and deny lists.

For custom dimensions, use dimensionAllowList or dimensionDenyList. If dimensionAllowList is not empty, only listed custom dimensions are affected and dimensionDenyList is ignored.

Entities

By default, entityAllowList contains minecraft:player. Add other entity ids if you want Forgiving Void to save them too.

If entityAllowList is empty, players are still affected. On Forge, this option only supports living entities.

Vehicles and passengers are handled together when they are allowed, so mounts and ridden entities can be part of the fall-through behavior.

Fall-Through Effects

fallThroughVoidEffects applies status effects when an allowed living entity falls through the void.

Entries use this format:

effect|duration|amplifier

Duration is in ticks. If duration is omitted, it defaults to 600. If amplifier is omitted, it defaults to 0.

The default is:

minecraft:blindness|60|3

Loyalty Tridents

tridentForgiveness is disabled by default. When enabled, Loyalty tridents can be saved by Forgiving Void instead of being lost to the void.

This feature is not supported on Forge.

Anti-Cheat

disableVanillaAntiCheatWhileFalling can help if players rubber-band during the fall-through sequence. Leave it at the default unless players are actually having movement correction issues.

Public servers should be cautious with this option, because it disables vanilla movement checks while Forgiving Void is managing the fall. Use it only if that tradeoff makes sense for your server setup.

Usage

What happens when Forgiving Void catches a fall.

Advanced Rules

Customize the mod using Shogi.