Skip to main content

Download and update Minecraft mods from CurseForge and possibly other places in the future.

Project description


python Latest PyPI version Downloads Total alerts Language grade: Python

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


  • 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


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

Arguments Description
install jei Searches for jei on all sites and installs the latest version.
install sodium=modrinth Install Sodium specifically from modrinth.
install dynmap=curse:dynmapforge Install dynmap with slug dynmapforge on Curse.
install sodium=modrinth --mod-loader fabric Install fabric version of sodium. Generally not necessary to specify mod-loader
install carpet fabric-api sodium lithium Easily install many mods.
update Update all mods.
update --pretend Check what will be updated. Does not change anything.
update sodium lithium phosphor Update specific mods.
update -v "1.16.5" Updates to latest mod version which works with specified MC version.
update -v "1.16.1" If you upgraded the mods, to a higher version (e.g. snapshot), you can easily downgrade them again.
configure sodium=modrinth Change the download site for a mod.
configure sodium= Reset download sites (downloads from all sites again)
configure carpet=curse:fabric-carpet Change site slug for a mod.
configure carpet=curse If you don't define a slug, you will reset the slug for that mod.
configure sodium=modrinth carpet=curse Easily configure multiple mods at the same time.
configure carpet=modrinth,curse:fabric-carpet Configure different slugs for different sites.
list List all installed mods.

Full usage

positional arguments:
                        Install, update, configure, or list 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)

  -d DIR, --dir DIR     Location of the mods folder. By default it's the current directory
                        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

Planned features

  • Automatically install dependencies
  • GUI
  • Executable for Windows


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for minecraft-mod-manager, version 1.2.4
Filename, size File type Python version Upload date Hashes
Filename, size minecraft_mod_manager-1.2.4-py3-none-any.whl (52.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size minecraft-mod-manager-1.2.4.tar.gz (1.9 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page