Pack Doctor
No reviews yet
Diagnose and disable slow or broken mod integrations from a config file, without editing any mod jars.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Addresses and fixes known bugs and issues.
Enhances game performance and optimizes resource usage.
Forge is a popular mod loader for versions 1.1+ of Minecraft.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
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.0autoBlacklistOverSeconds 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 = trueThe 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.
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.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources