Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sang765/papermc-manager

PaperMC Manager is a Python script that helps you manage and update Minecraft servers using Paper. This script provides options to download and update Paper versions, start Minecraft servers, and many other features.
https://github.com/sang765/papermc-manager

minecraft minecraft-paper minecraft-papermc-server minecraft-server paper papermc python

Last synced: about 1 month ago
JSON representation

PaperMC Manager is a Python script that helps you manage and update Minecraft servers using Paper. This script provides options to download and update Paper versions, start Minecraft servers, and many other features.

Awesome Lists containing this project

README

        


Paper Manager

PaperMC Manager


BetterDiscord
BetterDiscord
BetterDiscord
BetterDiscord

## Description

This script helps manage Minecraft servers using **[Paper](https://github.com/PaperMC/Paper)**. It provides features such as:
- Starting the Minecraft server without auto-restart
- Starting the Minecraft server with auto-restart
- Checking and updating to the latest PaperMC build
- Changing the PaperMC version
- Configuring server settings, including RAM limit and GUI mode

## Features

1. **Start Server Without Auto-Restart**
- Start the Minecraft server without automatic restart when the server stops.

2. **Start Server With Auto-Restart**
- Start the Minecraft server and automatically restart it after the server stops.

3. **Check for Updates**
- Check and download the latest Paper build if available.

4. **Change PaperMC Version**
- Select and download a specific Paper version from available builds.

5. **Configure Server**
- Configure server settings, including RAM limit and GUI mode.

## Requirements

- Python 3.8 or higher
- **Path Intellisense** extension if you running this script on VSCode

## Screenshot:

> [!NOTE]
>
> These are old screenshots so if you see a difference between the preview and the script you are running, please forgive me.

Main menu:
![image](https://i.imgur.com/HOPBWQz.png)
Start server:
![image](https://i.imgur.com/MMrtYbr.png)
Check for updates:
![image](https://i.imgur.com/lwGk71L.png)
Change version:
![image](https://i.imgur.com/b7ynEm3.png)
Configure server:
![image](https://i.imgur.com/xblw95w.png)
VSCode Preview:
![image](https://github.com/user-attachments/assets/5ce71df7-1c2b-432c-8bd4-bcc0f18c893e)

## Note Before Using
> [!NOTE]
>
> Please place **python** file or **exe** file to __root paper server folder__.
>
> **IMPORTANT**
> Please don't change the name for paper file (That 100% make the script broken.)

## Installation

### Python Installation

1. **Install Python and pip:**
- Download Python from [python.org](https://www.python.org/downloads/) and install it.
- Ensure Python is added to your PATH environment variable.

2. **Download source code and unzip to folder:**
- Download the source code in release page `(or you can clone this repository with git)`.
- Use any unzip tool like [7-Zip](https://www.7-zip.org/) or [WinRar](https://www.win-rar.com/) to unzip the source code to a folder.

3. **Install Required Packages:**
- Open a terminal window in address of the folder (or use "Open with Code" if you use VSCode).
- Install the packages using:
```py
pip install -r requirements.txt
```

4. **Run script**
- Execute the script with:
```py
python paper_manager.py
```

### Executable Installation
1. **Download the EXE Version:**

- If you prefer not to use Python, you can download a pre-built EXE version from the project's release page or provided link.
2. **Run the EXE Version:**

- Run the EXE file by double-clicking it or executing it from the command line.

## Note
- This script is not affiliated with PaperMC team.
- If you see **PaperMC_Manager.exe** or **main.exe** of PaperMC Manager got malicious on [this](https://www.virustotal.com/gui/file/893fd96c0879418d6b7e75a2c88aafe48b70214e29e335388b619279101e6570)? Don't worry this executable **100% safe**. The reason this executable got malicious on VirusTotal because I use **pyinstall with UPX**.
- If you run this script on VSCode, remember install **[Path Intellisense](https://marketplace.visualstudio.com/items?itemName=christian-kohler.path-intellisense)** extension to make it work because choose folder feauture not work in VSCode and this extension make that feature it work in VSCode.

![VT Test Image](assets/VT_Test.png)