ModMatch

This script checks a Minecraft mod list for mods compatible with a specific game version on CurseForge and Modrinth, and can optionally download them. API keys for CurseForge and Modrinth are required for it to work properly.

Cloning

You can clone the repository in two ways:

1. Click Code → Download ZIP.
2. Or use Git: git clone https://github.com/Meolsei/ModMatch

Usage

Exporting Your Modlist

This example uses Prism Launcher:

1. Select your instance and click Edit.
2. Go to the Mods tab.
3. Click Export modlist (don’t export yet).
4. In the top-right dropdown above Optional Info, select JSON.
5. Under Optional Info, select URL (required for the script).
6. Click Save and name the file modlist.json.

Running the Script

1. Install Python:
   • Debian-based: sudo apt-get install python3.14
   • Redhat-based: sudo dnf install python3.14
2. Open a terminal and navigate to the ModMatch folder: cd ModMatch
3. Install dependencies: pip install -r requirements.txt
4. Place your modlist.json in the same folder as main.py
5. Ensure you have your CurseForge and Modrinth API keys set in the script or environment variables.
6. Run the script: python main.py