Skycat's Binary Search Tool

Not a mod, don't put it in your mods folder!

This tool helps you binary search through your fabric mod list. This is useful when you think there is one mod that is causing problems, but you can't figure out which one from logs. This will NOT work when there's more than one mod causing the problem, when you're missing dependencies (including Minecraft or Java), or for non-fabric things.

How to use

Download the application from the Releases page.
Double-click it to run it
Go to your mods folder and copy the path (on Windows with the default launcher it'll look like C:\Users\YourName\AppData\Roaming\.minecraft\mods).
Paste that into the program in the "mods folder" text box.
Make sure Minecraft is closed, then click start! The tool will disable about half your mods and keep required dependencies enabled too.
Check if the problem was there and close Minecraft (it's ok if it crashed).
If the SAME problem is still there, click "Failure." If it's gone, click "Success."
Go back to #7 until the program reports that it is done.
Once you're done, be sure to report the issue to the mod authors.

What is a binary search?

In this context, a binary search is disabling half of your mods, and checking if the problem still occurs. If it does, then you know the problem is in that half of the mods. If it doesn't, the problem is in the other half. Then you do it again. Eventually, you're left with one mod, which is the problem.

The thing is, this can be hard. You have to make sure every mod has all its dependencies, and keep track of which ones have worked and which ones haven't. That's what this tool is for.

What can it help with?

A binary search can find when one mod, and only one mod, is causing a problem. It can't find a conflict between two mods, tell you what dependencies you're missing, or fix the mod. It's a good tool as a last resort if the logs don't give a conclusive answer.

Need help with reading logs? Try the Fabric Discord server in the #player-support channel.

What do I do if the tool breaks?

Report it on the Issues tab. I'll take a look and see if it's in-scope to fix. If some of your mods are disabled, you can re-enable them by renaming the files to remove the .disabled part at the end. Windows will warn you about it - it's safe to ignore. You can also enable them via MultiMC (or another launcher probably). For immediate help, try the Fabric Discord server. Ping@skycatminepokie if the tool is broken. If it's just your Minecraft, ask in the #player-support channel.

Building from source

Clone the repo
Run .\gradlew shadowJar
Built product is build/libs/BinarySearchTool-(version)-all.jar