mc

mc is a simple, stable command-line app for Minecraft mods.

Currently supported commands:

• mc init [--version <mcVersion>] [--loader <forge|fabric|neoforge>]
• mc mod search <mod-name>
• mc mod ls
• mc mod add <mod-slug-or-id>
• mc mod download [--dir <path>]
• mc mod rm <mod-slug>
• mc mod tree

Unsupported command groups (resource, modpack, shader, plugin) intentionally return a not-supported error for now.

Manifest

The CLI uses mc.toml in the current directory.

[project]
mc-version="1.20.1"
loader="forge"

[mods]
sodium="<version number>"
fabric-api="<version number>"

Usage

Initialize with defaults:

mc init

Initialize with explicit version/loader:

mc init --version 1.21.1 --loader fabric

Search mods only:

mc mod search sodium

Add a mod and required dependencies:

mc mod add sodium

Download jars listed in the manifest:

mc mod download

Download to a custom directory:

mc mod download --dir ./project/mods

Downloads are verified with Modrinth sha512 hashes. Existing files are rechecked and re-downloaded if hashes do not match.

List current manifest mods:

mc mod ls

Remove a mod from manifest:

mc mod rm sodium

By default rm is safe: it blocks removing a dependency that other installed mods still require.

Remove a mod and prune orphan dependencies:

mc mod rm sodium --prune

Force-remove even if dependents exist:

mc mod rm sodium --force

Show dependency tree:

mc mod tree

Dependency behavior

• Resolver is loader-aware and version-aware (uses manifest mc-version + loader).
• Required dependencies are added once (deduplicated DAG traversal).
• Incompatible exact dependency versions produce a hard error with conflict details.
• Manifest updates are atomic and only written after successful full resolution.
• Dependency graph cache is stored at .mc/graph-cache.json for faster rm and tree.