packsmith 0.1.0

A CLI based minecraft mod pack creator/manager

Packsmith

Packsmith is a CLI tool for creating and managing Minecraft modpacks. It is designed to help you initialize a pack, add mods or other content, resolve dependencies from Modrinth, download the resolved files, and export a distributable modpack archive.

This project is a remake of ModForge-CLI, with a focus on a cleaner codebase and a more direct workflow for modern modpack creation.

What Packsmith does

Packsmith helps you:

• create a new modpack structure with the expected folders
• add mods, resourcepacks, and shaders to a pack manifest
• resolve Modrinth dependencies into a lockfile
• download the resolved files into the correct directories
• export a modpack as an .mrpack-style archive for distribution

Installation

You can install the project locally with:

pip install -e .

Or with uv:

uv sync

Basic workflow

1. Create a new pack:

packsmith init <pack-name> <game-version> <loader> <loader-version>

2. Add content to the pack:

packsmith add <name> mod

You can also use other project types such as resourcepack or shader.

3. Resolve dependencies:

packsmith resolve

4. Download the resolved files:

packsmith download

5. Export the pack:

packsmith export --client

or

packsmith export --server

by default it will export the pack with both server and client stuff

Project structure

When you initialize a pack, Packsmith creates a basic folder layout similar to this:

<pack-name>/
  meta.json
  lock.toml
  mods/
  overrides/
    config/
    resourcepacks/
    shaderpacks/

Notes

Packsmith is still being developed, and some features are still evolving. The current focus is on building a reliable workflow for modpack creation, dependency resolution, and export.

And i am planning on adding a command that takes in you minecraft version and loader and will give you back the latest most compatible loader for that version of the game

Mention

You can look at the test.sh file in the repos root the code in it makes a basic modpack and you can use it as reference