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

app mcvcli

A command line interface for managing Minecraft servers

10 stable releases

new 2.1.4 Feb 13, 2025
2.1.0 Feb 12, 2025
2.0.4 Feb 12, 2025
2.0.2 Feb 11, 2025

#5 in Games

Download history 1087/week @ 2025-02-10

1,087 downloads per month

MIT license

160KB
4.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 "." -Force
$env:Path += ";$(Get-Location)\mcvcli-x86_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 {name} # create a new server backup
mcvcli backup delete {name} # delete a server backup
mcvcli backup restore {name} # restore a previously created server backup

mcvcli start --detached # start the server in the background (no output)
mcvcli attach # attach to the server console
mcvcli stop # stop the server
mcvcli status # check the server status

mcvcli upgrade # upgrade the mcvcli binary

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

~24–56MB
~900K SLoC