Skip to main content

A simple wrapper for managing your Minecraft servers.

Project description


A simple wrapper for managing your Minecraft servers.

What is it?

Mserv is a little commandline utility I wrote in Python to help me better manage my, and my friends' Minecraft servers.

Mojang offers a DIY server.jar file which you can execute and host a server on your own PC for free. But, what if I wanted separate servers? What if I don't care to go to the Minecraft website and download the file myself? Or, what if I don't care to remember the server execution parameters?

Mserv serves to simplify many of these processes, and should make efforts to help those less tech-savvy.

What can it do?

This is a wrapper around the official server.jar from Mojang As of right now, it can...

  • Download and generate files from the official server executable
  • Start and shutdown the server
  • Displays network connection information (public ip, port number) so others can join your server
  • Can update the server executable (This is still in testing)
  • Update itself (just run pip install --upgrade mserv)

What can it NOT do?

This script can not:

  • Port forward for you (You have to do that yourself)
  • Execute multiple servers at the same time


  1. Java
  2. Python version 3.8 or above


  1. EASY - Use Python's package manager pip:
pip install mserv


  1. TRICKY - Clone this repository:
git clone

Then execute located in the mserv directory

python3 ./mserv/mserv/

Generated Help Page


  --version  Show the version and exit.
  --help     Show this message and exit.

  setup   Create a new server.
  update  Download a fresh server.jar file from Mojang.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mserv-0.8.4.tar.gz (6.0 kB view hashes)

Uploaded source

Built Distribution

mserv-0.8.4-py3-none-any.whl (6.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page