minecraft-mod-manager

Install and update mods from CurseForge and Modrinth through a simple command.

News — No GUI Update, focus on CLI improvements (2022-03-19)

After some pondering, I've decided to shelve the actual GUI update and instead continue working on the CLI python version.

There were a lot of reasons against a GUI update. But mainly, it would require a lot of time and energy to do a GUI and rewrite the entire application. I'd rather spend time fixing existing bugs, improving the CLI and installation process, and making it more user-friendly.

Now to the fun part, what's to come in the next releases... read full story

(News Archive)

Features

• Install mods with minecraft-mod-manager install mod_name
• Update all mods with minecraft-mod-manager update, mcman update or mmm update
• Searches on CurseForge and Modrinth for updates on installed mods
• Filter updates by
  • Stable (default), beta --beta, or alpha --alpha releases
  • Minecraft version -v 1.16.4
  • Fabric/Forge mod --mod-loader fabric

Installation/Upgrade & Requirements

1. Requires at least python 3.8
2. Install/Upgrade with $ pip install --user --upgrade minecraft-mod-manager

Examples

Note! All examples start with minecraft-mod-manager, mcman or mmm (shorthand commands) then comes the arguments.

Full usage

positional arguments:
  {install,update,configure,list}
                        Install, update, configure, or list mods
  mods
                        The mods to update or configure.
                        If no mods are specified during an update, all mods will be updated.
                        You can specify download sites and slugs for each mod (if necessary)
                           dynmap=curse
                           dynmap=curse:dynmapforge
                           dynmap=curse:dynmapforge,modrinth
                           dynmap=curse:dynmapforge,modrinth:dynmap

minecraft:
  -d DIR, --dir DIR     Location of the mods folder. By default it's the current directory
  -v MINECRAFT_VERSION, --minecraft-version MINECRAFT_VERSION
                        Only update mods to this Minecraft version. Example: -v 1.16.4
  --beta                Allow beta releases of mods
  --alpha               Allow alpha and beta releases of mods
  --mod-loader {fabric,forge}
                        Only install mods that use this mod loader. You rarely need to be
                        this specific. The application figures out for itself which type
                        you'll likely want to install.

logging & help:
  -h, --help            show this help message and exit
  --version             Print application version
  --verbose             Print more messages
  --debug               Turn on debug messages
  --pretend             Only pretend to install/update/configure. Does not change anything
  --no-color            Disable color output

Planned features

• Automatically install dependencies
• Executable for Windows

Alternatives

GUI

• kaniol-lck/modmanager
• ReviversMC/modget-minecraft
• 4JX/mCubed

CLI

• sargunv/modsman
• tyra314/modweaver

Authors

• Matteus Magnusson, senth.wallace@gmail.com