MinecraftModpackCLI 0.4.0

A tool to make easier creating and releasing modpacks

Minecraft ModPack CLI

Enhance your ModPack creation with a simple CLI tool

Minecraft ModPack CLI is a Python CLI to help you build, validate, and export Minecraft modpacks from a local mods folder. It uses Modrinth metadata to resolve dependencies, creates manifests, and can download missing mods when exporting or building.

:bookmark_tabs: Table of Contents

• Minecraft ModPack CLI
  • Enhance your ModPack creation with a simple CLI tool
  • :blue_heart: Main Features
  • :arrow_down: Installation
  • :rocket: Quick start
  • :wrench: Tips & Troubleshooting
  • :memo: Working On
  • :open_file_folder: Kown Issues
  • :scroll: License
  • :money_with_wings: Sponsorship

:blue_heart: Main Features

• Resolve Modrinth metadata from local mods
• Dependency resolution (including required libraries)
• Manifest generation for your modpack
• Export packs with auto-download of missing mods
• Validation against existing manifests
• Simple CLI UX with spinners and logging

:arrow_down: Installation

Prerequisites:

• Python 3.13+
• Internet access for Modrinth API

Recommended:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install minecraftmodpackcli

From source (Poetry):

git clone https://github.com/Dtar380/MinecraftModpackCLI.git
cd MinecraftModpackCLI
poetry install

[!NOTE] If using Poetry, run commands with: poetry run MinecraftDockerCLI

:rocket: Quick start

:wrench: Tips & Troubleshooting

• Ensure Docker Desktop is running and you can run docker ps without errors before invoking the CLI.
• On Windows, run PowerShell as Administrator or ensure your user has permissions for Docker.
• If data.json is missing, run builder create first to scaffold services.

:memo: Working On

Currently working on version 0.5.0

Already Planned releases

VERSION	INCLUDES
0.5.0	User Configurations (TOML format)
0.6.0	Add more commands and supported files
0.7.0	Allow custom mods
0.8.0	Improved code base
0.9.0	Implement tests
1.0.0	Bug Fix, docs and Release

Feel free to open Feature Requests at issues.

:open_file_folder: Kown Issues

There is no known issues on the project, you can submit yours to issues.

:scroll: License

This project is distributed under the MIT license. See the LICENSE.

:money_with_wings: Sponsorship

You can support me and the project with a donation to my Ko-Fi.