Skip to main content

A simple wrapper for managing your Minecraft servers.

Project description

mserv

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

Requirements

  1. Java
  2. Python version 3.8 or above

Installation

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

or

  1. TRICKY - Clone this repository:
git clone https://github.com/mexiquin/mserv.git

Then execute mserv.py located in the mserv directory

python3 ./mserv/mserv/mserv.py

Generated Help Page

Usage: mserv.py [OPTIONS] COMMAND [ARGS]...

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

Commands:
  run
  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 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page