Releases: Qendolin/mod-bisect-tool
Release list
Pre-Release 7 v2.1.0
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
Using the GUI is recommended.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
Add translations for ja, zh, ko, ru, pl, tr, pt_BR, uk, zh_TW (in addition to de, es, fr, it, pt previously)
Pre-Release 6 v2.1.0
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
Using the GUI is recommended.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
- Add screen for selecting initial mod state
- Add prompt to disable crash assistant
- Add world backup warning
Pre-Release 5 v2.1.0
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
Using the GUI is recommended.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
- Fixed a critical issue that could prevent dependencies of nested JAR modules from being loaded before activation.
- Improved support for Maven version ranges and qualifiers, including versions containing +.
- Improved diagnostic logging with clearer dependency trees and resolution results.
- Improved bisection history and reports with clearer information about tested, stable, and cleared mods.
- Reduced duplicate log messages by keeping bisection previews quiet while logging committed test plans once.
Pre-Release 4 v2.1.0
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
- Fixed log file directory on macos
Pre-Release 3 v2.1.0 Translations
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
- Added translations for DE, ES, FR, IT and PT
Pre-Release 2 v2.1.0
Quick Download
Important
macOS and Linux note: Raw binaries need an execute bit before they can run: chmod +x ./mod-bisect-*. This is required because some downloads are saved without the execute permission enabled. On macOS, if the app is blocked by Gatekeeper, clear quarantine metadata with xattr -dr com.apple.quarantine "Mod-Bisect-Tool.app" (for the .app bundle) or with the same command on the raw binary itself.
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | x86_64 / amd64 | Download | Download |
| Linux | x86_64 / amd64 | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (x86_64) | Download | Download |
Other Versions
| Platform | Architecture | GUI (Graphical) | TUI (Terminal) |
|---|---|---|---|
| Windows | arm64 / aarch64 | Download | Download |
| Linux | arm64 / aarch64 | Download | Download |
How to use
Please see the respective guide for instructions:
GUI User Guide | TUI User Guide
Release Information
- Fix macOS GUI build
- Fix NeoForge case-sensitive dependency parsing
- Print app version and startup info
Pre-Release 1 v2.1.0 Indeterminate Results
Quick Download
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | Recommended GUI Download | Recommended TUI Download |
|---|---|---|---|
| Windows | 64-bit (amd64) | Download | Download |
| Linux | 64-bit (amd64) | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (amd64) | Download | Download |
Other Versions
| Platform | Architecture | GUI Download | TUI Download |
|---|---|---|---|
| Windows | ARM64 | Download | Download |
| Linux | ARM64 | Download | Download |
Legacy & Other Builds
Check the raw Assets checklist at the very bottom of this page for alternative formats.
⚠️ Note for Mac/Linux users: After downloading, you may need to grant execution permissions:chmod +x <filename>.
Release Information
Added
- Third
INDETERMINATEtest result. When a secondary issue (e.g. a crash)
prevents the outcome of a test from being observed, the bisection runs a
complement test on the other half and continues. See
docs/IterativeMinimalConflictSearch-Indeterminate.md. - A
? Can't Tellverdict button on the GUI and TUI test prompts, with anS
shortcut in the TUI. - A full-screen "Search Halted" page showing the two conflicting mod groups when
both halves of a split are indeterminate, with undo/reset actions. - Unit, integration, and e2e coverage for the indeterminate paths, including a
test that masking mods never enter the conflict set. - An explicit mod loader selection on the setup screens: the GUI and TUI now
show a dropdown (Fabric, (Neo)Forge, (Neo)Forge with Fabric via Sinytra
Connector, or Fabric with (Neo)Forge via Kilt). A loader can also be forced
with the new-loadercommand-line flag. - A smarter mods-directory probe that recommends a loader based on detected
bridge mods (Sinytra Connector / Kilt) or the majority of detected mod
manifests, replacing the old-quilt/-neoforgeflags.
Changed
- The
RunLoadertype now decides which mod manifests are recognized and in
what priority order. Fabric manifests take priority over Quilt manifests, and
jars whose manifests target a loader that isn't enabled (e.g. a (Neo)Forge mod
under the Fabric loader) are skipped with an explicit warning instead of being
silently misclassified. - The app layer was split into focused role controllers.
pkg/appnow exposes
separateBisectionControllerandModStatusControllerimplementations
instead of oneApptype mixing lifecycle, search, and per-mod status
handling, with the sharedAppremaining the top-level controller handed to
the UI. No user-visible behavior changes. - The UI
Viewinterface surfaces the halted search via the non-blocking
OnBisectionHaltedpage navigation instead of a blocking dialog. - The main page reflects a halted search: the step button no longer claims a
next step is possible and progress is shown as usual. - TUI: closing a modal now refreshes the page underneath, so it always reflects
the latest search state. - TUI: closing the console window (Windows
CTRL_CLOSE_EVENT) now restores the
mods folder and exits immediately instead of showing a quit dialog that
nobody can answer and freezing until Windows kills the process. - Sinytra and Kilt are now automatically force-enabled to speed up the search.
- The TUI now uses
mod-bisect-tui-as a log file prefix.
Fixed
- Cross-loader dependency resolution now normalizes mod IDs containing
-and_so Fabric/NeoForge bridge setups can resolve dependencies
such asother-mod-bandothermodbconsistently. - The
mandatoryfield of Forge dependency declarations is now used. - Mod state is now restored when the TUI's console window is closed.
- A race condition during mod loading that could lead to a crash.
Pre-Release 2 v2.0.0
Quick Download
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | Recommended GUI Download | Recommended TUI Download |
|---|---|---|---|
| Windows | 64-bit (amd64) | Download | Download |
| Linux | 64-bit (amd64) | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (amd64) | Download | Download |
Other Versions
| Platform | Architecture | GUI Download | TUI Download |
|---|---|---|---|
| Windows | ARM64 | Download | Download |
| Linux | ARM64 | Download | Download |
Legacy & Other Builds
Check the raw Assets checklist at the very bottom of this page for alternative formats.
⚠️ Note for Mac/Linux users: After downloading, you may need to grant execution permissions:chmod +x <filename>.
Release Information
Added
- New GUI. The tool now has a graphical interface for the first time, alongside the existing terminal version. It has a setup screen with a folder browser, a screen to keep selected mods enabled, live progress and candidate lists, and a results screen.
- Native dialogs in the GUI. Prompts, errors, questions and the folder picker use native operating system dialogs, attached to the main window.
- Automatic Quilt/NeoForge detection in the GUI.
- Separate user guides for the GUI and the TUI.
- An unresolvable mods screen. If mods cannot be enabled because their dependencies could not be resolved, both the GUI and the TUI show a screen right after loading that lists each mod with its failing dependencies and lets you choose to ignore them (keeping the mod enabled) or disable it.
Changed
- The TUI is faster and smoother. The terminal backend now uses the modern VT implementation instead of the deprecated console adapter, and the terminal library was upgraded.
- Unresolvable mods are no longer silently dropped from the search. Mods flagged at load are offered an Ignore/Disable choice per mod, and an unresolvable mod can no longer be force-enabled. If a mod becomes unresolvable mid-search, it is disabled and reported automatically.
- TUI scrollable lists and the results text show small arrows when there is more content above or below the visible area.
- Conflict sets are shown as separate "current" and "independent conflict set" sections.
- Missing mod files are handled during a search. You are asked to confirm, the mod is marked missing, and the search continues without crashing.
- The tool restores your mod files to their original state on exit, including after a crash.
- The test outcome buttons are now labeled "Works" and "Broken".
- The GUI lists (candidates, conflict set, and the active mods of a test) now show mod names with the mod id below, matching the mod selection screen.
- On the GUI test screen, mods that are only enabled because another mod needs them are shown in a muted, italic style with an "(dependency)" tag, and mods kept on for every test get an "(always)" tag. The list is titled "Active mods (N)".
Fixed
- Issue #5, unresolvable mods were disabled even when force-enabled. You can now keep an incorrectly-flagged mod by ignoring its failing dependencies on the unresolvable mods screen.
- Issue #10, partial conflict set early termination. When the verification test shows the found conflict set is incomplete, you can stop with a single known mod instead of being forced to find every member.
- The log and history pages could not be opened in the TUI while a modal page (for example the test page) was open.
- The result page told you to disable all mods of a conflict set; it now tells you to disable any single one of them.
- The GUI quit confirmation said "Unsaved progress will be lost", which made no sense since there is no way to save progress. It now says the current search progress will be lost.
Pre-Release 1 v2.0.0 with GUI App
Quick Download
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | Recommended GUI Download | Recommended TUI Download |
|---|---|---|---|
| Windows | 64-bit (amd64) | Download | Download |
| Linux | 64-bit (amd64) | Download | Download |
| macOS | Apple Silicon (arm64) | Download | Download |
| macOS | Intel (amd64) | Download | Download |
Other Versions
| Platform | Architecture | GUI Download | TUI Download |
|---|---|---|---|
| Windows | ARM64 | Download | Download |
| Linux | ARM64 | Download | Download |
Legacy & Other Builds
Check the raw Assets checklist at the very bottom of this page for alternative formats.
⚠️ Note for Mac/Linux users: After downloading, you may need to grant execution permissions:chmod +x <filename>.
Release Information
Release v1.1.0
Quick Download
Select the download for your operating system. For most standard computers, the 64-bit (amd64) or Apple Silicon options are what you need.
| Platform | Architecture | Recommended Download |
|---|---|---|
| Windows | 64-bit (Standard) | Download Executable |
| Linux | 64-bit (Standard) | Download Binary |
| macOS | Apple Silicon (M1/M2/M3/M4) | Download Binary |
| macOS | Intel | Download Binary |
Legacy & Other Builds
If you are running older 32-bit machinery (like Linux/Windows ), check the raw Assets checklist at the very bottom of this page.
⚠️ Note for Mac/Linux users: Because these are raw binaries, you may need to grant execution permissions after downloading by runningchmod +x fabric-mod-bisect-tool-*in your terminal.
Release Information
NeoForge mods are now supported.
Don't forget to check the checkbox to enable NeoForge support on the Setup Page!