PatchLib - Bug Fixes, Crash Fixes & Mod Compat

PatchLib is a random assortment of bug fixes, crash fixes and compatibility patches for various mods — Farmer's Delight, Tom's Simple Storage, Vampirism, Toxony, Create, KubeJS, Arclight and more.

I originally built it just to stop the servers I run from crashing. Over time it grew into a proper little library of fixes, and at some point it stopped making sense to keep it to myself — if one of these crashes has cost you a server restart at 2 AM, this is for you.

Patches only run when they are actually needed

This is the part that matters if you maintain a modpack. PatchLib never touches a mod you do not have installed. Before a single patch is applied, it checks:

• Is the target mod installed? If not, the patch is skipped — no errors, no log spam.
• Is the mod version actually affected? Several fixes are bound to the exact versions that carry the bug. Update the mod past it and the patch quietly steps aside instead of fighting the official fix.
• Does another mod already patch this? Known conflicts disable the patch automatically.
• Is this the right side? Client-only fixes are never loaded on a dedicated server.

Every decision is printed on startup, so you always know what is running:

[PatchLib] --- Patch Status Report (dedicated server) ---
[PatchLib]  compat.create_contraption_collider [...] -> ACTIVE
[PatchLib]  farmersdelight.tag_load_order      [...] -> SKIPPED (target not present)
[PatchLib]  patchouli.book_registry_lookup     [...] -> CLIENT ONLY (not loaded on a dedicated server)
[PatchLib] --- 5 of 18 patches active ---

Drop it into a pack with none of the target mods and it does exactly nothing.

Included fixes

Crash fixes

Arclight / hybrid server fixes

• ClassCastException when modded entities run Villager AI tasks
• NullPointerException in Brain.tick from Arclight's villager career redirect
• ClassCastException mapping Friends & Foes entities to Bukkit wrappers

These only load when Bukkit classes are present, so they are inert on plain NeoForge.

Compatibility & behaviour fixes

Version-bound patches

A few fixes only apply to the mod versions that actually carry the bug. If your version is newer, PatchLib reports the patch as skipped — that is intended, not a failure:

Everything else applies to any version of its target mod.

Configuration

Every patch has its own toggle in config/patchlib-patches.properties. The file is generated on first launch with one commented entry per patch:

# --- toms_storage ---
# Treats a retired NeoForge BlockCapabilityCache as an empty inventory instead of throwing
# IllegalStateException out of InventoryConnectorBlockEntity ticking
toms_storage.stale_capability_cache=true

If a fix ever conflicts with something, turn off that one line — no need to remove the mod.

Sides

PatchLib is a server-side mod, optional on the client. It registers no network packets and no registry entries, so players without it can join your server normally. Installing it on the client as well simply adds the two client-side fixes on top.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1+
• No dependencies

⚠ Please read before reporting

These patch bugs in other people's mods. As those mods update, some of these issues will be fixed properly at the source. Where I know the affected version range, PatchLib disables the patch automatically once you update past it — but I cannot predict every future release. If a mod fixes something natively and the patch gets in the way, just set it to false in the config.

Bug reports about the patches themselves are very welcome. Bug reports about the patched mods belong to their authors.