Skip to main content

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

Project description

minecraft-mod-manager

python Latest PyPI version Total alerts Language grade: Python

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

Features

  • Install mods with minecraft-mod-manager install mod_name
  • Update all mods with minecraft-mod-manager 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 & Requirements

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

Examples

Note! All examples start with minecraft-mod-manager, then comes the arguments.

Arguments Description
install jei Searches for jei on all sites (from Modrinth first). and installs the latest version.
install dynmap=dynmapforge Install dynmap with slug dynmapforge. Dynmap name on CurseForge is dynmapforge, even for fabric.
install dynmap=dynmapforge --mod-loader fabric Install fabric version of dynmap. Not necessary if you have other fabric mods installed.
install curse:sodium By default it searches for all sites, adding curse: in front only searches on CurseForge.
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 modrith:sodium Change the download site for a mod.
configure carpet=fabric-carpet Change site slug for a mod.
configure modrinth:sodium curse:carpet=carpet Easily configure multiple mods at the same time.
list List all installed mods.

Full usage

Install or update Minecraft mods from Curseforge.

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.
                        To specify the download site for the mod, put 'curse:' before the mod.
                        E.g. 'curse:litematica'
                        By default it searches all sites for the mod.
                        To configure an slug for the mod, use 'mod_name=SLUG'.
                        E.g. 'dynmap=dynmapforge' must be used to find dynmap on Curse.


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 massages
  --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

Authors

Project details


Download files

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

Source Distribution

minecraft-mod-manager-1.1.0.tar.gz (1.9 MB view hashes)

Uploaded Source

Built Distribution

minecraft_mod_manager-1.1.0-py3-none-any.whl (45.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page