A CLI tool for creating and managing Minecraft Modpacks, similar to packwiz but with seamless integration with the Curseforge API.
- Easy modpack initialization with guided prompts
- Search for mods on Curseforge
- Add mods to your modpack from Curseforge
- Import existing CurseForge modpacks
- Build modpacks in different formats:
- MultiMC
- CurseForge
- Modrinth
git clone https://github.com/r4ai/minepack.git
cd minepack
cargo install --path .Minepack requires a Curseforge API key to function. You can obtain one by:
- Creating an account on Curseforge
- Accessing the API portal
- Creating a new API key
Once you have your API key, set it as an environment variable:
export CURSEFORGE_API_KEY="your_key_here"For persistent usage, add this to your shell profile file.
minepack init [--name NAME] [--version VERSION] [--author AUTHOR] [--description DESCRIPTION] [--loader LOADER] [--minecraft-version VERSION] [--loader-version VERSION]This will guide you 812C through creating a new modpack. You can provide the following options directly:
--name: Name of the modpack--version: Version of the modpack--author: Author of the modpack--description: Description of the modpack--loader: Mod loader to use (forge, fabric, quilt, neoforge)--minecraft-version: Minecraft version--loader-version: Mod loader version
If options are not provided, you will be prompted to enter them interactively.
minepack import PATH [--yes, -y]Import an existing CurseForge modpack from a zip file:
PATH: Path to the CurseForge modpack zip file--yes, -y: Skip confirmation prompts
Example:
minepack import ~/Downloads/my-curseforge-modpack.zipThis will extract the CurseForge modpack zip file, read its manifest.json to get modpack metadata, download all mods, and set up your local modpack structure.
minepack search <QUERY>Example:
minepack search jeiThis will display information about mods matching your query, including ID, name, download count, and summary.
minepack add [MOD] [--yes, -y]Example:
minepack add https://www.curseforge.com/minecraft/mc-mods/oritech/files/6332315
minepack add https://www.curseforge.com/minecraft/mc-mods/oritech
# with automatic confirmation
minepack add https://www.curseforge.com/minecraft/mc-mods/oritech/files/6332315 --yesThe --yes flag will skip confirmation prompts.
minepack build [--format FORMAT]This will build your modpack into the specified format:
--format multimc: For direct import into MultiMC launcher (.zip)--format curseforge: For upload to Curseforge or use with CurseForge/Overwolf launchers (.zip)--format modrinth: For use with Modrinth compatible launchers (.mrpack)
If no format is specified, you will be prompted to choose one.
A typical minepack project will have the following structure:
my-modpack/
├── minepack.json # Modpack configuration file
├── mods/ # Where mod files are stored
│ └── *.ex.json # Information about the mod to be installed
└── config/ # Optional configuration files for mods
Before submitting changes, run the following commands to ensure quality:
mise tasks run format-write # Format code
mise tasks run lint # Run linters
mise tasks run test # Run tests
mise tasks run build # Build projectMIT