Modsmith Command line v0.1.1 modsmith-cli

Modsmith command line#

Modpacks from your terminal

Modsmith's command line finds, installs and updates modpacks, mods, resource packs and shaders from Modrinth and CurseForge, and adds them to the official Minecraft launcher.

Install it Quick start

1 · Install

Two commands, and you are set

uv brings the Python that Modsmith needs, so there is nothing else to install first.

  1. Install uv. In PowerShell:

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. Install Modsmith, in a new PowerShell window:

    uv tool install modsmith-cli

Upgrading, Tab completion and other ways to install are in the installation guide.

2 · Find

Search both platforms at once

Look for a modpack on Modrinth and CurseForge together. Each result shows the name to give the next command.

$ 
Modrinth
Name                          Use as                             Downloads
Fabulously Optimized          modrinth:fabulously-optimized          19.8M
Fabulously Optimized for PVP  modrinth:fabulously-optimized-pvp        544
Showing 2 of 73.
CurseForge
Name                  Use as                           Downloads
Fabulously Optimized  curseforge:fabulously-optimized       8.1M
NeoScaled             curseforge:neoscaled                   730
Showing 2 of 26.

3 · Play

From a name to a game

  1. Install the pack Modsmith shows what it will add, and asks. Then it installs Minecraft, the mod loader and the pack's files.
  2. Open the launcher The pack has its own installation, with its name and icon.
  3. Play Choose it and press Play. Your other installations stay as they were.
$ 
Install Fabulously Optimized 14.1.2 as survival
  + mods/BetterGrassify-1.8.7+fabric.26.2.jar
  + mods/cloth-config-26.2.155.jar
  + and 100 more
102 to add; 45.0 MB to download.
Minecraft 26.2 with Fabric 0.20.1, and an installation in the official
launcher.
Install it? [Y/n]: y
Installed Fabulously Optimized as survival. In the official launcher,
choose the Fabulously Optimized installation and play.
  • Fabulously OptimizedNewfabric-loader-0.20.1-26.2
  • Latest release26.3
  • Latest snapshot26.4-snapshot-7
Latest release26.3Fabulously Optimizedfabric-loader-0.20.1-26.2
Play

4 · Make it yours

The mods they need come and go with them

Add a mod, and the mods it needs come along. Remove it, and they go again, unless something else still needs them.

$ 
Add to survival
  + mods/mezz_config-26.2-fabric-0.6.10.jar
  + mods/jei-26.2-fabric-30.42.0.236.jar
    MezzConfig comes too, because a mod needs it
2 to add; 2.8 MB to download.
Add them? [Y/n]: y
Added to survival.
$ 
Remove from survival
  - mods/mezz_config-26.2-fabric-0.6.10.jar
  - mods/jei-26.2-fabric-30.42.0.236.jar
2 to remove.
Remove them? [Y/n]: y
Removed from survival.

5 · Keep it up to date

Updates that keep your changes

See what changed in the new release, and every file it touches. A file you edited is kept, marked with !, and a new Minecraft version moves the launcher installation with it.

$ 
What changed in 14.1.2 for 26.2
- Updated Fabric Loader to 0.20.1
Update Fabulously Optimized 13.6.0 to Fabulously Optimized 14.1.2
  + mods/BetterGrassify-1.8.7+fabric.26.2.jar
  + and 43 more
  ~ config/isxander-main-menu-credits.json
  ~ and 17 more
  - mods/BetterGrassify-1.8.7+fabric.26.1.2.jar
  - and 41 more
  ! config/modpack_defaults/options.txt
44 to add, 18 to update, 42 to remove, 1 of your changes kept; 35.8 MB to
download.
It moves from Minecraft 26.1.2 with Fabric 0.19.5 to Minecraft 26.2 with
Fabric 0.20.1.
Update them? [Y/n]: y
Updated survival.

6 · Bring your own

Take over what you made

Already set up an installation in the launcher by hand? Import it, and Modsmith recognises its mods, so they update like the rest.

$ 
Import My Fabric world as my-fabric-world: Minecraft 26.2 with Fabric
0.20.1, in D:\Games\my-fabric-world.
Import it? [Y/n]: y
  Sodium: mods/sodium-fabric-0.9.2+mc26.2.jar
  Sodium Extra: mods/sodium-extra-fabric-0.9.5+mc26.2.jar
  Entity Culling: mods/entityculling-fabric-1.11.3-mc26.2.jar
3 files can now be updated and removed like added ones.
my-fabric-world is now an instance.

Works with

Every major mod loader

Modsmith installs the loader a pack needs, or the version you choose.

Forge1.13.2 and later
NeoForge1.20.1 and later
Fabric1.14 and later
Quilt1.14.4 and later

Learn more

Where to go next

Building your own tool?

Everything the command line does comes from Modsmith's Python library.

Start with the command line Use the Python library