mons


Namemons JSON
Version 2.0.0 PyPI version JSON
download
home_pagehttps://github.com/coloursofnoise/mons
SummaryA command-line mod installer and manager for Celeste
upload_time2023-08-23 22:39:04
maintainer
docs_urlNone
authorColoursOfNoise
requires_python>=3.8
license
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # MONS - CommandLine Celeste Mod Manager

[![PyPI](https://img.shields.io/pypi/v/mons.svg)](https://pypi.python.org/pypi/mons)
[![Documentation Status](https://readthedocs.org/projects/mons/badge/?version=latest)](https://mons.coloursofnoise.ca/en/latest/?badge=latest)
[![GameBanana](https://img.shields.io/static/v1?label=GameBanana&message=9963&color=yellow)](https://gamebanana.com/tools/9963)

<!-- sphinx start -->

`mons` is a commandline [Everest](https://everestapi.github.io/) installer and mod manager for [Celeste](http://www.celestegame.com/).

It was originally built for productivity when working on Everest, but can be used by players and developers alike.

**This program requires basic competency using the [commandline](https://en.wikipedia.org/wiki/Command-line_interface) for your operating system.** For a graphical installer, please use [Olympus](https://everestapi.github.io/#installing-everest) instead.

## Install:

### Arch Linux:

Install from the AUR: [`everest-mons`](https://aur.archlinux.org/packages/everest-mons)

### Using [pipx](https://pypa.github.io/pipx/) (recommended):

```console
$ pipx install mons
```

### Using pip:

```console
$ python3 -m pip install --user mons
```

## Usage:

At any time, add the `--help` flag to print usage information for the current command.

A copy of this documentation is hosted online at [mons.coloursofnoise.ca](https://mons.coloursofnoise.ca).

```console
$ mons --help
$ mons install --help
```

### Setup

The first step is to add a reference for your Celeste install. **For the purposes of this documentation, it will be assumed that the install is named `main`.**

```console
$ mons add main path/to/Celeste/install
```

Every command that operates on a Celeste install (pretty much everything except `list` and `config`) will require the install name as the first argument.

### Everest

Installing Everest can be done with a variety of options, including branch name (`stable`/`beta`/`dev`), build number (`3366`), or zip artifact (`--zip /path/to/zip/archive`).

Using the `--latest` flag will always install the most recent build available.

```console
$ mons install main stable
$ mons install main --latest
```

### Everest in an overlay filesystem (Linux only)

On Linux, an [Overlay Filesystem](https://www.kernel.org/doc/html/latest/filesystems/overlayfs.html) can be used to isolate any modifications made by an Everest. This allows multiple Everest installs to use the same base Celeste files, and also makes uninstalling Everest much more reliable.

Use the `--overlay` option when adding an Everest install to assign it to an overlay filesystem:

```console
$ mons add main path/to/Everest/install --overlay path/to/Celeste/install
```

Since mounting a filesystem requires elevated privileges, it is recommended to add it to `/etc/fstab` or use [User Namespaces](<https://en.wikipedia.org/wiki/Linux_namespaces#User_ID_(user)>) to avoid the need to enter the root password every time.

### Everest from source

`mons` was created with Everest development in mind, and tries to make the process as streamlined as possible. Passing the `--src` option with the path to a copy of the Everest repo to `mons install` will, by default:

1. Run `dotnet build` or `msbuild` in the project folder.
2. Copy updated build artifacts from the build output into the Celeste install folder.
3. Run `miniinstaller.exe` to install Everest from the build artifacts.

On GNU/Linux and macOS, `mons` will use the [MonoKickstart](https://github.com/flibitijibibo/MonoKickstart) executable bundled with Celeste to run `miniinstaller`, so a system install of [mono](https://www.mono-project.com/) is not required.

```console
$ mons install main --src /path/to/Everest/repo --launch
```

### Mods

`mons` supports Celeste mods that have been posted on [GameBanana](https://gamebanana.com/games/6460), but can also attempt to install from local or remote zip files, including Google Drive share links.

Dependencies will be automatically resolved where possible, and missing dependencies can be resolved at any point using `mons mods resolve`.

The `--search` option when adding mods uses the [GameBanana Search API](https://github.com/max4805/RandomStuffWebsite/blob/main/README.md#gamebanana-search-api) to provide a list of possible matches to install.

```console
$ mons mods add main SpringCollab2022
$ mons mods add main https://gamebanana.com/mods/53697 # Communal Helper
$ mons mods add main --search Helper
$ mons mods update main
$ mons mods remove --recurse SpringCollab2022
```

<!-- sphinx end -->

---

**[Everest Website](https://everestapi.github.io/)**

For general feedback and questions ping `@coloursofnoise` on the Celeste Community Discord:

<a href="https://discord.gg/celeste"><img alt="Mt. Celeste Climbing Association" src="https://discordapp.com/api/guilds/403698615446536203/embed.png?style=banner2" /></a>

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/coloursofnoise/mons",
    "name": "mons",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "",
    "author": "ColoursOfNoise",
    "author_email": "coloursofthenoise@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/26/d3/73eee4a5e1ed64a5b442b47a08e3c990b771d1807d42eaf2f864ed15f3a5/mons-2.0.0.tar.gz",
    "platform": null,
    "description": "# MONS - CommandLine Celeste Mod Manager\n\n[![PyPI](https://img.shields.io/pypi/v/mons.svg)](https://pypi.python.org/pypi/mons)\n[![Documentation Status](https://readthedocs.org/projects/mons/badge/?version=latest)](https://mons.coloursofnoise.ca/en/latest/?badge=latest)\n[![GameBanana](https://img.shields.io/static/v1?label=GameBanana&message=9963&color=yellow)](https://gamebanana.com/tools/9963)\n\n<!-- sphinx start -->\n\n`mons` is a commandline [Everest](https://everestapi.github.io/) installer and mod manager for [Celeste](http://www.celestegame.com/).\n\nIt was originally built for productivity when working on Everest, but can be used by players and developers alike.\n\n**This program requires basic competency using the [commandline](https://en.wikipedia.org/wiki/Command-line_interface) for your operating system.** For a graphical installer, please use [Olympus](https://everestapi.github.io/#installing-everest) instead.\n\n## Install:\n\n### Arch Linux:\n\nInstall from the AUR: [`everest-mons`](https://aur.archlinux.org/packages/everest-mons)\n\n### Using [pipx](https://pypa.github.io/pipx/) (recommended):\n\n```console\n$ pipx install mons\n```\n\n### Using pip:\n\n```console\n$ python3 -m pip install --user mons\n```\n\n## Usage:\n\nAt any time, add the `--help` flag to print usage information for the current command.\n\nA copy of this documentation is hosted online at [mons.coloursofnoise.ca](https://mons.coloursofnoise.ca).\n\n```console\n$ mons --help\n$ mons install --help\n```\n\n### Setup\n\nThe first step is to add a reference for your Celeste install. **For the purposes of this documentation, it will be assumed that the install is named `main`.**\n\n```console\n$ mons add main path/to/Celeste/install\n```\n\nEvery command that operates on a Celeste install (pretty much everything except `list` and `config`) will require the install name as the first argument.\n\n### Everest\n\nInstalling Everest can be done with a variety of options, including branch name (`stable`/`beta`/`dev`), build number (`3366`), or zip artifact (`--zip /path/to/zip/archive`).\n\nUsing the `--latest` flag will always install the most recent build available.\n\n```console\n$ mons install main stable\n$ mons install main --latest\n```\n\n### Everest in an overlay filesystem (Linux only)\n\nOn Linux, an [Overlay Filesystem](https://www.kernel.org/doc/html/latest/filesystems/overlayfs.html) can be used to isolate any modifications made by an Everest. This allows multiple Everest installs to use the same base Celeste files, and also makes uninstalling Everest much more reliable.\n\nUse the `--overlay` option when adding an Everest install to assign it to an overlay filesystem:\n\n```console\n$ mons add main path/to/Everest/install --overlay path/to/Celeste/install\n```\n\nSince mounting a filesystem requires elevated privileges, it is recommended to add it to `/etc/fstab` or use [User Namespaces](<https://en.wikipedia.org/wiki/Linux_namespaces#User_ID_(user)>) to avoid the need to enter the root password every time.\n\n### Everest from source\n\n`mons` was created with Everest development in mind, and tries to make the process as streamlined as possible. Passing the `--src` option with the path to a copy of the Everest repo to `mons install` will, by default:\n\n1. Run `dotnet build` or `msbuild` in the project folder.\n2. Copy updated build artifacts from the build output into the Celeste install folder.\n3. Run `miniinstaller.exe` to install Everest from the build artifacts.\n\nOn GNU/Linux and macOS, `mons` will use the [MonoKickstart](https://github.com/flibitijibibo/MonoKickstart) executable bundled with Celeste to run `miniinstaller`, so a system install of [mono](https://www.mono-project.com/) is not required.\n\n```console\n$ mons install main --src /path/to/Everest/repo --launch\n```\n\n### Mods\n\n`mons` supports Celeste mods that have been posted on [GameBanana](https://gamebanana.com/games/6460), but can also attempt to install from local or remote zip files, including Google Drive share links.\n\nDependencies will be automatically resolved where possible, and missing dependencies can be resolved at any point using `mons mods resolve`.\n\nThe `--search` option when adding mods uses the [GameBanana Search API](https://github.com/max4805/RandomStuffWebsite/blob/main/README.md#gamebanana-search-api) to provide a list of possible matches to install.\n\n```console\n$ mons mods add main SpringCollab2022\n$ mons mods add main https://gamebanana.com/mods/53697 # Communal Helper\n$ mons mods add main --search Helper\n$ mons mods update main\n$ mons mods remove --recurse SpringCollab2022\n```\n\n<!-- sphinx end -->\n\n---\n\n**[Everest Website](https://everestapi.github.io/)**\n\nFor general feedback and questions ping `@coloursofnoise` on the Celeste Community Discord:\n\n<a href=\"https://discord.gg/celeste\"><img alt=\"Mt. Celeste Climbing Association\" src=\"https://discordapp.com/api/guilds/403698615446536203/embed.png?style=banner2\" /></a>\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A command-line mod installer and manager for Celeste",
    "version": "2.0.0",
    "project_urls": {
        "Documentation": "https://mons.coloursofnoise.ca",
        "Homepage": "https://github.com/coloursofnoise/mons"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9dc816b67d3fa2d6927100ef883e35afff52b69e461ff526c4489aaa6a7b5a59",
                "md5": "c4b2eb8278e57648d5d564d95e190ce9",
                "sha256": "b541992bb2ac75ec991e92e52c2dd00b76fa036db67b40e28e23afd74deca763"
            },
            "downloads": -1,
            "filename": "mons-2.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c4b2eb8278e57648d5d564d95e190ce9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 66921,
            "upload_time": "2023-08-23T22:39:01",
            "upload_time_iso_8601": "2023-08-23T22:39:01.212030Z",
            "url": "https://files.pythonhosted.org/packages/9d/c8/16b67d3fa2d6927100ef883e35afff52b69e461ff526c4489aaa6a7b5a59/mons-2.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "26d373eee4a5e1ed64a5b442b47a08e3c990b771d1807d42eaf2f864ed15f3a5",
                "md5": "cbf58a835e782af149bb05302153e012",
                "sha256": "135c814f06784f60b7b17a0b1b3d2401cbdab34abcb4ee806a2cf7487ad3e191"
            },
            "downloads": -1,
            "filename": "mons-2.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "cbf58a835e782af149bb05302153e012",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 86973,
            "upload_time": "2023-08-23T22:39:04",
            "upload_time_iso_8601": "2023-08-23T22:39:04.331566Z",
            "url": "https://files.pythonhosted.org/packages/26/d3/73eee4a5e1ed64a5b442b47a08e3c990b771d1807d42eaf2f864ed15f3a5/mons-2.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-23 22:39:04",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "coloursofnoise",
    "github_project": "mons",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "mons"
}
        
Elapsed time: 0.10875s