cursely

Cross-platform mod management for Minecraft.

pip install cursely

Get search results from CurseForge and Modrinth.

View mod details, dependencies and download links.

Deploy a modpack with its configuration.

Usage

cursely [MOD_ID]    Get a brief description of a mod and its download link.
cursely [KEYWORD]   Search for a mod by its name or author.
cursely [MODPACK]   Install all listed mods and their dependencies.
cursely --help      Show this help message.

Modpacks

A modpack file is a plain text file with the .mods extension and the following format:

example_modpack.mods

game minecraft == 1.20.1
loader fabric == 0.15.1
config example_modpack_config.zip

#    Mod ID  Comments (optional)  File version (optional)
mod  325471  Inventory Sorting    == 5455951
mod  429084  Limited Spawners
mod  551140  Furnace Recycle

#         Download URL                     Mod (optional)
download  https://manual_mod_download_url
download  https://manual_mod_download_url  for mod 917292

# ...

Running cursely example_modpack.mods will:

1. Download and install the listed mods.
2. Download and install their required dependencies.
3. Copy the config files from the zip archive to the minecraft installation folder.
4. Print any errors that might have occurred.

You can find examples for modpacks in cursely/modpacks/.

Resolution files

Resolution files contain all the mods and their dependencies for a modpack, fixed to the specific versions downloaded by the installer when the build was created. This enables reproducible builds, providing the option to replicate the exact same modpack in the future, preventing the incompatibilities that can arise as mods get updated and their versions change over time.

When installing a modpack:

• If no resolution file exists, a new one will be created with the same name and the .resolved-mods extension.

• If a resolution file exists, the program will try to use it as long as it has the same name as the requested modpack (except for the extension).

To build a modpack using the latest compatible version of each mod, simply delete the resolution file and rerun cursely your_modpack.mods.

Disclaimer

Modrinth and CurseForge are registered trademarks owned by their respective owners. Any references to these brands within this repository are for descriptive purposes only and do not imply endorsement or affiliation with said trademarks.