Skip to content

minepkg/minepkg

Repository files navigation

minepkg

minepkg is a package manager designed to install Minecraft mods and modpacks.


main builds Maintainability Discord

Features

  • Installs mods from minepkg (with dependency resolution)
  • Can launch Minecraft
  • Join compatible modded Servers with one command (Installs modpack and launches Minecraft & joins the server for you)
  • Saves your installed mods in a sharable minepkg.toml
    • minepkg.toml modpacks can extend other modpacks
  • Publish mods and modpacks to minepkg.io

Installation

You can read the installation docs here for more detailed instructions.

Linux & MacOS

Run this in your favorite shell.

curl -s https://minepkg.io/install.sh | bash

Windows

Run this in powershell

. { iwr -useb https://minepkg.io/install.ps1} | iex

From Source

If you have the go toolchain installed you can (compile &) install minepkg from source:

go install github.com/minepkg/minepkg@latest

Usage

$ minepkg --help
Manage Minecraft mods with ease

Usage:
  minepkg [command]

Examples:

  minepkg init -l fabric
  minepkg install modmenu@latest
  minepkg join demo.minepkg.host

Available Commands:
  bump                Bumps the version number of this package
  config              Manage global config options
  dev                 Advanced package dev related tasks (eg. build)
  help                Help about any command
  init                Creates a new mod or modpack in the current directory
  install             Installs one or more packages in your current modpack or mod
  join                Joins a compatible server without any setup
  launch              Launch the given or local modpack.
  publish             Publishes the local package in the current directory to minepkg.io
  remove              Removes supplied package from the current directory & package
  selfupdate          Updates minepkg to the latest version
  try                 Lets you try a mod or modpack in Minecraft
  update              Updates all installed dependencies
  update-requirements Updates installed requirements (minecraft & loader version)

Flags:
  -a, --accept-minecraft-eula   Accept Minecraft's eula. See https://www.minecraft.net/en-us/eula/
      --config string           config file (default is /home/fiws/.config/minepkg/config.toml)
  -h, --help                    help for minepkg
      --non-interactive         Do not prompt for anything (use defaults instead)
      --verbose                 More verbose logging. Not really implemented yet
  -v, --version                 version for minepkg

Use "minepkg [command] --help" for more information about a command.

Demo

minepkg install preview

Building

Requires go ~ 1.16+. Could also work with older go versions. Just go run main.go [commands] or go build -o out/minepkg

git clone https://github.com/minepkg/minepkg.git
cd minepkg
go run main.go --help