# Minecraft server launcher - utility
 
MCA is easy-to-use and allows you to run a Minecraft server with
just one short command in the background with the ability to
view the output with GNU Screen and run commands.

## Usage
```bash
mca [OPTION]... [NAME|JAR|DIR] [INPUT]...
```

## MCA examples

### Running `minecraft` server with 2048 megabytes max memory
```bash
mkdir -p ~/mca/myserver
cd ~/mca/myserver
# This link is taken from https://www.minecraft.net/en-us/download/server
wget https://piston-data.mojang.com/v1/objects/e6ec2f64e6080b9b5d9b471b291c33cc7f509733/server.jar
echo 'max_memory 2048M' >> ./.mcarc
mca
```

### Running `paper` server with Aikar flags
```bash
echo 'platform paper' >> ./.mcarc
mca
```

### Running `velocity` server with Aikar flags
```bash
echo 'platform velocity' >> ./.mcarc
mca
```

Also, the platform can be determined automatically based on the `.jar` name.
For example, the file name is `paper-1.21.5.jar`, since it starts with `paper`, 
the platform will be `paper` and there is no need to manually specify it in 
the `PLATFORM` variable.

## Installation

### From Zhira Debian repository

For Debian 12 Bookworm there are deb packages in the Zhira Debian repository.

#### Add the Zhira Debian repository
```bash
wget -qO- https://deb.zhira.net/debian/zhira-archive-keyring.gpg | gpg --dearmor | sudo tee /etc/apt/keyrings/zhira-archive-keyring.gpg > /dev/null
echo 'deb [arch=all signed-by=/etc/apt/keyrings/zhira-archive-keyring.gpg] https://deb.zhira.net/debian/ bookworm main' | sudo tee /etc/apt/sources.list.d/zhira.list > /dev/null
```

#### Update the package list
```bash
sudo apt update
```

#### Install `mca`
```bash
sudo apt install mca
```

### From sources

#### Clone the repository
```bash
git clone https://git.zhira.net/rozhur/mca
```

#### Install `mca` into `/usr/local/bin` directory
```bash
cd ./mca
sudo make PREFIX=/usr/local install
```