Minecraft Mod Updater

Download the latest compatible Minecraft mods from Modrinth and CurseForge with one command. No coding required: fill in a config file, paste mod links, run the script.

What you need

• Python 3.9+ installed
• Internet connection
• A CurseForge API key only if you want to download CurseForge mods

Quick start (all platforms)

1. Open a terminal in this folder (MinecraftModUpdater).
2. Create a virtual environment:
   • Windows: py -m venv .venv
   • macOS/Linux: python3 -m venv .venv
3. Activate it:
   • Windows: .venv\Scripts\activate
   • macOS/Linux: source .venv/bin/activate
4. Install requirements: pip install -r requirements.txt
5. Copy and edit config:
   • config.yaml is already provided. If missing, copy config.example.yaml to config.yaml.
   • Open config.yaml and set:
     • minecraft_version: e.g., 1.21.11
     • mod_loader: fabric, forge, quilt, etc. Leave blank to accept any.
     • output_folder: where downloaded .jar files should go.
     • curseforge_api_key: required for CurseForge mods (get one at https://console.curseforge.com/).
6. Add your mods: edit mods.txt and paste one project link per line. Examples:
   • Modrinth: https://modrinth.com/mod/sodium
   • Modrinth: https://modrinth.com/mod/fabric-api
   • CurseForge: https://www.curseforge.com/minecraft/mc-mods/just-enough-items-jei
   • CurseForge: https://www.curseforge.com/minecraft/mc-mods/xaeros-minimap
7. Run the updater: python update_mods.py
8. Find your updated mods inside the folder you set in output_folder (default: downloaded_mods). Upload those .jar files to your Minecraft client or server mods folder.

How it works

• Reads settings from config.yaml. If missing, it auto-creates it from config.example.yaml and asks you to fill it in.
• Reads mod links from mods.txt. If missing, it copies mods.example.txt for you to edit.
• Detects whether each link is Modrinth or CurseForge.
• Finds the latest file matching your minecraft_version and mod_loader.
• Downloads the file into output_folder, overwriting older copies with the same name.
• Prints a summary when finished.

Messages you might see

• [SUCCESS] Downloaded and saved the file.
• [NO COMPATIBLE VERSION] The mod has no release for your chosen Minecraft version (or loader).
• [SKIP] Something was missing (e.g., no CurseForge API key).
• [ERROR] A request or download failed; the script continues with other mods.

FAQ

• What if a mod doesn’t support my Minecraft version yet?
  You’ll see [NO COMPATIBLE VERSION]. Wait for the author to publish a compatible release or change minecraft_version to a supported one.
• What if my CurseForge API key is wrong or missing?
  CurseForge downloads will be skipped with a clear message. Update curseforge_api_key in config.yaml and run again.
• Can I use only Modrinth mods?
  Yes. Leave curseforge_api_key empty and put only Modrinth links in mods.txt.
• Where do I get a CurseForge API key?
  Create one at https://console.curseforge.com/ and paste it into config.yaml.
• How do I update mods again later?
  Just rerun python update_mods.py. It will overwrite files in the output folder with the newest compatible versions.

Notes

• Keep the virtual environment active when running the script so the required packages are available.
• If you change Minecraft version or loader, update both config.yaml and your mod list to ensure compatibility.