Skip to main content

Minecraft ModPack CLI

Enhance your ModPack creation with a simple CLI tool

license stars downloads open issues

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.

📑 Table of Contents

💙 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

⬇️ 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

🚀 Quick start

🔧 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.

📝 Working On

Currently working on version 0.5.0

Already Planned releases

VERSION INCLUDES
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.

📂 Kown Issues

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

📜 License

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

💸 Sponsorship

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

Metadata

Release files for MinecraftModpackCLI 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for MinecraftModpackCLI 0.5.2
File Size Uploaded Provenance Actions
minecraftmodpackcli-0.5.2.tar.gz 28.0 kB With provenance Details for minecraftmodpackcli-0.5.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for MinecraftModpackCLI 0.5.2
File Interpreter ABI Platform Actions
minecraftmodpackcli-0.5.2-py3-none-any.whl Python 3 none any Details for minecraftmodpackcli-0.5.2-py3-none-any.whl

Total release size: 63.4 kB

Release files / minecraftmodpackcli-0.5.2.tar.gz

Download URL minecraftmodpackcli-0.5.2.tar.gz
Size 28.0 kB
Tags Source
SHA-256 checksum
How to use checksums
402aede77b0ed3882202b967964c1d3346894eb3204986385dea4e9ee7d6ef0d
BLAKE2b-256 checksum
How to use checksums
d15b32777c6c8af591aa68172924905e85bac4c40f094d81235803f7c2af5c31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 18, 2026.

Transparency log

Release files / minecraftmodpackcli-0.5.2-py3-none-any.whl

Download URL minecraftmodpackcli-0.5.2-py3-none-any.whl
Size 35.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
626c8405794d9978f72793be605f8d373ef2425a7ad1ea53c9a769fc832ec1d7
BLAKE2b-256 checksum
How to use checksums
f13f1e4c692475e0ed6656fb7412a771f02adb2e669851040c778cbe78554170
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 18, 2026.

Transparency log

Security for MinecraftModpackCLI 0.5.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for minecraftmodpackcli-0.5.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page