Pack Doctor

---

Some mods ship integrations that are slow, broken, or simply not wanted, and give you no way to turn them off. Your options are normally to delete the whole mod or edit classes out of its jar.

Pack Doctor turns those into config lines.

What it fixes

A single JEI plugin costing you the world-join screen. JEI has no per-plugin toggle. In one real pack, one mod's Arcane Anvil integration added 42 seconds to every world join, because it cross-products every item in the game against every spell. Blacklist that one plugin and JEI works normally otherwise - only that mod's recipes stop appearing in the browser.

[jei]
    pluginBlacklist = ["irons_spellbooks:jei_plugin"]

Accepts a full plugin UID, or a bare mod id to block everything that mod registers.

Not knowing which plugin is the problem. Turn on timing and Pack Doctor records how long every JEI plugin took, worst-first, to config/packdoctor-timings.txt.

[jei]
    logJeiPlugins = true
    autoBlacklistOverSeconds = 15.0

autoBlacklistOverSeconds is a safety net: any plugin that took longer than this on the previous launch is skipped automatically on the next one, and logged. Set it to 0 to disable.

A recipe book that stalls the survival inventory. A mod that throws while categorising recipes makes the vanilla recipe book rebuild endlessly - creative inventory stays fine, survival crawls, and nothing in the log points at the cause.

[recipeBook]
    disableRecipeBook = false
    recipeBlacklist = ["aoa3"]

Disable the recipe book entirely, or drop just one mod's recipes from it and keep the rest working. JEI is unaffected either way - those recipes still show up in JEI.

Mods that force a guidebook into your hands on join. Many hardcode "give the player this book the first time they join" with no config toggle.

# packdoctor-common.toml - server side
[items]
    blockedJoinItems = ["patchouli:guide_book", "simplyswords:runic_grimoire"]

Patchouli books are all the same item and differ only by NBT, so naming a specific book blocks that one book, not every Patchouli book. Every removal is logged with the item, stack size, and the rule that matched, so a player reporting missing items can be traced back to the rule responsible.

Warning: this feature deletes items from player inventories permanently, with no undo. The wildcard form "mymod:*" matches everything that mod registers, including gear the player crafted and armour they are wearing. A bare mod id with no colon is rejected on purpose, so you cannot enable whole-mod deletion by copying the syntax from the [jei] section.

FTB Library's sidebar buttons. The keycap-style icons drawn over the inventory screen. FTB Library ships no toggle for them.

[ui]
    hideSidebarButtons = true

The quest book item still works; you only lose the overlay shortcut.

Client or server

Both, independently. The JEI, recipe book and UI options are client-side; the join-item blocker is server-side. The mod does not need to be installed on both ends - a client can use the JEI blacklist against a vanilla-Forge server, and a server can use the item blocker without requiring anything of its players.

Safety

Every mixin uses defaultRequire: 0. If a future JEI or Minecraft version moves one of the targets, Pack Doctor degrades to doing nothing rather than crashing your game. JEI is an optional dependency - without it, the JEI mixins simply never apply.