Skip to content

Senth/minecraft-mod-manager

Repository files navigation

mcman/mmm (minecraft-mod-manager)

python Latest PyPI version Total alerts Language grade: Python

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

News — Slow progress and an Alternative CLI (2022-08-02)

Hi everyone!

I have acquired a CurseForge API key, but still want to make it easy to install mods from CurseForge without applying for a key.

Maybe that's not possible, but I have some ideas at least for improving mcman. This includes downloading mods from CurseForge.

For now though, I can point you to an awesome and in my opinion, better alternative: ferium.

Cheers, Senth

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

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= Doesn't work, known bug! 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,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

Alternatives

GUI

CLI

Authors

About

Install and update mods from CurseForge and Modrinth through a CLI

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages