Skip to content
forked from jakobkmar/pacmc

An easy to use package manager (and soon to be launcher) for Minecraft mods.

License

Notifications You must be signed in to change notification settings

ag-kotlin/pacmc

 
 

Repository files navigation

pacmc

pacmc is a package manager for Fabric Minecraft mods.

The aim of this project is to massively reduce the effort you have to put in to installing - and most importantly - keeping your mods up to date.

The current version of pacmc is already pretty useful and works, however keep an eye on this project, as it will receive major new features and improvements in the near future!

To install pacmc, visit the Installation section.

Chat and ask questions on Matrix (or Discord)

I am currently rewriting pacmc to use the Modrinth v2 API as well as the new Curseforge API. Until then, you might experience issues while pacmc is still using the old APIs of these two platforms.

The rewrite will also introduce some major improvements and new features, so stay tuned!

Contributions for the following things will be very welcome:

  • an icon for pacmc
  • an OpenGL 3D skin renderer

Usage

The main command is pacmc. You can add -h to any command to get help.

Command overview

Commands:
  install  Installs a minecraft mod
  update   Updates the mods inside an archive
  search   Searches for mods
  list     Lists the installed mods
  remove   Removes a minecraft mod
  archive  Manages your mod archives
  init     Sets the pacmc defaults
  refresh  Refreshes the local mod files according to the database
  load     Loads one archive into another
  info     Displays the formatted project description
  debug    Prints debug information

Quick start (for installing mods)

# add the .minecraft folder as an archive
pacmc init
# search for mods
pacmc search minihud
# install a mod
pacmc install lithium

Archives

Archives are the places (folders) where your mods are stored. Your .minecraft folder is an archive by default, but you can add more (for example to manage mods on a server, which pacmc is designed for aswell).

Init the default archive

To add the .minecraft folder as an archive:

pacmc init

Add an archive

pacmc archive add myarchive [./path/to/my/archive]

List all existing archives

pacmc archive list

Remove an archive

pacmc archive remove myarchive

Search for mods

pacmc search sodium
# or
pacmc search "Fabric API"

this searches for mods for the latest minecraft version by default

For a specific game version:

pacmc search -g 1.15.2 "Fabric API"

or version independent:

pacmc search -i "minimap"

Install a mod

# via the mod id
pacmc install 447425
# or via a search term
pacmc install tweakeroo

or to a specific archive:

pacmc install -a myarchive 447425

when installing using a search term, you may be prompted to select a mod from a couple of options

Installation

Platform Instructions Location Package Manager
Arch Linux and Manjaro install using an AUR helper
e.g. paru pacmc
pacmc in AUR any AUR helper
macOS and Linux brew install pacmc coming soon Homebrew
Linux flatpak install net.axay.pacmc coming soon Flatpak
Windows (scoop bucket add games)
scoop install pacmc
pacmc in scoop-games scoop
Windows winget install pacmc coming soon winget
Windows (gui only) Install pacmc from the Microsoft Store coming soon Microsoft Store

Other

If the installation methods above don't fit your needs, you can also install pacmc manually. Keep in mind though, that this way pacmc won't receive updates automatically.

Download one of the released archives from the releases page. Extract the archive. Inside there will be a bin directory. Run the shell script using ./pacmc.

About

An easy to use package manager (and soon to be launcher) for Minecraft mods.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 99.6%
  • Shell 0.4%