Metadata-Version: 2.4
Name: mcmu
Version: 2.3.0rc1
Summary: A utility to update Minecraft java edition mods from Modrinth
Project-URL: homepage, https://github.com/Josiah-Jarvis/MCMU
Project-URL: source, https://github.com/Josiah-Jarvis/MCMU/
Project-URL: download, https://pypi.org/project/mcmu/#files
Project-URL: changelog, https://github.com/Josiah-Jarvis/MCMU/blob/master/CHANGELOG.md
Project-URL: releasenotes, https://github.com/Josiah-Jarvis/MCMU/compare/v2.2.0...v2.3.0
Project-URL: documentation, https://github.com/Josiah-Jarvis/MCMU/wiki
Project-URL: issues, https://github.com/Josiah-Jarvis/MCMU/issues
Author: Josiah Jarvis
Maintainer: Josiah Jarvis
License-Expression: MIT
License-File: LICENSE
Keywords: Fabric,Java,Minecraft,Modrinth,Mods
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Hatch
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# MCModUpdater (MCMU)

A utility to update and install Minecraft mods for java edition. Only works for Fabric Loader (currently).

**!IMPORTANT!**

Your .minecraft/mods/ folder must be empty before you use this program. Unintended things might happen if it is not empty.

## Usage

```bash
$ mcmu --help
usage: mcmu [-h] [--mod-dir MOD_DIR] [--game-version GAME_VERSION] [--verbose] [-v] {update,remove,install,list,search,info,enable,disable,backup} ...

A robust package to install, update, and manage Minecraft mods from Modrinth

options:
  -h, --help            show this help message and exit
  --mod-dir MOD_DIR     Path to the Minecraft mods folder (default: ~/.minecraft/mods)
  --game-version GAME_VERSION
                        The game version to use to install mods (default: 26.1.2)
  --verbose             Increase logging level (default: False)
  -v, --version         Display the version

subcommands:
  The function to run

  {update,remove,install,list,search,info,enable,disable,backup}
                        Action to run
    update              Update mods
    remove              Remove a mod
    install             Install a mod
    list                List mods
    search              Search mods
    info                Get info on a mod
    enable              Enable a mod
    disable             Disable a mod
    backup              Backup mods folder

Version: 2.2.0
```

## Support

Supported operating systems are Linux, MacOS, and Windows.

## FAQ

### Why did you build this?

I built this because I wanted to use Minecraft's default launcher but still be able to easily install and update mods like in Modrinth's launcher.

### Where do I get the mod name from?

Go to [Modrinth](https://modrinth.com) and search for you desired mod. Then get the part after the /mod/ in the url, that is the mod name to use (don't include the last forward slash).

### How does it work?

It works a lot like a package manager actually! It pulls the mods from a source (Modrinth) and installs them on the system.