Metadata-Version: 2.4
Name: mcmu
Version: 1.2.0a1
Summary: A utility to update Minecraft java edition mods from Modrinth
Project-URL: homepage, https://github.com/Josiah-Jarvis/MCModUpdater
Project-URL: source, https://github.com/Josiah-Jarvis/MCModUpdater/
Project-URL: download, https://pypi.org/project/mcmu/#files
Project-URL: changelog, https://github.com/Josiah-Jarvis/MCModUpdater/blob/master/CHANGELOG.md
Project-URL: releasenotes, https://github.com/Josiah-Jarvis/MCModUpdater/compare/1.2.0a0...1.2.0a1
Project-URL: documentation, https://github.com/Josiah-Jarvis/MCModUpdater/blob/master/README.md
Project-URL: issues, https://github.com/Josiah-Jarvis/MCModUpdater/issues
Author: Josiah Jarvis
Maintainer: Josiah Jarvis
License-Expression: MIT
License-File: LICENSE
Keywords: Fabric,Java,Minecraft,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
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX
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.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: File Formats
Classifier: Topic :: File Formats :: JSON
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.13
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
usage: mcmu [-h] [-u] [-r REMOVE] [-i INSTALL] [-l] [-v] [-m MINECRAFT_DIR] [-g GAME_VERSION]

options:
  -h, --help            show this help message and exit
  -u, --update          Updates installed mods
  -r, --remove REMOVE   Removes an installed mod
  -i, --install INSTALL
                        Installs a mod
  -l, --list            List installed mods
  -v, --version         show program's version number and exit
  -m, --minecraft_dir MINECRAFT_DIR
                        Path to the Minecraft folder, defaults to '~/.minecraft/'
  -g, --game_version GAME_VERSION
                        Default game version
```

### Update installed mods

```bash
mcmu -u
```

### Remove a mod

```bash
mcmu -r mod-name
```

### Install a mod

```bash
mcmu -i mod-name
```

### List mods

```bash
mcmu -l
```

## 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.

### Why can't I downgrade mods?

As of now you can not downgrade most mods because the installer always checks for the latest version. For example if you have a mod that releases version 12 for Minecraft 1.21.11 but its latest version for Minecraft 1.21.10 is 11 then you can not downgrade that mod.

A solution!

Do:

```bash
mcmu -r mod-name
mcmu -g game_version -i mod-name
```

### 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. It keeps a list of the installed mods in a config file for easy access of the installed mods.
