Fault Fence

By
SSKirillSS

Isolates data pack errors so valid recipes, advancements, tags, and loot can still load

Fault Fence prevents individual datapack errors from breaking whole groups of content. If a recipe, tag, advancement or loot entry fails to load, the mod skips or repairs that entry and the rest loads normally.

The mod is intended for modpack authors and server admins. Each load produces a report listing the affected resources and the actions taken, so problems can be found and fixed in the source datapacks.

Supported recovery

Recipes: invalid recipes are skipped one by one. Other recipes are not affected.
Tags: if a tag contains a missing required reference, its valid entries are kept. Missing references and dependency cycles are reported.
Advancements: invalid advancements are skipped. Supported references to skipped advancements are bypassed. Readable progress is kept when advancement data is damaged.
Loot: item entries that reference missing items are either removed or replaced with an empty result, based on the config.
Recipe priorities (NeoForge only): invalid priority entries are skipped, and later entries still load.

If a supported resource fails to load, Fault Fence first checks lower-priority datapacks for a valid version of it. The resource is skipped or repaired only if no valid version is found.

All recovery categories are enabled by default. The config controls recovery categories, pack fallback, loot handling, reports and admin notifications.

Reports

Admins get a chat notification when they join a server that has reported problems, and after /reload if problems are found.

Reports are also written to logs/faultfence/. They contain resource IDs, source information where available, error messages and the recovery actions applied.