Black's MCM

Black's MCM: one menu for all your mods

Black's MCM is a mod configuration menu for Minecraft 26.2 (Fabric). It lists every mod you have installed, lets you turn each one on or off, and opens each mod's settings from the same screen. No more digging through the mods folder, hunting for config files or restarting the game by hand.

Requires: Fabric Loader and Fabric API. Client side only.

Features

• Every mod in one list. Each row shows the mod's icon, name and version, an ON/OFF switch on the left and a Config button on the right. A search box filters the list as you type.
• Turn mods on and off. Switch a mod off and it stays off, without deleting anything. Switch it back on at any time.
• One-click relaunch. Changes that need a fresh start show a "Relaunch to Apply" button. Press it at the title screen and the game closes and opens itself again with your new mod list. No launcher, no hunting for the Play button.
• Live toggles. Mods that support it switch on and off instantly at the title screen, with no relaunch at all.
• Safe toggles. If other mods need the one you are turning off, Black's MCM tells you which ones and asks first. Turning a mod on also offers to turn on the mods it needs. Fabric API, the Fabric Loader and Black's MCM itself always stay on.
• Settings for every mod. The Config button opens the mod's own settings screen. It works with mods that use Cloth Config, with mods that support Mod Menu, and with mods that ship a Black's MCM settings page.
• Built-in settings pages. Mods can describe their options in a small blacksmcm.json file, and Black's MCM builds a clean page for them with switches, sliders, choice buttons, a colour picker (RGB sliders, hex box and preset swatches), a Reset button for each option and a Reset All button.
• Works with Mod Menu. If Mod Menu is installed, its Mods button opens Black's MCM, and the "Mod Details" button still opens Mod Menu's own page. Without Mod Menu, Black's MCM adds its own Mods button to the title screen.
• Light on your PC. Icons load only for the rows you can see, are shrunk to a small size and are freed when you close the screen.
• Mods Folder button. Opens your mods folder in one click.

How to use it

1. Put the jar in your mods folder next to Fabric API and start the game.
2. Press Mods on the title screen.
3. Click a switch to turn a mod on or off, or click Config to change its settings.
4. If the screen says changes are waiting, press Relaunch to Apply. The game restarts itself with the new mod list.

Works great with

Black's MCM gives a full settings page to my other mods, such as Tale of Kingdoms and Portal Gun.

For mod authors

• Settings page with no code: add a blacksmcm.json file to your mod.
• Your own screen: implement the blacksmcm entrypoint (black.mcm.api.McmConfigProvider).
• Live on/off: implement the blacksmcm_live entrypoint (black.mcm.api.McmLiveToggle). Its setActive(boolean) is called at the title screen, and your mod switches without a relaunch.
• Toggle notice: the blacksmcm_toggle entrypoint (black.mcm.api.McmToggleListener) tells your mod it was switched, so it can tidy up before the next launch.

Found a bug? Leave a comment with your log and I will look at it.

Donations are never required, but they help me keep making mods like this one. If you would like to support the work, see my Patreon: https://patreon.com/123black.