#minecraft-server #version #command #download #install #java #binary

app mcvcli

A command line interface for managing Minecraft servers

3 stable releases

new 2.0.2 Feb 11, 2025

#18 in Games

39 downloads per month

MIT license

125KB
3.5K SLoC

mcvcli - Minecraft Server Version Manager

mcvcli is a command-line tool for managing Minecraft server versions. It allows you to easily download, install, and switch between different versions of the Minecraft server software.

Features

  • Download and install Minecraft server versions with a single command
  • List available server versions
  • Switch between installed server versions
  • Automatically handle java installation

Installation

Using Cargo

  1. Make sure you have Cargo installed.
  2. Install mcvcli globally by running the following command:
cargo install mcvcli

Using a Pre-built Binary

  1. Download the latest release from the releases page.
  2. Extract the downloaded archive.
  3. Add the extracted directory to your PATH (or put it in a folder that is already in PATH).
  4. Run mcvcli in your terminal to verify that the installation was successful.
# Basic Example for Linux
wget https://github.com/mcjars/mcvcli/releases/latest/download/mcvcli-x86_64-linux.tar.xz
tar -xf mcvcli-x86_64-linux.tar.xz -C .
export PATH=$PATH:$(pwd)/mcvcli-x86_64-linux

mcvcli --version
# Basic Example for Windows

Invoke-WebRequest -Uri "https://github.com/mcjars/mcvcli/releases/latest/download/mcvcli-x86_64-windows.zip" -OutFile "mcvcli-x86_64-windows.zip"
Expand-Archive -Path "mcvcli-x86_64-windows.zip" -DestinationPath "."
$env:Path += ";$(Get-Location)\mcvcli-86_64-windows"

mcvcli --version

Usage

Downloading and Installing a Server Version

To setup your Minecraft server version, use the init command

mcvcli init ./server

cd server

mcvcli version # view installed version, auto updates with your jar
mcvcli update # update build or minecraft version of your jar (only newer)
mcvcli install # force install any other version
mcvcli lookup {user} # lookup a user on your server or globally
mcvcli start # start the server
mcvcli profile list # list server profiles
mcvcli profile create {name} # create a new profile
mcvcli profile use {name} # switch to another profile
mcvcli profile delete {name} # nuke a profile from existance
mcvcli backup list # list created server backups
mcvcli backup create # create a new server backup
mcvcli backup delete # delete a server backup
mcvcli backup restore # restore a previously created server backup

Developing

To Develop on this tool, you need to install all required dependencies

git clone https://github.com/mcjars/mcvcli.git mcjars-mcvcli

cd mcjars-mcvcli

# make sure to have cargo installed already
cargo build

# install binary globally
cargo install --path .

# run the binary temporarily
cargo run -- --version

[!NOTE] NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

Dependencies

~19–33MB
~519K SLoC