Hosting a PocketMine-MP Server¶
Introduction¶
In this guide, you will be able to host a PocketMine-MP Minecraft server as well as keeping it alive without having to be logged in all the time. Before you start, make sure you meet the requirements and have a basic understanding of Linux, if you have issues or are stuck on a step you can ask for help in our support server.
Requirements¶
- You have a Linux VPS (Debian/Ubuntu).
- You are logged in as root or have a user that can use sudo.
- You know how to establish an SSH connection or use an SSH client.
Don't know how to connect to your server? Check out this guide.
Installing required packages¶
I recommend that you should be logged in as root before executing these commands to ensure everything goes smoothly.
apt update && apt upgrade -y
apt install sudo screen unzip curl -y
Warning
You may get a popup like the one below, use the arrow key to click yes to proceed.
Creating a user for Minecraft¶
For security purposes, Minecraft should not be running under the root user. We will create a new system user and group with home directory /opt/minecraft that will run the Minecraft server:
sudo useradd -r -m -U -d /opt/minecraft -s /bin/bash minecraft
We are not going to set a password for this user. This is a good security practice because this user will not be able to log in via SSH. To login to the Minecraft user, you’ll need to be logged in to the server as root or user with sudo privileges.
Before starting with the installation process, make sure you switch to the Minecraft user.
sudo su - minecraft
Creating the Directory¶
If you plan to have multiple versions of Minecraft running I would recommend creating a folder for them to make sure the files do not conflict.
mkdir pmmp
cd pmmp
Using the installer¶
The PocketMine-MP team has kindly made a script that will automatically install the server for you.
curl -sL https://get.pmmp.io | bash -s -
Starting the server¶
Execute the command below in the same directory you ran the installer script in.
./start.sh
This will ask you to start configuring your server which you should fill in yourselves.
Connecting to the server¶
The server IP should be provided after you finish the setup however In the eventuality that you do not have the IP you can still use the commands listed below to find your IP.
dig +short myip.opendns.com @resolver1.opendns.com
Note
If the command above fails, try this command and copy the output as that is the IP of your server.
curl icanhazip.com
Copy the IP and open Minecraft up, go to servers and click add a server and under Server Address put the server's IP in and click Done.
Keeping your server alive¶
Screen¶
Screen is one way of keeping your server running in the background without having to keep your SSH session open.
Warning
screen does not boot on load or write logs to the disk automatically, reboots would kill the screen due to only being a virtual session.
To start your server with screen, first, make sure you have screen package installed.
Installation¶
You should've installed screen from the start of the guide. In the eventuality that you do not have screen package installed, please use the command below and make sure you're using root or sudo. You can install screen using the one-liner below:
sudo apt update && sudo apt install screen -y
Warning
Make sure you are using root if you are still on the Minecraft account use exit, then execute the commands after you are done you should use the command listed to switch back to the Minecraft account sudo su - minecraft.
Usage¶
You can then start your server by using the command below:
screen -S PMMP -L ./start.sh
This should create a session you can safely leave without fear of it shutting down when you leave.
You can leave the screen via CTRL+AD from this session so your Server is still online when you leave.
You can re-attach to the running screen by running screen -r PMMP and either issue commands or shutdown the server via CTRL+C.
Systemd¶
Systemd can be an easy way of keeping your Minecraft server up, setting a service file for Minecraft should be easy and quick if you follow closely, first you should switch to root for this by running the command below.
Installation¶
exit
Once you are root we will start by creating a service file called [email protected] in /etc/systemd/system/.
nano /etc/systemd/system/[email protected]
Next, a screen like this will show up, you will fill it up with the config provided below.
Use this config.
[Unit]
Description=PocketMine-MP Minecraft server
After=network.target
Wants=network-online.target
[Service]
Type=simple
User=Minecraft
WorkingDirectory=/opt/minecraft/pmmp/
ExecStart=/bin/bash start.sh
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Hint
To exit out of nano, use Ctrl + X and hit Y
Run the commands below to test and start the server
systemctl daemon-reload
systemctl start [email protected]
systemctl status [email protected]
systemctl enable [email protected]
Usage¶
Here are some commands that will help you effectively manage the service. Start service:
systemctl start [email protected]
Restart service:
systemctl restart [email protected]
Status of service:
systemctl status [email protected]
Stop service:
systemctl stop [email protected]
View logs:
journalctl -n 50 -f -u [email protected]