A package manager-like utility for installing, upgrading and migrating mods on Fabric Minecraft servers
Go to file
Nex 518398d626
Add a shebang to the executable script for shell compatibility
2024-04-17 16:55:09 +02:00
src Use regex to ensure package version is from master, and is for the correct MC version 2024-04-14 17:41:53 +01:00
.gitignore Ensure script is ran with sudo 2022-08-09 17:55:41 +01:00
README.md Update install script 2024-04-06 19:51:31 +01:00
install.sh Add a shebang to the executable script for shell compatibility 2024-04-17 16:55:09 +02:00
package-lock.json Add properties parser 2024-04-06 15:27:53 +01:00
package.json Add properties parser 2024-04-06 15:27:53 +01:00
tsconfig.json Update build directory for Typescript Compiler 2022-08-09 16:57:56 +01:00


Mod Manager TypeScript NodeJS Shell Script

A package manager-like CLI utility for managing installing, updating and migrating mods on Fabric Minecraft Servers.


  • Installing mods from Modrinth and Curseforge
  • Uninstalling mods
  • Updating mods with a single command
  • Migrating mods to a new Minecraft version


A terminal window showing the usage of mod-manager


$ mod-manager
Usage: mod-manager [options] [command]

A package (mod) manager for Fabric Minecraft Servers

  -v, --version                         Reports the version of the Minecraft server
  -h, --help                            display help for command

  init                                  Initialises mod manager
  install [options] <mods...>           Installs the provided mods
  list                                  Lists installed mods
  uninstall <mods...>                   Uninstalls the provided mods
  essential <mods...>                   Toggles the mods essential statuses
  update                                Checks for and updates mods that have a newer available version
  migrate-possible [options] [version]  Reports whether it is possible to upgrade to the provided Minecraft version
  migrate [options] [version]           Migrates all mods to provided Minecraft version
  help [command]                        display help for command

Initialising Mod Manager:

$ mod-manager init
? What Minecraft version is your server running? 1.19.1
Sucessfully initialised Mod Manager!

Installing a mod:

$ mod-manager install lithium
✔ Successfully installed Lithium

Listing installed mods:

$ mod-manager list
Name    | Id       | File Name                         | Version        | Source   | Essential | Dependencies
Lithium | gvQqBUqZ | lithium-fabric-mc1.19.2-0.8.3.jar | mc1.19.2-0.8.3 | Modrinth | false     |

Environment Variables

The following are the required environment variables for running Mod Manager

CURSEFORGE_API_KEY # Set to your api key for curseforge. Leaving it unset will skip all Curseforge related functionality



  • A version of Node.js greater than 12 must be installed, along with npm and npx.

Mod Manager can be installed with the following command (watch out for the sudo password prompt, it can be hard to spot)

curl https://git.bits.team/Bits/mod-manager/raw/branch/master/install.sh | sudo -E env "PATH=$PATH" bash