MinecraftServerMANager

The best way to quicky spin spin up a Minecraft server

This project is a successor to start_papermc.sh specifically the v2.0.0 branch. The project grew out of the scope I envisioned at first, surprisingly quickly LOL, so I moved all my development here.

This project aims to support more Minecraft servers than just paper.

Features

Takes care of Java

• Checks for the correct Java version installed
• Enables you to download a download a portable Java version from Adoptium
  • The script downloads it to ~/.adoptium_java allowing you to use one Java downlaod across multiple server instances
  • It also allows you to use multiple Java versions allowing you to run multiple Minecraft servers requiring different Java versions

Simple setup

• To setup your server you only need to change some values in msman.cfg
  • If you're starting a server just for you and your friends you don't need to change anything apart from the version and memory usage
• Values like memory are easy to change without the need to undertand Java flags
• Asks you if you want to accept the eula so you don't need to mess around with eula.txt

Sane defaults

• Uses Aikar's flags

Protections

• Makes sure you really meant to update the Minecraft version

Self-update

• This script can self-update itself without the need for user intervention

Currently supported servers

• Paper
• Fabric

Dependencies

• jq
• awp
• curl

Most, if not all, of these should be already available on your system if you're running something like Ubuntu.

Precautions

Warning

It is important to note that this script manages the server's .jar file, including its name.

Any modifications made to the .jar file outside of this script can lead to undefined behavior and may cause the script to crash or perform unexpected actions.

I strongly advise against making any modifications to the server's .jar file manually, as it may interfere with the functionality of this script.

Basic setup

• Option 1: Oneliner

curl -sSL "https://raw.githubusercontent.com/jiriks74/msman.sh/main/msman.sh" -o msman.sh && chmod +x msman.sh && ./msman.sh

• Option 2: Download msman.sh from release to where you want your minecraft server and start it with

chmod +x msman.sh
./msman.sh

• Option 2: Clone the repository

git clone https://github.com/jiriks74/msman.sh minecraft_server
cd minecraft_server
chmod +x msman.sh
./msman.sh

Updating the server

Builds

This script can automatically update to the latest papermc build available for the Minecraft version you selected. If you want this behaviour, leave the select_build veriable empty. Otherwise select the build you want and the script will download it for you.

Default JVM flags used

By default this script uses Aikar's flags. It's set up so that it automatically modifies them if over 12GB of memory is set for the server so you shouldn't need to change them unless you want to swap them out for something else.