Skip to content

Update your local Minecraft mods from CurseForge or Modrinth

Notifications You must be signed in to change notification settings

WarningImHack3r/mc-mods-checker

Repository files navigation

mc-mods-checker

Updates your local Minecraft mods.

Demo
Demo of v1.0.1

Features

  • Scan your mods folder and find the matching CurseForge page for each mod
  • Check for mod updates for your current Minecraft version
  • Update your mods to the latest Minecraft version if any is available
  • Move your old mods to a backup folder (switching to a newer Minecraft version) or send them to the trash

Configuration

You will need a CurseForge API key to use this script with CurseForge. You can get one here. Simply create an account, give your organization a name and copy the key alongside the script in a file named .env.

# mc-mods-checker/.env
CURSEFORGE_API_KEY=your_key_here

If you don't provide an API key, the script will only work with Modrinth.

Usage

This script requires Python 3.11+.

$ git clone https://github.com/WarningImHack3r/mc-mods-checker
$ cd mc-mods-checker
$ pip install -r requirements.txt
$ python3 mods_checker.py

TODO

  • Change mod online detection mechanism to use current mod version instead of target version
  • Fetch changelogs
  • Only work with Modrinth if no API key is provided
  • Auto install Fabric option (with .jar version & java -jar fabric-installer.jar client -dir "/path/to/.minecraft")
  • Add auto self-update feature
  • Exit if no .minecraft or no mods folders exist
  • Check Fabric Installer version every time