Skip to content

RozeFound/mmc-export

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MultiMC advanced exporter

PyPI pyversions PyPI version PyPI downloads GitHub license

Since MultiMC export features are very limited, I created a script that solves this problem, with this script you can export MultiMC pack to any popular format (e.g. curseforge, modrinth, packwiz). MultiMC forks which didn't changed export format much also supported, PolyMC support approved.

Features

  • Support conversion to:
    • CurseForge
    • Modrinth
    • packwiz
  • Detects downloadable resourcepacks and shaders
  • Supports github parsing¹
  • Loose modrinth search
  • User friendly toml config
  • Multiple output formats at once

GitHub rate limits

GitHub has limited requests per hour (up to 60), this means that if you have more than 60 mods, the rest will be excluded from github search. But, every launch you will be asked to authorize yourself with simple instructions to avoid the limit, once you authorize, it will store token in secure keyring and stop asking.

If you don't want to use github search by some reason, you can specify --exclude-providers GitHub as argument.

How to Use

mmc-export -i modpack.zip -c config.toml -f Modrinth packwiz -o converted_modpacks

It's recommended to fill config at least with basic info like name and version, some launchers can fail import if these values are empty.

Syntax:

mmc-export [-h] [-c CONFIG] -i INPUT -f FORMAT [-o OUTPUT] [--github-auth GITHUB_AUTH] [--modrinth-search SEARCH_TYPE] [--exclude-providers PROVIDERS] [--exclude-forbidden]

Explanation:

-h --help: prints help
-i --input: path to modpack, must be zip file exported from MultiMC.
-c --config: path to config, used to fill the gaps like description or losted mods.
-f --format: output formats, must be separated by spaces.
-o --output: directory where converted zip files will be stored.
--github-auth: GitHub Auth in format username:token
--modrinth-search: modrinth search accuracy
--exclude-providers: providers you wish to exclude from search
--exclude-forbidden: set to not ignore CF distribution flag. Must be enabled for public modpacks.

--format options (case-sensitive):

  • CurseForge
  • Modrinth
  • packwiz
  • Intermediate (only for debugging, may contain sensitive data like username)

--exclude-providers options (case-sensitive):

  • CurseForge
  • Modrinth
  • GitHub

--modrinth-search options:

  • exact - by hash (default)
  • accurate- by hash or slug
  • loose - by hash or long name

How to Install / Update

pip install -U mmc-export

About

Export MMC modpack to other modpack formats

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages