Pack Doctor

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.