Skip to content

Frank1o3/ModForge-CLI

Repository files navigation

ModForge-CLI ⛏

Python 3.13+ MIT License Modrinth API v2

ModForge-CLI is a powerful CLI tool for building and managing custom Minecraft modpacks using the Modrinth API v2.

Search for projects, fetch versions, validate manifests, download mods with hash checks, and generate complete files — all from the terminal.

Ideal for modpack developers, server admins, and automation scripts.

Terminal Banner

When you run ModForge-CLI, you'll be greeted with this colorful Minecraft-themed banner

Key Features

  • Modrinth API v2 Integration: Search projects, list versions, fetch metadata in bulk.
  • Modpack Management: Read/validate modrinth.index.json, build packs from metadata.
  • Validation: Full JSON Schema checks + optional Pydantic models for strict typing.

Installation

Requires Python 3.13+.

Recommended (Poetry):

poetry install

Alternative (pip):

pip install -r requirements.txt