Cosmix

A dead simple CLI-based launcher for Cosmic Reach and Cosmic Quilt.

Installation

# From PyPI (recommended)
python3 -m pip install cosmix-launcher
# From source
git clone https://codeberg.org/emmathemartian/cosmix && cd cosmix
python3 -m pip install -r requirements.txt
python3 -m build
python3 -m pip install ./dist/*.whl

To makes sure it's installed, run cosmix version. You should see [info]: Cosmix <some version> in the console.

If the command is not found, make sure your ~/.local/bin/ is on your $PATH.

If you have any issues, see Troubleshooting.

Updating

python3 -m pip install --upgrade cosmix-launcher

Uninstallation

python3 -m pip uninstall cosmix-launcher
# If you also want to delete your instances, delete ~/.local/share/cosmix (or %APPDATA%\cosmix on Windows)

Troubleshooting

Arch Linux:

Arch Linux and its derivatives may complain with error: externally-managed-environment. To get around this, use the --user --break-system-packages options with pip install.

Obviously this has a chance of breaking something, but in my testing I have yet to have that happen. Though be aware and know that I am not responsible if you break your system.

Maven:

You may also need to install Maven. On Arch Linux this is just pacman -S maven.

Maven is used to download and resolve all of Cosmic Quilt's dependencies automatically. If you are a developer, you will probably have this downloaded already. You can check by running mvn -v in your terminal.

Dependencies

hjson tqdm requests crm1 Send2Trash click click-aliases java-manifest

To install and/or upgrade all of them at once, just run:

python3 -m pip install --upgrade hjson tqdm requests crm1 Send2Trash click click-aliases java-manifest

Usage

Usage: python -m src.cosmix [OPTIONS] COMMAND [ARGS]...
Options:
 -w, --work-dir TEXT Set a working directory for Cosmix.
 --help Show this message and exit.
Commands:
 add (new) Adds a new instance.
 add-crm1-mod Adds a jar mod via CRM-1.
 add-data-mod Adds a data mod.
 add-mod Adds a jar mod.
 debug Shows debug information.
 info Gets info about an instance.
 instances Shows all instances.
 launch Launches an instance.
 trash Trashes an instance.
 update Updates an existing instance.
 version Shows the current cosmix version.
 whereis Shows the path to an instance.

You can use cosmix [command] --help to get help about a specific command.

Examples

# Create an unmodded instance named `vanilla` on the latest CR version
cosmix new vanilla
# Create a Cosmic Quilt instance named `my-quilt` on the latest CR version with Cosmic Quilt 1.2.7
cosmix new my-quilt --quilt-version 1.2.7
# Create a vanilla instance named `old-version` on CR 0.0.1
cosmix new old-version -v 0.0.1
# Install the latest version of Flux API available on JoJoJux's autorepo to the instance `test`
cosmix add-crm1-mod test dev.crmodders.flux
# Update the `latest` instance to the latest available versions of Cosmic Reach and Cosmic Quilt
cosmix update latest -v latest -q latest

File Structure

Cosmix stores all of its data in your $XDG_DATA_HOME (typically ~/.local/share/) on Linux and %APPDATA% on Windows and in the cosmix folder.

This folder will contain the following extra folders:

cosmix/
 config.hjson - Configs for Cosmix
 deps/
 cosmic-reach/
 Contains JARs for each downloaded Cosmic Reach version.
 cosmic-quilt/
 Contains the JAR dependencies for each downloaded Cosmic Quilt version.
 instances/
 example-instance/
 config.hjson - Configs for the instance.
 deps/
 If the instance is modded, this folder is used to store extra dependencies for the classpath. Typically this will be unused.