# horizr CLI
![npm](https://img.shields.io/npm/v/@horizr/cli?color=white&label=latest%20version&logoColor=red&style=flat-square)

> A CLI tool for creating and maintaining Minecraft modpacks using the Fabric loader.

🎉 Features:
- Access [Modrinth](https://modrinth.com/)
  - Search
  - Add mods by ID or slug
  - View available versions
  - View dependencies
- Check for updates and view changelogs before applying them
- Export the pack to the [Modrinth format (`.mrpack`)](https://docs.modrinth.com/docs/modpacks/format_definition/)
- Export the pack to the [`packwiz`](https://packwiz.infra.link/) format
- HTTP-serve the `packwiz` export for usage with [`packwiz-installer`](https://packwiz.infra.link/tutorials/installing/packwiz-installer/)

## Usage

Because both [pkg](https://github.com/vercel/pkg) and [nexe](https://github.com/nexe/nexe) don’t support ES modules at the time of writing,
I can‘t publish executable files.

The only way of installing is therefore `npm`.

```sh
$ npm i -g @horizr/cli
```

Run any command with the `-h` flag to see the available options.

A new pack can be initialized using `horizr init <path>`.

## Examples

- Activate the latest (compatible) version of [Charm](https://modrinth.com/mod/charm)
```sh
$ horizr modrinth mod activate charm

# or short:
$ horizr mr mod a charm
```

- Activate `v4.1.1` of [Charm](https://modrinth.com/mod/charm)
```sh
$ horizr modrinth mod versions charm

# `BT9G1Jjs` is the version code you are looking for.
# This output will be colored in your console.
BT9G1Jjs 4.2.0+1.18.2 (↓ 137)
featured

Name: [1.18.2] 4.2.0
Channel: release
Minecraft versions: 1.18.2

Publication: last week

https://modrinth.com/mod/pOQTcQmj/version/BT9G1Jjs

# … more versions omitted for brevity

$ horizr modrinth version activate BT9G1Jjs

Charm (4.2.0+1.18.2) was successfully activated.


Dependencies
◉ Fabric API (P7dR8mSH): any version

```

- Check for updates
```sh
$ horizr update
# Because Sodium's version string is not a valid SemVer,
# the publication date will instead be used for comparison.
❯ Sodium has no valid semantic version: mc1.18.2-0.4.1. The
publication date will instead be used.

Available updates
- charm Charm: 4.1.0+1.18.2 → 4.2.0+1.18.2
```

```sh
$ horizr update charm

Changelog for 4.2.0+1.18.2

* Added ebony wood.
* Fixed issue with Totems not always spawning or being
carried away by mobs.
# … omitted for brevity

Apply the update? [Y/n] y

Successfully updated Charm to 4.2.0+1.18.2.
```